pavics/scenario-requests repository overview

⁠scenario-requests

A climate change scenario-building repository to answer requests sent to [email protected]⁠.

A list of processed requests is available in /data/README.md

⁠Ajout de dashboards:

⁠Ajout de dashboards en local:

1. Ajouter les dépendences nécessaire à env.yml
2. Créer un run.sh dans le dossier approprier
3. Ajouter un service docker dans docker-compose.yml, avec une commande pointant vers run.sh

⁠Ajout de dashboards sur PAVICS:

1. Ajouter les dépendences nécessaire à env.yml
2. Créer un run.sh dans le dossier approprier
3. Pousser vers main (ou pointer la configuration vers la branche appropriée)
4. Créer une nouvelle tag, de la forme docker-YYMMDD
5. Ajouter les données nécessaire sur un dossier publique de PAVICS, e.g. public/sgammon/data/scenario-requests/2024-124/data
6. Ajouter une nouvelle configuration à /deployment/restart_service
7. Ajouter une nouvelle configuration dans Ouranosinc/pavics_panel_ouranos_deploy.

   1. celle-ci devrait pointer vers run.sh

   2. pour l'image docker, utilise scenario-requests:YYMMDD, qui à été créé depuis la tag à l'étape 4.

   3. Option 1: Créer un volume qui pointe vers le data-directory publique sur Pavics, et mettre les envs appropriés:

      volumes: [..., ${JUPYTERHUB_USER_DATA_DIR}/public-share:/notebook_dir/public:ro]

      environmnent: {..., DATA_DIR: /notebook_dir/public/sgammon-public/data/scenario-requests/2024-124/data}

      Option 2: Créer un volume qui pointe seulement vers les données nécessaire

      volumes: [${JUPYTERHUB_USER_DATA_DIR}/public-share/sgammon-public/data/scenario-requests/2024-124/data:/data]

Note qu'il n'a qu'un seul image docker pour le repo au complet, pour simplifier le déployment, donc l'environnement conda est partagé.

⁠Mises à Jour

⁠Mise à jour des données sur un Dashboard déployé:

Modifier les données à l'endroit sauvegardé à l'étape 5.

⁠Mise à jour du code:

Si seulement le code change, il sera mis à jour une fois au quinze minutes s'il a des commits git dans le repo pointé dans /scheduler-jobs/deploy_pavics_panel_ouranos.yml

⁠Mise à jour de l'image des dashboards sur PAVICS:

Ceci est utile s'il est nécessaire d'updater l'environnement d'un des dashboards. Par exemple, si on découvre un bogue qui est réparé dans une nouvelle version de xclim.

Cette mise-à-jour sera fait une fois par jour, pendant la nuit.

1. Créer une nouvelle tag, de la forme docker-YYMMDD
2. Updater les images dans Ouranosinc/pavics_panel_ouranos_deploy, pour pointer les dashboards à updater aux nouvelles