Skip to content

Ansible Role linuxfabrik.lfops.nfs_server

This role installs and configures NFS as a server.

Tags

nfs_server

  • Install nfs-utils on RedHat-Based systems or nfs-kernel-server on Debian-Based systems.
  • Enable/disable nfs-server.service.
  • mkdir -p nfs-export-directory.
  • Deploy /etc/exports.
  • Triggers: nfs-server.service reload.

nfs_server:state

  • Enable/disable nfs-server.service.
  • Triggers: none.

nfs_server:exports

  • mkdir -p nfs-export-directory.
  • Deploy /etc/exports.
  • Triggers: nfs-server.service reload.

Mandatory Role Variables

nfs_server__exports

  • List of NFS exports to create.
  • Type: List of dictionaries.

  • Subkeys:

    • path:

      • Mandatory. Directory to export.
      • Type: String.

    • clients:

      • Mandatory. List of client specifications. Have a look at man 5 exports.
      • Type: List.

    • owner:

      • Optional. Owner of the export directory.
      • Type: String.
      • Default: 'nobody'

    • group:

      • Optional. Group of the export directory.
      • Type: String.
      • Default: 'nogroup' ('nobody' for RHEL, CentOS, Fedora, Rocky)

    • mode:

      • Optional. Mode of the export directory.
      • Type: String.
      • Default: '0o755'

Example:

# mandatory
nfs_server__exports:
  - path: '/data/dir1'
    clients:
      - '192.0.2.1(rw,sync,all_squash)'
      - '192.0.2.2(ro,sync,all_squash)'
    owner: 'root'
    group: 'root'
    mode: '0o755'
  - path: '/data/dir2'
    clients:
      - '192.0.2.3(ro,sync,all_squash)'

Optional Role Variables

nfs_server__service_enabled

  • Enables or disables the nfs-server service, analogous to systemctl enable/disable --now.
  • Type: Bool.
  • Default: true

Example:

# optional
nfs_server__service_enabled: true

License

The Unlicense

Author Information

Linuxfabrik GmbH, Zurich