Integración de un proyecto con un repositorio Git

Conecte un proyecto a un repositorio Git para guardar las configuraciones allí. Al hacerlo, puede utilizar su repositorio y las herramientas CI y CD que elija para automatizar los procesos de configuración de un proyecto.

Esta es una función experimental que está disponible para fines de evaluación y prueba y puede cambiar sin previo aviso.

Las canalizaciones y cadenas de herramientas son personalizables, por lo que puedes automatizar muchas acciones entre tu repositorio Git y tu proyecto mediante el uso de métodos API de proyectos o comandos CLI. Por ejemplo, puede crear una canalización para activar una actualización en su proyecto cuando los cambios de configuración se fusionen con la rama principal en su repositorio. Para obtener más información, consulte Automatizar acciones de proyectos en su repositorio Git.

En un proyecto, las configuraciones de borrador se pueden guardar en cualquier rama de su repositorio. Sin embargo, puedes validar e implementar configuraciones de borrador solo después de que se fusionen con la rama en tu repositorio que administra tus pipelines de CD. También debe sincronizar las actualizaciones de su repositorio en su proyecto actualizando las configuraciones antes de poder validar e implementar esas configuraciones. Puede automatizar esta actualización utilizando el método API project.config.update o utilizando el comando CLI ibmcloud project config-update.

Antes de empezar

Asegúrate de tener el rol de Editor en el servicio Proyectos IBM Cloud para administrar las integraciones del repositorio Git.
Guarde un token de acceso como secreto para conectarse a su repositorio Git. El token de acceso necesita acceso de escritura a las ramas que desea utilizar y para crear confirmaciones en su repositorio. El token de acceso también necesita la capacidad de enumerar ramas y leerlas.
1. Cree una instancia de servicio Secrets Manager en su cuenta IBM Cloud. Para crear un secreto, debes tener el rol de Escritor o superior en el servicio Secrets Manager.
2. Después de crear su instancia secreta, asegúrese de seleccionar Otro tipo de secreto para agregar un secreto arbitrario. Para obtener información sobre cómo crear un secreto arbitrario, consulte Creación de secretos arbitrarios en la interfaz de usuario. Su secreto arbitrario debe contener el token de acceso para su repositorio Git.

Conexión de un proyecto a un repositorio Git

Conecte su repositorio Git a su proyecto. Al hacerlo, los cambios de configuración se guardan en su repositorio, en lugar de en el archivo JSON del proyecto. Debido a que su proyecto necesita guardar configuraciones en su repositorio, debe proporcionar un token de acceso para autenticarse con el repositorio desde su proyecto.

En la consola IBM Cloud, haga clic en el ícono del menú de navegación > Proyectos y seleccione un proyecto.
Desde la pestaña Administrar, seleccione Integraciones.
En la sección de integración del repositorio Git, haga clic en Conectar.
En el menú Tipo de repositorio, seleccione el tipo de repositorio que desea utilizar para administrar sus configuraciones. Normalmente, este repositorio es el que utiliza para administrar sus pipelines y cadenas de herramientas. Puede seleccionar GitHub, GitLab o GitHub Enterprise.
Introduzca la dirección URL al repositorio.
Opcionalmente, especifique una carpeta dentro del repositorio. Considere especificar una carpeta si desea integrar su repositorio con múltiples proyectos. Cada proyecto puede tener su propia carpeta.
Pase el cursor o haga clic en el campo de token de acceso, luego haga clic en el ícono Secretos para seleccionar el secreto que contiene su token de acceso.
Si su proyecto ya contiene configuraciones, seleccione Copiar archivos de configuración existentes a este repositorio para guardar las configuraciones existentes en su repositorio.
Pulse Guardar.

Próximos pasos

Ahora que su repositorio Git está conectado con su proyecto, está listo para personalizar canalizaciones y cadenas de herramientas. Para aprender a crear una canalización que actualice automáticamente las configuraciones en su proyecto cuando los cambios se fusionan con su rama principal, consulte Automatizar acciones de proyectos en su repositorio Git.