2021-04-13 23:53:40 +02:00
##==============================================================================================
## ##
## Script gitea-backup.sh ##
## ##
##==============================================================================================
## ##
## gitea-backup.sh [<méthode de backup>] ##
## <méthode de backup> est facultatif. S'il n'est pas spécifié, on fait les deux ! ##
## <méthode de backup> = gitea_dump ##
## = archive_dossier ##
## ##
##==============================================================================================
##==============================================================================================
## ##
## Objectif du script : faire une sauvegarde de l'installation Gitea @ Docker ##
## Il y a aura un shutdown du conteneur le temps de la sauvegarde afin que la base de ##
## données ne soit pas modifiée pendant le backup, puis le conteneur sera redémarré. ##
## ##
## Il faudra créer une tâche planifiée pour lancer la sauvegarde toutes les nuits, par ##
## exemple à 3h du matin. ##
## ##
##==============================================================================================
## ##
## Une méthode officielle de backup de la base de données est présente ici : ##
## https://docs.gitea.io/en-us/backup-and-restore/#backup-command-dump ##
## ##
##==============================================================================================
# Récupération des arguments qu'on place dans des variables constantes
declare -r nb_arg = $# # Nombre d'argument(s) fourni(s) au script.
declare -r methode = " $1 " # 1er argument fourni
2021-04-14 15:40:41 +02:00
if [ " $methode " = "--help" ] || [ " $methode " = "-help" ] || [ " $methode " = "-h" ] || [ " $methode " = "--h" ] ; then
2021-04-13 23:53:40 +02:00
echo "Le script gitea-backup.sh permet de faire une sauvegarde des données du conteneur Gitea."
echo "Utilisation : gitea-backup.sh [<méthode de backup>]"
echo "L'argument <méthode de backup> est facultatif. S'il n'est pas spécifié, on fait les deux !"
echo " <méthode de backup> = gitea_dump"
echo " = archive_dossier"
echo
exit 0
fi
mode_backup = 0 # 0 = aucune méthode indiquée ; 1 = gitea_dump ; 2 = archive_dossier
##──── ────────────────────────────────────────────────────────────────────────────────────────
##──── ────────────────────────────────────────────────────────────────────────────────────────
## ##
## VALEURS À PERSONNALISER ##
## ##
## Chemin d'accès vers votre dossier docker et vers le dossier de backup de gitea ##
# Chemin du dossier qui contient le dossier des données (data) et des backups (backup-data)
GITEA_DOCKER_DIR = /volume1/docker/gitea
# Les noms des dossiers montés dans le conteneur doivent êtres identiques à ceux présents sur la machine hôte. Sinon faudra modifier le script...
# Nom du dossier contenant les backups qui doit exister car il doit être monté dans le conteneur à l'aide du docker-compose.yml.
GITEA_BACKUP_DIR = backup-data
# Nom du dossier contenant les donneés de Gitea (data)
GITEA_DATA_DIR = data
# Nom du conteneur
NOM_CONTENEUR = gitea
# ID de l'utilisateur du NAS qui a les droits sur le conteneur
ID_USER_NAS = 1060
##──── ────────────────────────────────────────────────────────────────────────────────────────
##──── ────────────────────────────────────────────────────────────────────────────────────────
echo " $( date "+%R:%S - " ) Script de sauvegarde des données du conteneur Gitea "
##==============================================================================================
## Vérification de la présence des dossiers du conteneur ##
cd $GITEA_DOCKER_DIR
num_erreur = $? # On stocke le code de retour de la commande précédente.
if [ $num_erreur -ne 0 ] ; then # Si ce code n'est pas 0, il y a eu une erreur, on arrète le script.
echo " Le chemin ' $GITEA_DOCKER_DIR ' est invalide ! Veuillez vérifier le chemin d'accès... "
echo " Abandon, avec code d'erreur $num_erreur "
exit $num_erreur
fi
2021-04-16 07:23:08 +02:00
dossier_manquant = ""
2021-04-15 19:58:29 +02:00
if [ ! -d " $GITEA_BACKUP_DIR " ] ; then
dossier_manquant = " $GITEA_BACKUP_DIR "
fi
if [ ! -d " $GITEA_DATA_DIR " ] ; then
dossier_manquant = dossier_manquant + " ; $GITEA_DATA_DIR "
fi
if [ " $dossier_manquant " != "" ] ; then
echo " Le(s) dossier(s) suivant(s) n'existe(nt) pas : $dossier_manquant . "
echo " Abandon, avec code d'erreur 999."
2021-04-13 23:53:40 +02:00
exit 999
else
2021-04-15 19:58:29 +02:00
echo " -- Les dossiers $GITEA_BACKUP_DIR et $GITEA_DATA_DIR existent bien. Le script peut continuer. "
2021-04-13 23:53:40 +02:00
fi
2021-04-15 19:58:29 +02:00
# Autre méthode, effectuant davantage de tests... donc moins efficace...
# if [ ! -d "$GITEA_BACKUP_DIR" ] || [ ! -d "$GITEA_DATA_DIR" ]; then # Au moins un des dossiers n'existe pas
# if [ ! -d "$GITEA_BACKUP_DIR" ]; then # Le dossier $GITEA_BACKUP_DIR n'existe pas !
# echo " Le dossier '$GITEA_BACKUP_DIR' n'existe pas !"
# fi
# if [ ! -d "$GITEA_DATA_DIR" ]; then # Le dossier $GITEA_DATA_DIR n'existe pas !
# echo " Le dossier '$GITEA_DATA_DIR' n'existe pas !"
# fi
# echo " Abandon, avec code d'erreur 999"
# exit 999
# else
# echo "-- Les dossiers $GITEA_BACKUP_DIR et $GITEA_DATA_DIR existent bien. On peut continuer."
# fi
2021-04-13 23:53:40 +02:00
##==============================================================================================
##==============================================================================================
## ##
## Définition du mode de backup à faire en fonction de la méthode donnée en argument ##
case $methode in
gitea_dump) # Méthode gitea_dump sélectionnée ##
mode_backup = 1
#echo "mode_backup=$mode_backup"
; ;
archive_dossier) # Méthode archive_dossier sélectionnée ##
mode_backup = 2
#echo "mode_backup=$mode_backup"
; ;
*) # Aucune méthode sélectionnée ##
mode_backup = 0
#echo "mode_backup=$mode_backup"
; ;
esac
##==============================================================================================
##==============================================================================================
## ##
## Partie concernant les sauvegardes ##
2021-04-14 15:40:41 +02:00
if [ $mode_backup -eq 0 ] || [ $mode_backup -eq 1 ] ; then
2021-04-13 23:53:40 +02:00
# Aucune méthode n'est choisie ou bien méthode gitea_dump sélectionnée
# Rappel des variables :
# GITEA_DOCKER_DIR=/volume1/docker/gitea
# GITEA_BACKUP_DIR=backup-data
# GITEA_DATA_DIR=data
# NOM_CONTENEUR=gitea
# ID_USER_NAS=1060
echo "-- Sauvegarde via Gitea dump. (un peu chiant à restaurer...)"
echo "###############################################################################"
# Dans la commande suivante, les chemins d'accès donnés en paramètres sont des chemins d'accès à l'intérieur du conteneur, montés avec le docker-compose.yml.
# Exemple de commande sans variables :
2021-04-14 19:38:03 +02:00
# docker exec -u 1060 -i -w /backup-data $(docker ps -qf "name=gitea") bash -c '/app/gitea/gitea dump -c /data/gitea/conf/app.ini'
# Note : La commande lancée dans une tâche CRON (planifiée) ne permet pas l'utilisation du paramètre -t.
# Commande à lancer dans un terminal :
# docker exec -u 1060 -i -w /backup-data $(docker ps -qf "name=gitea") bash -c '/app/gitea/gitea dump -c /data/gitea/conf/app.ini'
2021-04-14 15:40:41 +02:00
2021-04-14 19:38:03 +02:00
docker exec -u $ID_USER_NAS -i -w /$GITEA_BACKUP_DIR $( /usr/local/bin/docker ps -qf " name= $NOM_CONTENEUR " ) bash -c " /app/gitea/gitea dump -c / $GITEA_DATA_DIR /gitea/conf/app.ini "
2021-04-13 23:53:40 +02:00
num_erreur = $? # On stocke le code de retour de la commande précédente.
if [ $num_erreur -ne 0 ] ; then # Si ce code n'est pas 0, il y a eu une erreur, on arrète le script.
2021-04-14 15:40:41 +02:00
echo "!!!!!! Erreur lors de la commande de backup gitea dump."
#echo "!!!!!! Commande lancée :"
#echo " docker exec -u $ID_USER_NAS -it -w /$GITEA_BACKUP_DIR $(docker ps -qf "name=$NOM_CONTENEUR") bash -c "/app/gitea/gitea dump -c /$GITEA_DATA_DIR/gitea/conf/app.ini""
echo " !!!!!! Abandon, avec code d'erreur $num_erreur "
2021-04-13 23:53:40 +02:00
exit $num_erreur
fi
echo "###############################################################################"
echo "-- Sauvegarde via Gitea dump terminée."
fi
2021-04-14 15:40:41 +02:00
if [ $mode_backup -eq 0 ] || [ $mode_backup -eq 2 ] ; then
2021-04-13 23:53:40 +02:00
# Aucune méthode n'est choisie ou bien méthode archive_dossier sélectionnée
echo " -- Sauvegarde par création d'une archive de tout le dossier $GITEA_DATA_DIR "
echo "###############################################################################"
echo " -- Extinction du conteneur $NOM_CONTENEUR "
cd $GITEA_DOCKER_DIR # Même si on est censé déjà être là...
docker stop $NOM_CONTENEUR
tar -czf $GITEA_BACKUP_DIR /Gitea-Data-Backup-` date +%Y-%m-%d--%Hh%Mm%Ss` .tar.gz ./$GITEA_DATA_DIR
# On Linux/Unix, in order to backup directories you must use tar :
# - to backup a directory : tar cf - directory | 7z a -si directory.tar.7z
# - to restore your backup : 7z x -so directory.tar.7z | tar xf -
tar cf - ./$GITEA_DATA_DIR | 7z a -si $GITEA_BACKUP_DIR /Gitea-Data-Backup-` date +%Y-%m-%d--%Hh%Mm%Ss` .7z
echo " -- Archive de tout le dossier $GITEA_DATA_DIR créée. "
echo "-- Redémarrage du conteneur Gitea..."
docker start $NOM_CONTENEUR
echo "###############################################################################"
echo "-- Processus de sauvegarde par création d'archive terminé."
fi
echo " $( date "+%R:%S - " ) Fin du script de sauvegarde des donneés du conteneur Gitea "
exit 0
## ##
##==============================================================================================
