Routine

Mise à jour des variants

Danger

Cetet partie n’est plus d’actualité depuis le passage au fichier trame 3. Elle est toujours disponible à titre informatif et peut être utilisée par exemple lors de mise à jour de code.

  1. Cloner le projet

Le code est disponible sur GitLab : https://gitlab.com/ifb-elixirfr/covid19/EMERGEN-DB

git clone https://gitlab.com/ifb-elixirfr/covid19/EMERGEN-DB.git

  1. Ajouter le fichier trame mis à jour dans le dossier static-apps/version.

Danger

Il est très important de respecter la règle des noms. En effet, le bouton de téléchargement dans l’application va récupérer le dernier fichier grâce au nom du fichier et le numéro de version par une expression régulière. Il faut donc être particulièrement prudent sur ce nom. La structure du nom est YYYY-MM-DD_ACRONYME-PF_semaineXX_emergen_typage_vY.Y.Y.xlsx où vous devez remplacer le Y.Y.Y par le numéro de version. Par exemple, lors de l’écriture de cette documentation le dernier fichier trame portait le nom : YYYY-MM-DD_ACRONYME-PF_semaineXX_emergen_typage_v2.0.2.xlsx

  1. Tester : La documentation pour tester le code est disponible ici : Code quality

  2. Mettre à jour le repo

git push origin NOM_BRANCHE

Puis faire une merge request

  1. Se connecter au serveur hébergeant l’application

  2. Mettre à jour le code

sudo git pull origin master

  1. Mettre à jour l’image

sudo docker-compose -f docker-compose.prod.yml pull web
sudo docker-compose -f docker-compose.prod.yml up -d
sudo docker-compose -f docker-compose.prod.yml exec web python manage.py collectstatic --no-input --clear
sudo docker system prune -a -f

Et UNIQUEMENT en cas de changement de la description des colonnes :

docker-compose -f docker-compose.prod.yml exec web python manage.py load_description

Cas extrêmement rare : la connexion au registry est active mais cette connexion peut être perdue. Vous pouvez utiliser la commande suivante pour vous reconnecter :

sudo docker login registry.gitlab.com

  1. Prévenir les utilisateurs - Dans la page admin, dans le bloc AUTHENTIFICATION ET AUTORISATION, cliquez sur Utilisateurs. Sélectionnez tous les utilisateurs puis dans les actions : Send email.

Mise à jour des utilisateurs

Fréquence : Variable (importante au début du projet puis dégressif)

Cette partie est détaillée ici : Page d’administration

Note

Pour rappel, le fichier doit être en CSV, séparteur Point-virgule et encodage Unicode (UTF-8)

Mise à jour des description

Fréquence : Rare

Uniquement lors de l’ajout de nouvelle colonne ou de la modification des descriptions.

Cette partie est détaillée ici : Page d’administration

Mise à jour des annotations

Fréquence : Rare

Cette est actuellement en développement pour une tentative d’indexation automatique des

Cette partie est détaillée ici : Page d’administration

Les fichiers statiques

Fréquence : Rare

L’architecture de l’application impose de mettre à jour de temps en temps les fichiers statiques. Par exemple, lors de l’ajout d’un nouveau fichier trame.

Les étapes sont :

  1. Se connecter à votre serveur et aller dans le dossier de l’application

  2. Mettre à jour le git (comme les fichiers statiques transitent par GitLab, l’objectif est d’avoir un repo toujours à jour)

sudo git pull origin master

  1. Mettre à jour les fichiers statiques

sudo docker-compose -f docker-compose.prod.yml exec web python manage.py collectstatic --no-input --clear

La documentation

Fréquence : Rare

La documentation est écrite en sphinx et toutes les explications pour la gérer sont ici : Gestion de la documentation

Il faut savoir que la documentation est automatiquement générée à la création de l’image dans GitLab CI.

Éteindre et redémarrer l’application

Fréquence : Rare

sudo docker-compose -f docker-compose.prod.yml down
sudo docker-compose -f docker-compose.prod.yml up -d