Construye y despliega 3: Gestiona tu proyecto Apache Hop con la integración de Git

¡Hola a todos! ¡Bienvenidos de nuevo a nuestra serie "Construye y despliega" con Apache Hop! En esta publicación, vamos a cubrir una parte crucial de cualquier proceso de desarrollo: el control de versiones. Específicamente, gestionaremos nuestro proyecto de Apache Hop utilizando la integración de Git. Este es un paso esencial para garantizar que tu trabajo esté respaldado, sea compartible y esté versionado correctamente.

¡Así que, vamos a empezar!

Lo que aprenderás en esta publicación

• Por qué Git es esencial para rastrear cambios, colaborar y garantizar que tu proyecto esté respaldado y versionado adecuadamente.
• Preparar tu proyecto de Apache Hop para Git.
• Cómo agregar archivos a tu repositorio de Git, hacer commit de los cambios y enviarlos a un repositorio remoto.
• Cómo realizar operaciones esenciales de Git, como obtener cambios, revertir archivos y comparar visualmente revisiones de archivos, directamente desde la interfaz fácil de usar de Apache Hop.

💡 En esta publicación, nos enfocamos exclusivamente en la integración de Git de Apache Hop, en lugar de cubrir herramientas de línea de comandos de Git o cualquier cliente externo de Git. Para aquellos que deseen explorar el uso de Git con otros clientes o la línea de comandos, recomendamos consultar la documentación oficial de Git para obtener una guía más detallada.

Por qué Git y el control de versiones son importantes

Antes de sumergirnos en los pasos técnicos, hablemos brevemente sobre por qué usar Git es tan importante.

Git te permite rastrear cambios en tu proyecto a lo largo del tiempo, colaborar con otros sin sobrescribir el trabajo de cada uno y volver a versiones anteriores si algo sale mal. Ya sea que trabajes solo o en equipo, usar Git es una buena práctica que ahorra tiempo y dolores de cabeza en el futuro.

Preparando tu Apache Hop

Primero lo primero, asegúrate de que tu proyecto de Apache Hop esté organizado y listo para ser versionado. Aquí tienes una lista de verificación rápida:

• Tu proyecto de Apache Hop ya está configurado: Si no es así, consulta los pasos anteriores en esta serie: Instalación, primer proyecto y entorno y Desarrolla tus primeras canalizaciones en un flujo de trabajo.
• Asegúrate de que tus archivos de proyecto estén limpios: Elimina cualquier archivo temporal o innecesario.
• Estructura de directorios: Asegúrate de que tu directorio de proyecto tenga una estructura clara, con carpetas para tus canalizaciones, flujos de trabajo y configuraciones de entorno.
• Instalación de Git: Git está instalado en tu sistema.

Si aún no has configurado tu directorio de proyecto, adelante, hazlo ahora.

¿Por qué usar la integración de Git en la GUI de Apache Hop?

Usar Git dentro de la GUI de Apache Hop es una opción fantástica si prefieres una interfaz visual o si eres nuevo en Git de línea de comandos. La integración te ayuda a:

• Rastrear cambios en tiempo real con estados de archivo codificados por colores.
• Preparar, hacer commit, enviar y obtener cambios fácilmente sin salir del entorno de Hop.
• Comparar visualmente revisiones de archivos para ver qué ha cambiado entre diferentes versiones de canalizaciones o flujos de trabajo.

La integración de Git incorporada en Hop simplifica la gestión del historial de versiones de tu proyecto y la colaboración con otros.

💡 El primer paso podría ser que crees un repositorio vacío con tu cuenta de Git, lo clones y luego uses esa carpeta como tu carpeta de inicio de proyecto de Apache Hop. Si no hiciste esto antes de crear tu proyecto de Apache Hop, no te preocupes, crea un repositorio vacío, clónalo y mueve tus archivos de proyecto a ese repositorio o usa git init.

Paso 1: Accediendo a la perspectiva del Explorador de Archivos

La perspectiva del Explorador de Archivos es tu punto de partida para gestionar archivos en Apache Hop. Esto incluye desde crear nuevas carpetas, abrir flujos de trabajo y canalizaciones, hasta manejar el control de versiones de Git. Para acceder al Explorador de Archivos:

1. Abre Apache Hop.
2. Presiona CTRL + Shift + E (o haz clic en el ícono de carpeta).

Esta perspectiva te da acceso a todos los archivos asociados con tu proyecto, como flujos de trabajo (hwf), canalizaciones (hpl), JSON, CSV y más.

Paso 2: Configurando la integración de Git para my-hop-project

Para garantizar que tu proyecto esté controlado por versiones usando Git, Apache Hop necesita detectar un repositorio Git en la carpeta del proyecto. Aquí te explicamos cómo habilitar la integración de Git:

• Instala el complemento de Git: Asegúrate de que el complemento de Git esté instalado en el entorno de Hop. El complemento debe estar ubicado en el directorio plugins/misc/git dentro de tu instalación de Hop.

• Configura Git en Hop: Si tu repositorio Git está inicializado, Hop detectará automáticamente el archivo .git/config dentro de tu carpeta de proyecto. A partir de ahora, los estados de tus archivos estarán codificados por colores en el Explorador de Archivos:

  • Rojo: Archivos que aún no se han agregado a Git (no preparados).
  • Azul: Archivos que han sido modificados (preparados pero no confirmados).
  • Gris: Archivos ignorados por Git.

✔️ Importante:

Ciertos archivos, como ./git/config y objetos de metadatos, están ocultos por defecto. Es importante tener en cuenta que no se recomienda la edición manual de archivos JSON de metadatos, ya que puede provocar problemas en la configuración de tu proyecto. Para ver archivos ocultos, puedes usar la opción "Mostrar/Ocultar" disponible en el menú. Esto te permite alternar la visibilidad de estos archivos cuando sea necesario.

Paso 3: Agregando archivos a Git

En Apache Hop, agregar archivos a Git (prepararlos) es increíblemente simple usando la GUI. Aquí tienes cómo hacerlo:

1. Selecciona el/los archivo(s) que deseas agregar a Git desde el Explorador de Archivos.
2. En la barra de herramientas en la parte superior, verás el botón Git Add. Hacer clic en esto preparará los archivos seleccionados, lo que significa que están listos para ser confirmados en tu repositorio Git.

Alternativamente, haz clic derecho en el archivo en el Explorador de Archivos y selecciona Git Add.

Una vez preparados, el archivo cambiará de rojo a azul, indicando que está listo para ser confirmado.

Paso 4: Confirmando cambios

Después de preparar tus archivos, querrás confirmarlos. Un commit es una instantánea de tu proyecto en un momento específico en el tiempo.

1. Haz clic en el botón Git Commit en la barra de herramientas.
2. Selecciona los archivos que has preparado en el Explorador de Archivos y que deseas incluir en el commit.
   
3. Un cuadro de diálogo te pedirá que ingreses un mensaje de commit. Sé descriptivo; este mensaje debe resumir los cambios que has realizado.
4. Confirma el commit.

Una vez confirmado, los archivos en azul volverán a un color neutral.

Paso 5: Enviando cambios a un repositorio remoto

Si estás trabajando con otros o simplemente deseas respaldar tu trabajo, querrás enviar tus cambios a un repositorio Git remoto (por ejemplo, GitHub, GitLab o Bitbucket).

1. En la barra de herramientas de Git, haz clic en el botón Git Push.
2. Apache Hop te pedirá tu nombre de usuario y contraseña de Git. Una vez que proporciones los detalles de autenticación correctos, aparecerá un mensaje de confirmación que indicará que el envío fue exitoso.

Gestionando operaciones de Git en la GUI de Hop

Además de agregar y confirmar archivos, la perspectiva del Explorador de Archivos de Apache Hop te permite gestionar otras operaciones de Git:

• Pull: Para recuperar los últimos cambios de tu repositorio remoto, haz clic en el botón Git Pull en la barra de herramientas. Esto garantiza que siempre estés trabajando con la versión más actualizada del proyecto.
• Revert: Si necesitas descartar cambios en un archivo o carpeta, selecciona el archivo y haz clic en Git Revert en la barra de herramientas de Git.
• Visual Diff: Apache Hop te permite comparar visualmente diferentes versiones de un archivo. Haz clic en el botón Git Info, selecciona una revisión específica y utiliza la opción Visual Diff para ver los cambios entre dos versiones de una canalización o flujo de trabajo. Esto abrirá dos pestañas, mostrando los estados anterior y posterior de tu proyecto.

Resumiendo las operaciones de archivos

El Explorador de Archivos en Apache Hop ofrece varias opciones en la barra de herramientas para la gestión de archivos:

• Abrir archivo seleccionado: Usa la flecha derecha o haz doble clic para abrir un archivo seleccionado.
  • ✔️ Ten en cuenta que los flujos de trabajo o canalizaciones se abren en la perspectiva de Orquestación de Datos, mientras que otros tipos de archivos se abren en una nueva pestaña.
• Crear carpeta: Agregar una nueva carpeta.
• Eliminar: Eliminar un archivo o carpeta seleccionada.
• Renombrar: Renombrar un archivo o carpeta.
• Actualizar: Actualizar la lista de archivos.
• Mostrar u ocultar archivos: Mostrar u ocultar archivos o directorios.

Conclusión

¡Y eso es todo! Has agregado con éxito tu proyecto de Apache Hop a Git. Ahora, tu proyecto está controlado por versiones, respaldado y listo para la colaboración.

En próximas publicaciones del blog, ejecutaremos nuestro proyecto utilizando varios métodos como Hop-Run y Docker, así que mantente atento a eso.