puppet-module-autofs

Puppet module to manage autofs. Documentation TBD.

Compatibility

This module has been tested to work on the following systems with the latest Puppet v3, v3 with future parser, v4, v5 and v6. See .travis.yml for the exact matrix of supported Puppet and ruby versions.

EL 5
EL 6
EL 7
EL 8
EL 9
SLED / SLES 10
SLED / SLES 11
SLED / SLES 12
SLED / SLES 15
Ubuntu 12.04 LTS
Ubuntu 14.04 LTS
Ubuntu 16.04 LTS
Ubuntu 18.04 LTS
Ubuntu 20.04 LTS
Ubuntu 22.04 LTS

Parameters

browse_mode (type: String)

Set this to YES if you want your mounts to be browseable.

Default: 'NO'

timeout (type: Integer)

Default mount timeout.

Default: 600

negative_timeout (type: Integer)

Default negative timeout for failed mount attempts.

Default: 60

mount_wait (type: Integer)

Time to wait for a response from mount.

Default: -1

umount_wait (type: Integer)

Time to wait for a response from umount.

Default: 12

mount_nfs_default_protocol (type: Integer)

Default protocol version used by mount.nfs

Default: 4

append_options (type: String)

Specify whether options should be appended to global options or replacing them.

Default: 'yes'

logging (type: String)

Set default log level none, verbose or debug.

Default: 'none'

maps (type: Hash)

Specify the maps managed. This value is sent to define autofs::map.

Default: {}

maps_hiera_merge (type: Boolean)

If the module should merge $maps from different levels in hiera.

Default: false

autofs_package (type: String)

Package name for autofs. Unset, this parameter will choose the appropriate default for the system.

Default: undef

autofs_sysconfig (type: String)

Absolute path for autofs sysconfig location. Unset, this parameter will choose the appropriate default for the system.

Default: undef

autofs_service (type: String)

Service name for autofs to manage.

Default: 'autofs'

autofs_auto_master (type: String)

Absolute path for autofs.master location. Unset, this parameter will choose the appropriate default for the system.

Default: undef

use_nis_maps (type: Boolean)

If the module should load mount maps from NIS.

Default: true

nis_master_name (type: String)

The name of the NIS map containing the auto.master data.

Default: 'auto.master'

service_ensure (type: String)

Value for the service ensure attribute. Valid values are running and stopped.

Default: 'running'

service_enable (type: Boolean)

Value for the service enable attribute.

Default: true

use_dash_hosts_for_net (type: Boolean)

Set this to true makes autofs use -hosts for the /net mountpoint. Set to false to use /etc/auto.net.

Default: true

autofs::map parameters

mountpoint (type: String)

Specify the mountpoint in auto.master.

Default: undef

maptype (type: String)

Specify maptype for mountpoint in auto.master.

Default: undef

mapname (type: String)

The name for the map in auto.master. The default of undef will use the name of the key used to specify the mount.

Default: undef

mappath (type: String)

Absolute path of the map file to be created and used in auto.master. The default of undef will use the name of the key used to specify the mount with /etc/auto. as prefix.

Default: undef

mounts (type: Array)

Specify the mounts to be mounted at mountpoint as an array.

Default: []

manage (type: Boolean)

Boolean to manage mounts in auto.master. Setting it to false will result in -null in auto.master.

Default: true

file (type: String)

Specify the mounts to be mounted at mountpoint from a file.

Default: undef

options (type: String)

Specify extra mount points for this mountpoint in auto.master.

Default: undef

Examples

Manage /home with mounts from a file on Puppet fileserver:

autofs::maps:
  home:
    mountpoint: 'home'
    file: 'puppet:///files/autofs/auto.home'

Results in auto.master with the following content.

/home /etc/auto.home

Manage /home with mounts defined hiera:

autofs::maps:
  home:
    mountpoint: 'home'
    mounts:
      - 'user1      nfsserver:/path/to/home/user1'
      - 'user2      nfsserver:/path/to/home/user2'

Results in auto.home with the following content and auto.master remaining as above.

user1      nfsserver:/path/to/home/user1
user2      nfsserver:/path/to/home/user2

Prevent /home from being managed by autofs (NIS included):

autofs::maps:
  home:
      mountpoint: 'home'
      manage: false

Result in auto.master:

/home -null

phil-friderici / puppet-module-autofs Goto Github PK