APPEL A CANDIDATURES : si vous désirez mettre en place ce système, contactez JeanChristopheAndré (via la liste de discussion technique de l'AUF). Il a programmé un paquet Debian auf-git-etc qui installe tout cela automagiquement ! Aidez-le à tester son paquet : c'est quasiment sans risque, et ça sera bientôt la façon «officielle» de faire. Affaire à suivre très prochainement.

On veut pouvoir documenter les modifications faites dans /etc et dans /usr/local, qui sont grosso modo les deux répertoires permettant de décrire comment fonctionne un serveur. Cette documentation est indispensable en cas d'administration à plusieurs, mais elle est également très utile quand on est seul à gérer : c'est un aide-mémoire indispensable vu la vitesse à laquelle évoluent les technologies et donc les configurations.

Pour cela, on utilise un logiciel de gestion de version. Ce logiciel va nous permettre de documenter chaque modification effectuée sur un fichier ou un ensemble de fichier. On pourra ensuite retrouver à quel moment à été faite une modification, par qui et pour quelle raison.

Il existe différents logiciels de ce type, parmis lesquels on peut citer l'ancètre CVS, son fils Subversion (svn), et dans une famille différente git. C'est ce dernier logiciel que nous avons choisi car il est moins bavard, moins intrusif dans le code à surveiller, et surtout très bien documenté.

A écrire : petites explications sur la notion de dépôt, orientée git et surveillance de /etc

Notre objectif ici est d'installer git sur un serveur pour que son ou ses administrateurs, et uniquement eux, puissent aisément faire le suivi de sa configuration.

Installation

  1. On installe git :

    # aptitude install git-core
  2. On créée un dépôt général pour toute la machine. Attention à bien régler les droits : seul root doit pouvoir accéder au dépôt, sinon les fichiers du genre shadow seraient accessibles à tous.

    # cd /
    # git init-db                   <--- Ou "git init" sur Git 1.5 (Debian Lenny, Ubuntu Gutsy)
    # chmod u=rwx,go= /.git         <--- important ! Seul "root" doit pouvoir accéder au dépôt
  3. Pour éviter d'avoir des "saletés" directement à la racine (/), on déplace le dépôt vers /var/lib/git. Le répertoire /.git à la racine ne sera en fait qu'un lien symbolique vers le véritable emplacement du dépôt :

    # mkdir /var/lib/git
    # mv /.git /var/lib/git/root
    # ln -s /var/lib/git/root /.git
  4. On veut suivre /etc et /usr/local seulement, pour cela on modifie les exclusions au niveau du dépôt, dans le fichier /var/lib/git/root/info/exclude :

    # Le fichier /var/lib/git/root/info/exclude à modifier ou créer
    # Par défaut, on exclut tout sauf /etc
    /*
    !/etc
    # ... mais dans /etc on interdit certains fichiers :
    /etc/*shadow*
    /etc/ssh/ssh_host_*_key
    /etc/mtab
    /etc/adjtime
    /etc/ld.so.cache
    # On n'interdit pas non plus le parcours de /usr. Mais dans ce parcours,
    # on interdit tout sauf /usr/local. C'est la technique pour inclure /usr/local...
    !/usr
    /usr/*
    !/usr/local
    # quelques type fichiers à ne pas jamais considérer, globalement :
    *.dpkg-old
    *.dpkg-new
    .*.swp
    *~
    *#
  5. On fait le premier ajout de tous les fichiers à suivre (sauf les exclus indiqués ci-dessus), puis le premier commit :

    # cd /
    # git add etc usr/local
    # git commit -m "mise en route du suivi : /etc et /usr/local" --author "Prenom NOM <prenom.nom@auf.org>"
  6. On utilisera surtout git avec sudo. Il faut donc dire à sudo de ne pas supprimer les variables d'environnement utiles à git :

    # (... extrait de /etc/sudoers ...)
    # une ligne à ajouter au début de /etc/sudoers :
    Defaults env_keep += "GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL"

Utilisation

Quelques automatisations quasi indispensables

Pour lancer un "status" à chaque connexion sur le serveur (très très utile) :

  1. Permettre aux gens du groupe "admin" de lancer git status sans mot de passe :
    # et à ajouter vers la fin de /etc/sudoers :
    %admin ALL=(ALL) NOPASSWD: /usr/bin/git status -a
  2. Lancer le git status (via sudo) dans le /etc/profile, et configurer un peu les variables GIT :

    # A ajouter à la fin de /etc/profile :
    if [ "$PS1" ]; then
      # on lance un git status sur l'utilisateur est dans le groupe
      # admin ou bien si c'est root
      if $(id -Gn | grep -qw admin) || [ $(id -u) -eq 0 ]; then
        [ -x /usr/bin/git -a -e /.git ] && (cd / && sudo /usr/bin/git status -a)
      fi
      # les lignes suivantes tentent de configurer les variables GIT_*
      # si les résultats ne sont pas bien "devinés", définir les bonnes valeurs dans .bashrc
      GIT_AUTHOR_NAME=${GIT_AUTHOR_NAME:=$(getent passwd $(id -un)|cut -d: -f5|cut -d, -f1)}
      GIT_AUTHOR_EMAIL=${GIT_AUTHOR_EMAIL:=$(id -un)@$(hostname -f)}
      GIT_COMMITTER_NAME=${GIT_COMMITTER_NAME:=$GIT_AUTHOR_NAME}
      GIT_COMMITTER_EMAIL=${GIT_COMMITTER_EMAIL:=$GIT_AUTHOR_EMAIL}
      export GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL
    fi

Pour envoyer un mail à chaque commit :

  1. Créer un script /.git/hooks/post-commit :

    recipients="admins@XX.auf.org"   # adresse pour l'envoi du mail
    # On modifie un peu la sortie de git show :
    #   1) on ajoute "From git hostname" devant le nom en From
    #   2) on retire le [PATCH] dans le sujet, replacé par git-commit:
    #   3) on ajoute un champ To:
    # et on maile le tout via sendmail
    PATH=/usr/sbin:/usr/bin:/sbin:/bin
    git show --pretty=email | 
      sed '1,6s/^From: /From: git '`hostname -f`' - /;1,6s/^Subject: \[PATCH\]/Subject: git-commit:/;2iTo: '"${recipients}" | 
      head -c 16k | /usr/lib/sendmail ${recipients}
    exit 0
  2. Activer le script :
    # chmod +x /.git/hooks/post-commit
  3. Faire un petit commit de test afin de vérifier ça marche, notamment que sendmail (Postfix, Exim, ...) envoie bien le message.

Ca ressemble à quoi ?

Juste pour donner une idée, voici ce que donne le petit programme tig lorsqu'on le lance sur une machine bien suivie :

Améliorations à trouver

Pour plus tard (Lenny) :