Ansible Role linuxfabrik.lfops.nfs_client¶
This role installs NFS client utilities and controls active and configured NFS mount points in /etc/fstab.
Tags¶
nfs_client
- Install nfs-utils on RedHat-Based systems or nfs-common on Debian-Based systems.
mkdir -p nfs-mount-point.- Mount NFS volumes.
- Triggers: systemctl daemon-reload.
Optional Role Variables¶
nfs_client__mounts
- List of NFS mounts to create. For details, have a look at the ansible.posix.mount_module.
- Type: List of dictionaries.
- Default: unset
-
Subkeys:
-
src:- Mandatory. Source of the NFS mount.
- Type: String.
-
path:- Mandatory. Path of the mount point.
- Type: String.
-
opts:- Mandatory. Mount options.
- Type: String.
-
state:- Mandatory. State of the mount.
- Type: String.
-
owner:- Optional. Owner of the mount point directory.
- Type: String.
- Default:
'root'
-
group:- Optional. Group of the mount point directory.
- Type: String.
- Default:
'root'
-
mode:- Optional. Mode of the mount point directory.
- Type: String.
- Default:
'0o755'
-
Example:
# optional
nfs_client__mounts:
- src: 'nfs-server.example.com:/path/to/exported/data'
path: '/mnt/nfs/data'
opts: 'defaults'
state: 'mounted'
owner: 'root'
group: 'root'
mode: '0o755'
Troubleshooting¶
mount.nfs: access denied by server while mounting: Run exportfs -rv on the NFS server and try again.