Paramétrages ThinBackup

De EjnTricks

Cet article présente un paramétrage simple du plugin ThinBackup de Jenkins.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Start-icon.png Accès

La configuration du plugin ThinBackup s'effectue depuis l'interface d'administration de Jenkins. Après installation, la nouvelle section ThinBackup est disponible.


Il suffit de cliquer sur le lien pour accéder aux trois outils mis à disposition.

  • Backup
  • Restore
  • Settings


Configuration-icon.png Configuration

Après installation, il est nécessaire de paramétrer, accessible depuis le lient Settings.


Les quatre premiers paramètres sont importants.

System-Install-icon.png Préparation environnement

Les sauvegardes sont placées dans un répertoire de la machine, soit /var/opt/backups/jenkins/ThinBackup dans le cadre de cette installation. Ce répertoire peut être créé automatiquement, mais il est préféré de l'initier au préalable, afin de gérer finement les permissions.

#sudo mkdir -p /var/opt/backups/jenkins/ThinBackup
#sudo chown tomcat8:tomcat8 /var/opt/backups/jenkins/ThinBackup
#sudo chmod 700 /var/opt/backups/jenkins/ThinBackup

A noter les permissions mises en places qui donnent un accès uniquement au compte de démarrage du serveur, soit tomcat8.

Warning-icon.png Attention, il est nécessaire que le compte accède à toute la hierarchie du répertoire. Pour rappel, une stratégie de backup a été mise ne place avec des accès plus restrictifs. Il peut être nécessaire de modifier les droits du répertoire parent.

#sudo chmod 755 /var/opt/jenkins

Folder-icon.png Emplacement

Le premier champ est renseigné avec l'emplacement préalablement créé.


A noter sur cette capture d'écran, un message d'avertissement est présenté pour la non disponibilité du répertoire cible. En fait, le problème venait du fait qu'un niveau intermédiaire n'était pas disponible, comme décrit dans le répertoire précédent.

Il est possible d'utiliser des variables d'environnement, ce qui peut être pratique pour prendre le Home de l'instance.

Scheduled-Tasks-icon.png Plannification

Deux zones sont disponibles afin de plannifier les sauvegardes complètes et différentielles. Pour cet article, la plannification est la suivante.

  • Tous les jours, sauf lundi, à 3h matin pour les différentielles 0 3 * * 0,2-6;
  • Tous les lundis, à 3h matin pour les complètes 0 3 * * 1.

La nomenclature respecte la syntaxe cron.


A noter qu'une assistance de Jenkins permet d'optimiser la plannification. La proposition permet de ne pas configurer explicitement 3h00, mais plutôt une fois vers les 3h.

Copy-icon.png Nombre de sauvegarde

La valeur 5 est spécifiée pour le paramètre Max number of backup sets. Ainsi, 5 sauvegardes complètes seront conservées, laissant 5 semaines de paramétrages, largement suffisant dans le cadre d'une utilisation personnelle.


Icon-Configuration-Settings.png Configuration avancée

La deuxième partie de l'écran met à disposition des éléments de configuration un peu plus avancés.

Dans le cadre de cet installation, l'option Clean up differential backups est activée afin de supprimer les sauvegardes différentielles lorsqu'une complète est réalisée. De plus, l'option Move old backups to ZIP files va permettre de compresser les anciennes sauvegardes complètes dans un fichier ZIP, ce qui peut permettre de limiter l'impact sur l'espace disque.


Run-icon.png Déclenchement manuel

Sur l'interface de l'outil, voir le premier paragraphe, le lien Backup Now permet de forcer le déclenchement d'une sauvegarde.

Aucun message n'est présenté sur l'interface, mais des informations d'exécution sont visible dans le fichier trace, soit /var/log/tomcat8/catalina.out dans le cadre de cet article.

27-Mar-2018 13:29:55.184 INFOS [Handling GET /jenkins/thinBackup/backupManual from 0:0:0:0:0:0:0:1 : http-nio-8080-exec-3] org.jvnet.hudson.plugins.thinbackup.ThinBackupMgmtLink.doBackupManual Starting manual backup.
27-Mar-2018 13:29:55.686 INFOS [ThinBackup Worker Thread thread] org.jvnet.hudson.plugins.thinbackup.backup.HudsonBackup.<init> No previous full backup found, thus creating one.
27-Mar-2018 13:29:55.745 INFOS [ThinBackup Worker Thread thread] org.jvnet.hudson.plugins.thinbackup.backup.HudsonBackup.backupJobsDirectory Found 32 jobs to back up.
27-Mar-2018 13:29:59.105 INFOS [Thread-46] org.jvnet.hudson.plugins.thinbackup.utils.Utils.moveOldBackupsToZipFile DONE moving 0 backup set(s) to ZIP files.

Un nouveau répertoire est alors créé dans le répertoire cible.

#sudo ll /var/opt/backups/jenkins/ThinBackup
total 12
drwx------ 3 tomcat8 tomcat8 4096 mars  27 13:29 ./
drwxr-xr-x 3 root    root    4096 mars  27 13:12 ../
drwxr-x--- 4 tomcat8 tomcat8 4096 mars  27 13:29 FULL-2018-03-27_13-29/


Viewer icon.png Voir aussi

Documentation officielle: https://plugins.jenkins.io/thinBackup