https://github.com/ericsson/puppet-module-autofs
https://github.com/ericsson/puppet-module-autofs
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/ericsson/puppet-module-autofs
- Owner: Ericsson
- License: other
- Created: 2014-04-17T06:55:38.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2024-03-25T11:46:07.000Z (almost 2 years ago)
- Last Synced: 2025-05-07T18:16:21.963Z (8 months ago)
- Language: Ruby
- Size: 159 KB
- Stars: 0
- Watchers: 4
- Forks: 12
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
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 8
* EL 9
* SLED / SLES 12
* SLED / SLES 15
* Ubuntu 20.04 LTS
* Ubuntu 22.04 LTS
* Ubuntu 24.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