Puppet module for setting up nfs server and clients.
Storeconfigs is used for propogating export configs to clients.
Optional nfs4-support.
Puppetmaster must be configured to use storeconfigs. Clients need to support augeas.
Check Modulesfile for module dependencies
I have tested the module on lucid, precise, centos5 and centos6. Chances are good it will work on rhel and sles aswell.
This will export /data/folder on the server and automagically mount it on client.
node server { include nfs::server nfs::server::export{ '/data_folder': ensure => 'mounted', clients => '10.0.0.0/24(rw,insecure,async,no_root_squash) localhost(rw)' } # By default, mounts are mounted in the same folder on the clients as # they were exported from on the server node client { include nfs::client Nfs::Client::Mount <<| |>> }
node server1 { include nfs::server nfs::server::export{ '/data_folder': ensure => 'mounted', clients => '10.0.0.0/24(rw,insecure,async,no_root_squash) localhost(rw)' # exports /homeexports and mounts them om /srv/home on the clients '/homeexport': ensure => 'mounted', clients => '10.0.0.0/24(rw,insecure,async,root_squash)', mount => '/srv/home' } node server2 { include nfs::server # ensure is passed to mount, which will make the client not mount it # the directory automatically, just add it to fstab nfs::server::export{ '/media_library': ensure => 'present', nfstag => 'media' clients => '10.0.0.0/24(rw,insecure,async,no_root_squash) localhost(rw)' } node client { include nfs::client Nfs::Client::Mount <<| |>> } # Using a storeconfig override, to change ensure option, so we mount # all shares node greedy_client { include nfs::client Nfs::Client::Mount <<| |>> { ensure => 'mounted' } } # only the mount tagged as media # also override mount point node media_client { include nfs::client Nfs::Client::Mount <<|nfstag == 'media' | >> { ensure => 'mounted', mount => '/import/media' } } # All @@nfs::server::mount storeconfigs can be filtered by parameters # Also all parameters can be overridden (not that it's smart to do # so). # Check out the doc on exported resources for more info: # http://docs.puppetlabs.com/guides/exported_resources.html node single_server_client { include nfs::client Nfs::Client::Mount <<| server == 'server1' |>> { ensure => 'absent', } }
# We use the $::domain fact for the Domain setting in # /etc/idmapd.conf. # For NFSv4 to work this has to be equal on servers and clients # set it manually if unsure. # # All nfsv4 exports are bind mounted into /export/$mount_name # and mounted on /srv/$mount_name on the client. # Both values can be overridden through parameters both globally # and on individual nodes. node server { class { 'nfs::server': nfs_v4 = true, nfs_v4_export_root_clients => '10.0.0.0/24(rw,fsid=root,insecure,no_subtree_check,async,no_root_squash)' } nfs::server::export{ '/data_folder': ensure => 'mounted', clients => '10.0.0.0/24(rw,insecure,no_subtree_check,async,no_root_squash) localhost(rw)' } # By default, mounts are mounted in the same folder on the clients as # they were exported from on the server node client { class { 'nfs::server': nfs_v4 = true, nfs_v4_export_root_clients => '10.0.0.0/24(rw,fsid=root,insecure,no_subtree_check,async,no_root_squash)' } Nfs::Client::Mount <<| |>> } # We can also mount the NFSv4 Root directly through nfs::client::mount::nfsv4::root. # By default /srv will be used for as mount point, but can be overriden through # the 'mounted' option. node client2 { $server = 'server' class { 'nfs::server': nfs_v4 = true, } Nfs::Client::Mount::Nfs_v4::Root <<| server == $server |>> { mount => "/srv/$server", } }
# and on individual nodes. node server { class { 'nfs::server': nfs_v4 => true, # Below are defaults nfs_v4_idmap_domain => $::domain, nfs_v4_export_root => '/export', # Default access settings of /export root nfs_v4_export_root_clients => "*.${::domain}(ro,fsid=root,insecure,no_subtree_check,async,root_squash)" } nfs::server::export{ '/data_folder': # These are the defaults ensure => 'mounted', # rbind or bind mounting of folders bindmounted into /export # google it bind => 'rbind', # everything below here is propogated by to storeconfigs # to clients # # Directory where we want export mounted on client mount => undef, remounts => false, atboot => false, # Don't remove that option, but feel free to add more. options => '_netdev', # If set will mount share inside /srv (or overridden mount_root) # and then bindmount to another directory elsewhere in the fs - # for fanatics. bindmount => undef, # Used to identify a catalog item for filtering by by # storeconfigs, kick ass. nfstag => undef, # copied directly into /etc/exports as a string, for simplicity clients => '10.0.0.0/24(rw,insecure,no_subtree_check,async,no_root_squash)' } node client { class { 'nfs::server': nfs_v4 => true, nfs_v4_idmap_domain => $::domain nfs_v4_mount_root => '/srv', } # We can as you by now know, override options set on the server # on the client node. # Be careful. Don't override mount points unless you are sure # that only one export will match your filter! Nfs::Client::Mount <<| # filter goes here # |>> { # Directory where we want export mounted on client mount => undef, remounts => false, atboot => false, # Don't remove that option, but feel free to add more. options => '_netdev', # If set will mount share inside /srv (or overridden mount_root) # and then bindmount to another directory elsewhere in the fs - # for fanatics. bindmount => undef, } }
Harald Skoglund [email protected]
https://github.com/haraldsk/puppet-module-nfs/
Redpill Linpro - www.redpill-linpro.com
Apache License, Version 2.0