Ansible role for installing and configuring the NFS client
Find a file
Simon Cornet 823065bde4
Some checks failed
ci/woodpecker/manual/linting Pipeline failed
ci: migrate from gitlab-ci to woodpecker
2026-05-15 12:55:53 +02:00
.woodpecker ci: migrate from gitlab-ci to woodpecker 2026-05-15 12:55:53 +02:00
meta feat: add meta 2026-04-07 16:53:50 +02:00
tasks feat: initial commit 2026-04-07 16:43:41 +02:00
templates/systemd feat: initial commit 2026-04-07 16:43:41 +02:00
.ansible-lint feat: initial commit 2026-04-07 16:43:41 +02:00
.gitignore feat: initial commit 2026-04-07 16:43:41 +02:00
.markdownlint-cli2.jsonc feat: initial commit 2026-04-07 16:43:41 +02:00
.yamllint feat: initial commit 2026-04-07 16:43:41 +02:00
readme.md feat: add readme 2026-04-10 08:35:50 +02:00
renovate.json feat: initial commit 2026-04-07 16:43:41 +02:00

Ansible Role: NFS Client

Install and configure NFS client with systemd-managed mounts.

Variables

Variable Required Default Description
nfs_mount Yes [] List of NFS mounts to configure
nfs_mount[].nfs_host Yes - NFS server hostname or IP
nfs_mount[].nfs_dir Yes - Remote directory path on NFS server
nfs_mount[].local_dir_path Yes - Local mount point path
nfs_mount[].nfs_opts Yes - NFS mount options
nfs_mount[].nfs_fstype No nfs4 NFS filesystem type
nfs_mount[].local_dir_owner No root Local directory owner
nfs_mount[].local_dir_group No root Local directory group
nfs_mount[].local_dir_mode No 0775 Local directory permissions
nfs_mount[].before_service No - List of systemd services to start after mount

Example

nfs_mount:

  # production share
  - nfs_host: "10.0.0.10"
    nfs_dir: "/srv/nfs/production"
    local_dir_path: "/mnt/production"
    nfs_opts: "rw,hard,intr,rsize=8192,wsize=8192"
    nfs_fstype: "nfs4"
    local_dir_owner: "www-data"
    local_dir_group: "www-data"
    local_dir_mode: "0755"
    before_service:
      - "nginx.service"
      - "php-fpm.service"

  # backup share
  - nfs_host: "nfs.example.com"
    nfs_dir: "/exports/backups"
    local_dir_path: "/mnt/backups"
    nfs_opts: "ro,soft,timeo=30"