Ir al contenido principal

Integración Git CI

Git CI mantiene sincronizado un repositorio de Smart Engineering con un repositorio de Bitbucket Cloud. Cuando un evento de Git configurado coincide con los disparadores y filtros seleccionados, AI Cockpit importa e indexa el commit exacto que produjo el evento.

Use Git CI cuando el repositorio de código fuente cambia con frecuencia y el equipo quiere tener el código disponible en Smart Engineering sin cargar un nuevo paquete .zip en cada cambio.

Antes de empezar​

  • Abra el repositorio de Smart Engineering que recibirá las actualizaciones.
  • Tenga el espacio de trabajo y el slug del repositorio de Bitbucket Cloud, por ejemplo, workspace/repository.
  • Tenga la URL de clonación y un token de acceso o token de API de Bitbucket con acceso de lectura.
  • Confirme que puede crear un webhook en el repositorio de Bitbucket.

Actualmente, Git CI es compatible con Bitbucket Cloud. La integración importa e indexa código fuente; no crea tareas de documentación ni regenera automáticamente la documentación o los proyectos de Modernización de Código existentes.

Configurar la integración​

  1. Abra la página de configuración del repositorio en /repositories/:repositoryId/config.

  2. Seleccione Configurar Git CI.

  3. Introduzca la identidad del repositorio Bitbucket (workspace/repository), su URL de clonación y una credencial con acceso de lectura.

  4. Seleccione uno o más disparadores:

    DisparadorEvento de Bitbucket correspondiente
    Push a ramaUn push a una rama coincidente.
    Pull request fusionadoUn pull request fusionado en una rama coincidente.
    Etiqueta creadaUn push que crea una etiqueta coincidente.

  5. Defina filtros de rama y etiqueta cuando sea necesario. Los filtros admiten patrones glob, como main, release/* y v*.

  6. Mantenga la integración habilitada y, opcionalmente, indique un correo electrónico para recibir notificaciones de procesamiento.

  7. Seleccione Configurar integración.

  8. Copie la URL y el secreto del webhook mostrados. El secreto se muestra una sola vez.

  9. En Bitbucket, cree un webhook con esa URL y secreto, y habilite los eventos que correspondan a los disparadores seleccionados.

Guarde el secreto del webhook de forma segura. No lo confirme en el código fuente ni lo comparta en tickets o mensajes.

Qué ocurre después de un evento​

Para cada evento coincidente, AI Cockpit pone la revisión en cola, importa el commit SHA exacto y ejecuta la indexación. El estado de la integración muestra el último commit procesado correctamente. El destinatario configurado recibe una notificación cuando el procesamiento tiene éxito o falla.

Los eventos que no coinciden con el disparador, filtro de rama o filtro de etiqueta seleccionados se ignoran. Las notificaciones repetidas del mismo commit no crean importaciones duplicadas y las actualizaciones del mismo repositorio se procesan en orden.

Gestionar la integración​

Use Gestionar integración en la página de configuración para cambiar disparadores, filtros, destinatario de notificaciones o si el procesamiento está habilitado. Para rotar la credencial, introduzca un token nuevo y guarde los cambios.

La identidad y la URL de clonación del repositorio quedan fijas después de la configuración. Para usar otro repositorio de Bitbucket, elimine la integración y créela de nuevo. Eliminar una integración evita que se procesen las entregas pendientes.

Si el procesamiento falla tres veces consecutivas, AI Cockpit deshabilita la integración y cancela las entregas pendientes. Corrija la causa, como una credencial vencida o una revisión inaccesible, y vuelva a habilitar la integración.

Usar Git CI con Modernización de Código​

Espere a que la revisión importada termine de procesarse antes de iniciar un nuevo proyecto de Modernización de Código. Al crear el proyecto, seleccione la versión que contiene la revisión que desea usar como referencia. Una actualización de Git CI no cambia la versión de referencia de un proyecto de modernización existente.

Ver también​