h1. Master of Puppet

h2. Exemple duplication www avec puppet et les backups:

Installation d'une vm (ici: puppet-tester) avec ganeti:

sur h1:

<pre>

./gnt-addvm puppet-tester

</pre>

Sur puppet-tester, restauration du dernier backup de /var/www de www.tetaneutral.net qui se trouve sur h2

Puis installation de puppet:

<pre>

$ apt-get install puppet

$ cat /etc/puppet/puppet.conf ajouter:

[main]

logdir=/var/log/puppet

vardir=/var/lib/puppet

ssldir=/var/lib/puppet/ssl

rundir=/var/run/puppet

factpath=$vardir/lib/facter

templatedir=$confdir/templates

pluginsync = true

[agent]

server=puppet.tetaneutral.net

$ puppet agent --test

</pre>

Sur puppet.teteneutral.net, dans le fichier nodes.pp copie du bloc de la machine www en puppet-tester

puis on sign la cle de puppet-tester

<pre>

puppetca --sign puppet-tester.tetaneutral.net

</pre>

sur puppet-tester, on descend la configuration via puppet:

<pre>puppet agent --test</pre>

et pour finir on restaure le backup mysql:

<pre>

mysql -u root < www.tetaneutral.net-all-mysql-databases.20120103.sql

</pre>

h2. Ajout d'une machine:

Sur le client:

<pre>

$ apt-get install puppet

</pre>

dans /etc/default/puppet mettre:

<pre>

START=yes

</pre>

et dans /etc/puppet/puppet.conf ajouter:

<pre>

pluginsync=true

[agent]

server=puppet.tetaneutral.net

</pre>

Ensuite ajouter la machine dans le puppet master, MOUAHAHA:

Sur le client: 

<pre>

$ puppet agent --test

warning: peer certificate won't be verified in this SSL session

warning: peer certificate won't be verified in this SSL session

warning: peer certificate won't be verified in this SSL session

Exiting; no certificate found and waitforcert is disabled

</pre>

Sur le serveur:

<pre>

$ puppetca --list

www.tetaneutral.net

$ puppetca  --sign --all

notice: Signed certificate request for www.tetaneutral.net

notice: Removing file Puppet::SSL::CertificateRequest www.tetaneutral.net at '/var/lib/puppet/ssl/ca/requests/www.tetaneutral.net.pem'

</pre>

Sur le client: 

<pre>

$ puppet agent --test

warning: peer certificate won't be verified in this SSL session

info: Caching certificate for www.tetaneutral.net

info: Caching certificate_revocation_list for ca

info: Caching catalog for www.tetaneutral.net

info: Applying configuration version '1325516709'

info: Creating state file /var/lib/puppet/state/state.yaml

notice: Finished catalog run in 0.01 seconds

</pre>

Sur le serveur, on associe les modules au client:

<pre>

$ cat manifests/nodes.pp

node basenode {

    include backup

    include motd

}

node 'www.tetaneutral.net' inherits basenode {

}

</pre>

h2. Récupération de fichier écrasé par puppet:

Voir la liste des fichiers backupés:

<pre>

find /var/*/puppet/clientbucket -name paths | while read path ; do echo $(cat $path): $(basename $(dirname $path))  $(stat -c %y $path) ; done

</pre>

Ensuite pour voir le fichier:

<pre>

A venir ... (un truc avec puppet filebucket ...)

</pre>

h2. Ajout d'un module (ie: un truc/service/user a configurer), ici module motdpour l'exemple :

h3. Création du module

<pre>

cd /etc/puppet/modules

mkdir -p  motd/{files,lib,manifests,templates,tests}

$ cat motd/manifests/init.pp

class motd {

        file {'motd':

                ensure  => file,

                path    => '/etc/motd.tail',

                mode    => 0644,

                content => "Bienvenue sur ${::hostname}, machine de l'infrastructure ${::domain}\n\nCette machine est geree par puppet toutes modifications effectuee est suceptible d'etre perdu."

        }

}

</pre>

h3. Ajout du module à la liste des modules disponibles

<pre>

$ cat manifests/modules.pp

import "motd"

</pre>

h3. Utilisation du module pour une node

<pre>

$ cat manifests/nodes.pp

node 'www.tetaneutral.net' {

    include motd

}

</pre>

h2. Installation

Installation du paquet:

<pre>

$ apt-get install puppetmaster

</pre>

Dans /etc/puppet/puppet.conf mettre le nom du serveur puppetmaster:

<pre>

[master]

certname=puppet.tetaneutral.net

</pre>

Dans /etc/puppet/fileserver.conf configurer les autorisations:

<pre>

[files]

  path /etc/puppet/files

  allow 91.224.149.0/24

  allow 91.224.148.0/24

</pre>

h2. Liens:

* http://docs.puppetlabs.com/references/stable/

* http://madeinsyria.fr/2011/06/howto-puppet-administration-et-industrialisation-de-masse/