Instalación de complementos

Hay algunas formas de instalar un complemento:

Uso de una variable de entorno

Este método supone que ya tiene en ejecución los servicios de redacción de la ventana acoplable de Climweb.

Puede utilizar las variables de entorno CLIMWEB_PLUGIN_GIT_REPOS cuando utilice las imágenes de la ventana acoplable de Climweb para instalar complementos al inicio.

  • CLIMWEB_PLUGIN_GIT_REPOS debe ser una lista separada por comas de URL de https git repo que se utilizarán para descargar e instalar complementos al inicio.

Después de configurar la variable de entorno, puede iniciar el contenedor acoplable usando el siguiente comando:

docker compose up 

Estas variables solo activarán la instalación cuando se encuentren al iniciar el contenedor. Para desinstalar un complemento, aún debe seguir manualmente las instrucciones a continuación.

Advertencias al instalar en un contenedor existente

Si alguna vez elimina el contenedor en el que instaló los complementos en tiempo de ejecución y lo vuelve a crear, el nuevo contenedor se crea a partir de la imagen base de la ventana acoplable climweb que no tiene ningún complemento instalado.

Sin embargo, cuando se instala un complemento en tiempo de ejecución o en tiempo de compilación, se almacena en la carpeta contenedora CLIMWEB_PLUGIN_DIR, que de forma predeterminada es /climweb/plugins, que debe montarse dentro de un volumen acoplable. Al iniciar, si se encuentra un complemento en este directorio que aún no se ha instalado en el contenedor actual, se reinstalará.

Siempre que reutilice el mismo volumen de datos, no debería perder ningún dato del complemento, incluso si elimina y vuelve a crear los contenedores. El único efecto es que en el inicio inicial del contenedor, es posible que vea que los complementos se reinstalan solos si vuelve a crear el contenedor desde cero.

Desinstalar un complemento instalado usando una variable de entorno

  • Se recomienda encarecidamente que haga una copia de seguridad de sus datos antes de desinstalar un complemento.

  • Para desinstalar un complemento que instaló usando uno de CLIMWEB_PLUGIN_GIT_REPOS, debe asegurarse de eliminar y volver a crear el contenedor con el complemento eliminado de la variable de entorno correspondiente. Si no lo hace y simplemente desinstala el complemento usando exec y reinicia, el complemento se reinstalará después del reinicio, ya que la variable de entorno aún contendrá el complemento anterior.

Comprobar qué complementos ya están instalados

Utilice el comando list-plugins o el script integrado /climweb/plugins/list_plugins.sh para verificar qué complementos están instalados actualmente.