Paramétrages ThinBackup
Cet article présente un paramétrage simple du plugin ThinBackup de Jenkins.
Sommaire
Votre avis
| Nobody voted on this yet
|
|
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
Après installation, il est nécessaire de paramétrer, accessible depuis le lient Settings.
Les quatre premiers paramètres sont importants.
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.
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
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.
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.
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.
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.
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/
Voir aussi
Documentation officielle: https://plugins.jenkins.io/thinBackup
