Différences

Ci-dessous, les différences entre deux révisions de la page.

--- technique:docker:picasoft:update [2020/10/07 19:55] – qduchemi
+++ technique:docker:picasoft:update [2021/10/16 18:15] – qduchemi
@@ Ligne 1: / Ligne 1: @@
 {{indexmenu_n>35}}
 # Mettre à jour un service ou sa configuration
+<bootnote warning>
+Prérequis : les articles de [[technique:docker:general:start|cette section]].
+</bootnote>
 <bootnote>Ces explications ne valent que pour un service qui est déjà en production et que l'on souhaite mettre à jour.</bootnote>
@@ Ligne 19: / Ligne 23: @@
 ## Comment mettre à jour un service ?
-Il est pertinent de créer une branche avant chaque mise à jour où vous n'êtes pas sûr des modifications, et ne de fusionner dans `master` que lorsque les tests ont été effectués.
+Il pourrait être pertinent de créer une branche avant chaque mise à jour où vous n'êtes pas sûr des modifications, et ne de fusionner dans `master` que lorsque les tests ont été effectués.
+<bootnote critical>
+Les instructions spécifiques  de mise à jour de chaque service se trouvent dans le README de chaque dossier. Pensez à y jeter un coup d'oeil.
+</bootnote>
 ### Mise à jour de la configuration
@@ Ligne 43: / Ligne 51: @@
 * Changement d'un script d'initialisation copié dans le Dockerfile. Par exemple, le [script d'initialisation de Plume](https://gitlab.utc.fr/picasoft/projets/dockerfiles/-/blob/master/pica-plume/entrypoint.sh) effectue diverses opérations que l'on pourrait vouloir compléter, et ce script est copié [directement dans le Dockerfile](https://gitlab.utc.fr/picasoft/projets/dockerfiles/-/blob/master/pica-plume/Dockerfile).
 * etc.
-<bootnote warning>Si le code du service à copier dans l'image est intégré au dépôt par un submodule (par exemple avec [pica-metrics-bot](https://gitlab.utc.fr/picasoft/projets/dockerfiles/-/tree/master/pica-metrics-bot)), on lancera la commande suivante pour le mettre à jour à la dernière version. Voir la documentation des submodules pour utiliser un tag ou une branche spécifique.
-```
-git submodule update --recursive --remote <dossier du service>
-```</bootnote>
 Vous pouvez travailler en local et tester l'image sur votre machine si vous voulez. Il y a quelques modifications supplémentaires à apporter. Comme on construit une nouvelle version de l'image, il faut modifier le tag dans le fichier Compose pour que l'image construite soit différenciée des précédentes.
 * Si on met à jour un service (version X → version Y), on passera le tag du fichier Compose de X à Y.
-* Si on met juste à jour un fichier "maison" ou une configuration intégrée dans l'image, mais qu'on ne change pas la version du logiciel, on pourra ajouter au tag quelque chose comme `-Z`, de sorte que le tag deviennent `registry.picasoft.net/pica-<service>:vX-Y`
+* Si on met juste à jour un fichier "maison" ou une configuration intégrée dans l'image, mais qu'on ne change pas la version du logiciel, on pourra ajouter au tag quelque chose comme `-Z`, de sorte que le tag deviennent `registry.picasoft.net/pica-<service>:vX-Z`.
 Dans tous les cas, on modifiera ou on créera le fichier `CHANGELOG.md` pour décrire les modifications apportées à l'image.
+## Que faire ensuite ?
-Une fois que toutes ces modifications sont poussées sur le dépôt, il faut aussi pousser la nouvelle version de l'image sur le [[technique:docker:general:mise_en_place_d_un_registry_docker|registre de production]].
+Une fois arrivé à ce stade, votre nouvelle version du service est prête à être déployée depuis n'importe quelle machine de Picasoft. La prochaine étape est [[technique:docker:picasoft:test|de tester la modification]] que vous avez apportée, sauf si elle est vraiment minime (exemple : changement marginal d'un paramètre de configuration).
-Le plus simple est de se rendre sur la machine de test (qui est sans doute plus puissante que votre machine et se trouve sur le même réseau que le registre de production), de se synchroniser avec le dépôt, de construire l'image, et de la pousser. Ça ressemble à ça :
-```bash
-$ ssh login@pica01-test.picasoft.net
-$ cd /DATA/docker/dockerfiles
-$ git pull
-# Si vous avez travaillé sur une branche spécifique
-$ git checkout <votre branche>
-$ cd pica-<service>
-# Construire la nouvelle image et la tagger
-# avec le nom indiqué dans le fichier Compsoe
-$ docker-compose build
-# Pousser l'image construite sur registry.picasoft.net
-$ docker-compose push
-```
-<bootnote warning>Attention, cette opération nécessite d'être connecté au registre de production. Les identifiants se trouvent dans le [pass](https://gitlab.utc.fr/picasoft/interne/pass).</bootnote>
-## Conclusion
-Une fois arrivé à ce stade, votre nouvelle version du service est prête à être déployée depuis n'importe quelle machine de Picasoft. La prochaine étape est de tester la modification que vous avez apportée, sauf si elle est vraiment minime (exemple : changement marginal d'un paramètre de configuration).