Construye y despliega 4: Actualiza la versión de Apache Hop sin perder tus configuraciones

¡Hola a todos! ¡Bienvenidos de nuevo a nuestra serie "Construye y despliega"! En esta publicación, abordamos un tema esencial para cada usuario de Apache Hop: cómo actualizar tu versión de Apache Hop sin perder tus configuraciones.

En esta guía, te mostraremos los pasos para actualizar de manera segura mientras preservas todas tus configuraciones personalizadas y los pipelines/workflows existentes. ¡Vamos a ello!

Introducción

Imagina esta situación: estás usando la última versión de Apache Hop y ya has configurado tu primer proyecto con archivos de entorno, conexiones y otros objetos de metadatos. Hay una nueva versión de Apache Hop disponible, y quieres actualizar sin perder tus configuraciones.

¿Cómo puedes hacerlo? La mejor práctica recomendada es configurar una variable de entorno del sistema llamada HOP_CONFIG_FOLDER que contenga la ruta a la carpeta hop/config/.

¿Por qué usar HOP_CONFIG_FOLDER?

Cuando instalas Hop, la carpeta hop/config/ contiene el archivo hop-config.json, los proyectos de instalación predeterminados y la carpeta de metadatos. El archivo hop-config.json incluye configuraciones para Apache Hop, como variables del sistema, propiedades de la interfaz gráfica y configuraciones específicas del proyecto.

Al crear una variable del sistema para la carpeta de configuración, puedes mantener tu carpeta de configuración separada de tu instalación de Hop. Así, cuando actualices a una nueva versión, no perderás tus configuraciones.

Proceso de actualización paso a paso

Para mantener tu configuración independiente de la versión instalada de Hop, necesitas establecer el valor de la variable de entorno del sistema HOP_CONFIG_FOLDER a la carpeta que contiene la carpeta hop/config/.

Configuración de variables de entorno del sistema

Para usuarios de Windows:

1. Busca "Variables de entorno" (Environment Variables) en el menú de inicio y selecciona "Editar las variables de entorno del sistema" (Edit the system environment variables).
2. Haz clic en el botón "Variables de entorno" (Environment Variables).
3. Añade una nueva variable de usuario llamada HOP_CONFIG_FOLDER y establece su valor en la ruta donde deseas almacenar tu configuración de Apache Hop (por ejemplo, C:\hop-config).

Para usuarios de MacOS / Linux:

1. Abre tu terminal y edita el archivo de configuración de tu shell (~/.bashrc, ~/.zshrc).

Determinar tu shell

Primero, identifica qué shell estás usando. Abre tu terminal y ejecuta:

Esto generalmente devolverá algo como /bin/bash o /bin/zsh.

Localiza o crea tu archivo de configuración del shell

• Para zsh (Z Shell): El archivo de configuración es ~/.zshrc.
• Para bash (Bourne Again Shell): El archivo de configuración es ~/.bashrc.

Abre el archivo de configuración

En el siguiente ejemplo, usamos /bin/zsh. Abre ~/.zshrc con el comando de tu preferencia:

bash

nano ~/.zshrc


Añadir la variable de entorno del sistema

Añade la siguiente línea a tu archivo de configuración:

bash

export HOP_CONFIG_FOLDER=<TU_RUTA_PREFERIDA_A_HOP_CONFIG_FOLDER>

Guarda el archivo y sal

1. Presiona Ctrl + X para salir.
2. Presiona Y para confirmar los cambios.
3. Presiona Enter para guardar.

Aplica los cambios

Después de guardar el archivo, aplica los cambios ejecutando:

Descarga e instala la nueva versión de Apache Hop

1. Descarga y descomprime la nueva versión de Apache Hop.
   
2. Cuando abras la interfaz gráfica de Hop en la nueva versión, el proyecto "default" se seleccionará por defecto.
3. Pero tu proyecto configurado estará en la lista de proyectos.
4. Al seleccionar tu proyecto, también se mostrará el entorno actual.

Conclusión

Has actualizado Apache Hop con éxito sin perder ninguna de tus configuraciones. Este método garantiza que todos tus archivos de entorno, conexiones y otros objetos de metadatos se conserven, haciendo que el proceso de actualización sea fluido y eficiente.

Además de la variable HOP_CONFIG_FOLDER, hay otras variables de entorno importantes que puedes configurar:

• HOP_AUDIT_FOLDER: Establece esta variable en una ruta válida en tu máquina para almacenar la información de auditoría de Hop, como archivos abiertos recientemente por proyecto y configuraciones de zoom.
• HOP_PLUGIN_BASE_FOLDERS: Esta variable apunta a una lista separada por comas de carpetas donde se encuentran plugins adicionales. Cuando se utiliza, sobrescribe la carpeta predeterminada de plugins, a menos que esta esté incluida en la lista.
• HOP_SHARED_JDBC_FOLDERS: Establece esta variable en una lista separada por comas de carpetas que contienen drivers JDBC. Si cambias esto desde la carpeta predeterminada lib/jdbc, asegúrate de incluir la ruta predeterminada para mantener acceso a los drivers predeterminados.