Forge Home

gnome3

Customization for a gnome3 environment

9,408 downloads

6,954 latest version

4.9 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 0.3.2 (latest)
  • 0.3.1
  • 0.3.0
  • 0.2.2
  • 0.2.1
released Jul 20th 2016
This version is compatible with:

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'jza34-gnome3', '0.3.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add jza34-gnome3
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install jza34-gnome3 --version 0.3.2

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

jza34/gnome3 — version 0.3.2 Jul 20th 2016

gnome3

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with gnome3
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. 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.