Procédure de test permettant de valider le bon fonctionnement de la mise à jour¶

Notes:

• Toutes les commandes sont exécutées sur la machine groff.
• la commande su - gitea "/srv/gitea/bin/gitea migrate-storage" pourrait être utilisée à la suite de la commande migrate mais en cas d'erreur il serait nécessaire de restaurer les données modifiées depuis la sauvegarde au format zip.

Préparer l'environnement de test¶

• VERSION="" /srv/forge.chapril.org/tools/upgrade.sh stop backup@ # couper le service gitea et faire une sauvegarde
• unzip /srv/gitea/bin/gitea-dump-XXXX.zip gitea-db.sql -d /var/tmp/ # extraire le dump de la base du backup
  • su - postgres "pg_dump -U postgres -O giteadb -f /var/tmp/gitea-db.sql" # créer un dump de la base giteadb (alternative à la commande précédente)
• chown postgres /var/tmp/gitea-db.sql # Autoriser l'utilisateur postgres à accéder au fichier
• chmod g+r /var/tmp/gitea-db.sql
• su - postgres -c "psql -c 'alter database giteadb set default_transaction_read_only=on;'" # interdire les modifications en écriture sur la base giteadb
• su - postgres -c "createdb --owner giteadbadmin testmigration" # créer une pase de données de test
• su - postgres -c "psql -d testmigration -f /var/tmp/gitea-db.sql -W -h127.0.0.1 giteadbadmin" # importer la base
• echo "local testmigration giteadbadmin scram-sha-256" >> /etc/postgresql/13/main/pg_hba.conf # Autoriser l'utilisateur giteadbadmin à accéder à la base de test
• systemctl restart postgresql.service # prendre en compte la modification
• sed -i 's/\<giteadb$/testmigration/' /etc/gitea/gitea.ini # indiquer à gitea d'utiliser la base de test
• Pour empêcher que des utilisateurs n'utilisent l'environnement de test: ajouter la configuration suivante à l'intérieur de la balise VirtualHost /etc/apache2/sites-enabled/forge.chapril.org.conf :
  

   <Proxy *>
      Require ip XXXX # ip publique de la personne réalisant le test de migration
   </Proxy>

• systemctl restart apache2 # prendre en compte les modifications
• Tester qu'une autre IP publique ne peut pas accéder au service https://forge.chapril.org

Tester la nouvelle version¶

• VERSION="X.Y.Z" /srv/forge.chapril.org/tools/upgrade.sh download
• su - gitea -c "/srv/gitea/bin/gitea-1.16.3-linux-amd64 --config /etc/gitea/gitea.ini migrate" # migrer la base de données, vérifier que la commande ne rencontre pas d'erreur
• VERSION="X.Y.Z" /srv/forge.chapril.org/tools/upgrade.sh upgrade
• VERSION="X.Y.Z" /srv/forge.chapril.org/tools/upgrade.sh start # démarrer le service web
• Tester les problèmes connus

Revenir à l'environnement de prod¶

• su - postgres -c "psql -c 'alter database giteadb set default_transaction_read_only=off;'" # autoriser à nouveau les modifications en écriture sur la base giteadb
• systemctl stop gitea apache2 postgresql
• sed -i 's/\<testmigration$/giteadb/' /etc/gitea/gitea.ini # indiquer à gitea d'utiliser la base de test
• Supprimer la dernière ligne du fichier /etc/postgresql/13/main/pg_hba.conf
• Supprimer les directives ajoutées au fichier /etc/apache2/sites-enabled/forge.chapril.org.conf
• git -C /etc status # Vérifier qu'il n'y a pas de modifications inattendues
• ln --force /srv/gitea/bin/gitea-X.Y.Z-linux-amd64 /srv/gitea/bin/gitea # X.Y.Z correspond à la version de prod
• systemctl start postgresql apache2 gitea

En fonction des résultats des tests, réaliser ou non la migration en suivant la procédure habituelle¶