Ansible Role mount¶

This role installs NFS and CIFS client utilities when necessary and configures mount points in /etc/fstab.

Tags¶

mount

Installs nfs-utils/cifs on RedHat-Based systems or nfs-common/cifs-utils on Debian-Based systems, creates the corresponding directories for the mount points, alters /etc/fstab und mounts the volumes.
Triggers: none.

Optional Role Variables¶

mount__mounts__host_var / mount__mounts__group_var

List of directories containing the mounts to create.
Subkeys:
- path:
  - Mandatory. Path to the mount point.
  - Type: String.
- src:
  - Mandatory. Device (or NFS volume, or something else) to be mounted on path.
  - Type: String.
- fstype:
  - Mandatory. Filesystem type.
  - Type: String.
- group:
  - Optional. Group of the mount point directory.
  - Type: String.
  - Default: 'root'
- opts:
  - Optional. Mount options, man fstab.
  - Type: String.
- owner:
  - Optional. Owner of the mount point directory.
  - Type: String.
  - Default: 'root'
- state:
  - Optional. Possible options: absent, absent_from_fstab, ephemeral, mounted, present, remounted or unmounted. For details, have a look at the ansible.posix.mount module.
  - Type: String.
  - Default: 'mounted'
Type: List of dictionaries.
Default: []

Example:

# optional
mount__mounts__host_var:
  - path: '/mnt/nfs/data'
    fstype: 'nfs'
    src: 'nfs-server.example.com:/path/to/exported/data'
    opts: 'defaults'
    state: 'mounted'
  - path: '/mnt/cifs/data'
    fstype: 'cifs'
    src: '//cifs-server.example.com/CIFS-Share'
    opts: 'username=USERNAME,password=PASSWORD,vers=2.0,rw'
    state: 'mounted'
  - path: '/data'
    fstype: 'xfs'
    src: '/dev/sdb1'
    owner: 'myuser'
    group: 'mygroup'
    opts: 'defaults'
    state: 'mounted'

Troubleshooting¶

mount.nfs: access denied by server while mounting: Run exportfs -rv on the NFS server and try again.

License¶

The Unlicense

Author Information¶

Linuxfabrik GmbH, Zurich