Installation des plugins

Il existe plusieurs façons d’installer un plugin :

Utilisation et variable d’environnement

Cette méthode suppose que les services de composition du docker Climweb sont déjà en cours d’exécution.

Vous pouvez utiliser les variables d’environnement CLIMWEB_PLUGIN_GIT_REPOS lorsque vous utilisez les images docker Climweb pour installer les plugins au démarrage.

• Le CLIMWEB_PLUGIN_GIT_REPOS doit être une liste séparée par des virgules d’URL https git repo qui sera utilisée pour télécharger et installer les plugins au démarrage.

Après avoir défini la variable d’environnement, vous pouvez démarrer le conteneur Docker à l’aide de la commande suivante :

docker compose up 

Ces variables ne se déclencheront et ne seront installées que lorsqu’elles seront trouvées au démarrage du conteneur. Pour désinstaller un plugin, vous devez toujours suivre manuellement les instructions ci-dessous.

Mises en garde lors de l’installation dans un conteneur existant

Si jamais vous supprimez le conteneur dans lequel vous avez installé les plugins au moment de l’exécution et que vous le recréez, le nouveau conteneur est créé à partir de l’image Docker de base de climweb sur laquelle aucun plugin n’est installé.

Cependant, lorsqu’un plugin est installé au moment de l’exécution ou de la construction, il est stocké dans le dossier conteneur CLIMWEB_PLUGIN_DIR qui par défaut est /climweb/plugins qui doit être monté dans un volume Docker. Au démarrage, si un plugin est trouvé dans ce répertoire qui n’a pas encore été installé dans le conteneur actuel, il sera réinstallé.

Tant que vous réutilisez le même volume de données, vous ne devriez perdre aucune donnée du plugin même si vous supprimez et recréez les conteneurs. Le seul effet est qu’au démarrage initial du conteneur, vous pourriez voir les plugins se réinstaller si vous avez recréé le conteneur à partir de zéro.

Désinstaller un plugin installé à l’aide d’une variable d’environnement

• Il est fortement recommandé de sauvegarder vos données avant de désinstaller un plugin.

• Pour désinstaller un plugin que vous avez installé à l’aide de l’un des CLIMWEB_PLUGIN_GIT_REPOS, vous devez vous assurer de supprimer et de recréer le conteneur avec le plugin supprimé de la variable d’environnement correspondante. Si vous ne parvenez pas à le faire et désinstallez simplement le plugin en utilisant exec et redémarrez, le plugin sera réinstallé après le redémarrage car la variable d’environnement contiendra toujours l’ancien plugin.

Vérifier quels plugins sont déjà installés

Utilisez la commande list-plugins ou le script /climweb/plugins/list_plugins.sh intégré pour vérifier quels plugins sont actuellement installés.