companieshouse / ansible-role-nfs-mounts

An Ansible Galaxy role for configuring NFS mounts

NFS role

An Ansible Galaxy role for configuring persistent NFS filesystem mounts.

Table of contents

• NFS Configuration
• Example Requirements File
• Example Playbook
• License

NFS Configuration

NFS filesystem mounts are configured using the nfs_mounts_config group/host variable. This variable should be defined as a list of dictionaries, each of which support the following parameters:

Name	Default	Description
path		The path on the remote system being provisioned which will be used as the mount point for the NFS filesystem.
src		The source of the NFS filesystem in the form of the hostname or IP address of the NFS server and the directory being exported (e.g. 1.2.3.4:/exported).
opts	hard,bg	Optional. Options for the NFS filesystem that will be added to the filesystem table configuration (i.e. /etc/fstab) in the form of a single comma-separated string.
symlink		Optional. An optional path that will be used to create a symbolic link to the mount path specified.

Example Requirements File

- src: https://github.com/companieshouse/ansible-role-nfs-mounts
  name: nfs-mounts
  version: "n.n.n"

Example Playbook

    - hosts: servers
      roles:
        - nfs-mounts

License

This project is subject to the terms of the MIT License.