Version information
This version is compatible with:
Start using this module
Add this module to your Puppetfile:
mod 'jza34-gnome3', '0.3.2'
Learn more about managing modules with a PuppetfileDocumentation
gnome3
Table of Contents
- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with gnome3
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Overview
Customization of gnome3 for multiuser configuration
Module Description
Manage /etc/skel, web proxy, nautilus bookmarks, software installed, wallpaper, gdm
Purge games if delete_games is set to true (default)
Copy all wallpapers found in files/backgrounds to the node default backgrounds directory (/usr/share/backgrounds)
Copy all gdm settings found in files/gdm to the node default gdm dconf settings directory (/usr/share/gdm/dconf)
Setup
List of parameters in init.pp or params.pp
Include this class
class { 'gnome3':
button\_power => $gnome3::params::button_power,
background => undef, #/usr/share/backgrounds/smile-wallpaper.jpg
screensaver_lock => true,
bookmarks => undef,
software => undef,
games => $gnome3::params::games,
delete\_games => true,
webproxy\_mode => $gnome3::params::webproxy_mode,
webproxy\_autourl => '',
webproxy\_locked => true,
}
button_power
Action to execute when the power button is pressed
Possible values are: shutdown or sleep
(Default shutdown)
background
Absolute path from the node, to a wallpaper file
(Default undef)
screensaver_lock
The screensaver lock the screen when it runs. The user must re-enter his password.
When set to "false" this is not needed
(Default true)
bookmarks
Array of strings, bookmarks to add to nautilus sidebar
Example: [''smb://monsite.com/echange Echange']
(Default undef)
software
An array of package names to be installed
(Default undef)
games
An array of strings, the names of games
(Default ['aisleriot','five-or-more','four-in-a-row','gnome-chess','gnome-klotski', 'gnome-mahjongg','gnome-mines','gnome-nibbles','gnome-robots','gnome-sudoku', 'gnome-tetravex','hitori','iagno','lightsoff','quadrapassel','swell-foop','tali'])
delete_games
A boolean to delete all packages listed in parameter $games
(Default true)
webproxy_mode
A string, the web proxy mode for the system.
Possible values are: none (no proxy), auto (automatic config from an url)
webproxy_autourl
An URL where to get the web proxy config
(Default '')
webproxy_locked
A boolean, to lock or not to lock user proxy config
(Default true)
Usage
Set parameters in init.pp and params.pp
Reference
Use of dconf and configuration files, no exoctic scripts.
Limitations
Only tested in Debian environment but should work with RedHat or others
Development
Tested localy then saved to github then published to the puppet forge
Don't upgrade from the forge in a production environment...always test it in your situation.
2016-07-21 (0.3.2)
- add screensaver_lock parameter to enable or disable the screensaver to ask for user password
2016-16-24 (0.3.1)
- add skel.pp for better separation
2016-05-31 (0.3.0)
- added dconf.pp
- well documented README
- more customizable webproxy
- more checks for default values
2016-05-20 (0.2.2)
- remove of the top comment in bookmarks.erb
Dependencies
- puppetlabs-stdlib (>= 1.0.0)