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.
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
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
Tester : La documentation pour tester le code est disponible ici : Code quality
Mettre à jour le repo
git push origin NOM_BRANCHE
Puis faire une merge request
Se connecter au serveur hébergeant l’application
Mettre à jour le code
sudo git pull origin master
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
Prévenir les utilisateurs - Dans la page admin, dans le bloc
AUTHENTIFICATION ET AUTORISATION
, cliquez surUtilisateurs
. 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 :
Se connecter à votre serveur et aller dans le dossier de l’application
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
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