DevOps Article

Proyectos e integraciones Git

Last updated: March 12, 2026 5 min read Intermediate

Proyectos e integraciones Git

Los proyectos permiten agrupar issues bajo un prefijo de clave compartido y conectar repositorios Git para el seguimiento automático de actividad.

Crear un proyecto

  1. Navegue a DevOps > Projects en la barra lateral.
  2. Haga clic en New Project.
  3. Introduzca un nombre y una clave de proyecto única (letras mayúsculas y números, de 2 a 10 caracteres). La clave no se puede cambiar después de la creación.
  4. Opcionalmente, establezca un líder de proyecto, tipo de issue predeterminado, asignado predeterminado y un patrón de nomenclatura de ramas predeterminado.
  5. Haga clic en Create para guardar.

Conectar un repositorio

  1. Abra un proyecto y vaya a su página de Settings.
  2. Haga clic en Add Connection.
  3. Seleccione un proveedor (GitHub, GitLab o Bitbucket).
  4. Introduzca la URL del repositorio, un nombre para mostrar y su token de acceso.
  5. Haga clic en Connect. ISO Mate valida el token y detecta las capacidades de lectura/escritura.

Requisitos de token

Cada proveedor utiliza un tipo de token diferente. ISO Mate detecta automáticamente las capacidades de lectura/escritura a partir de los alcances del token.

GitHub

GitHub admite dos tipos de token:

  • Classic Personal Access Token: En GitHub, desde el icono de su perfil, vaya a Settings > Developer settings > Personal access tokens > Tokens (classic). Seleccione el alcance repo para acceso completo (ramas, PRs, commits). Para acceso de solo lectura a repositorios públicos, seleccione public_repo.
  • Fine-grained Personal Access Token: En GitHub, desde el icono de su perfil, vaya a Settings > Developer settings > Personal access tokens > Fine-grained tokens. Seleccione el repositorio de destino, luego establezca Contents en Read and write y Pull requests en Read and write para acceso completo. Para solo lectura, establezca Contents en Read-only.

GitLab

GitLab admite Personal Access Tokens y Project Access Tokens:

  • Personal Access Token: Vaya a User Settings > Access > Personal Access Tokens. Seleccione el alcance api para acceso completo. Para solo lectura, seleccione read_api y read_repository.
  • Project Access Token: Vaya a Project > Settings > Access Tokens. Seleccione el alcance api y asigne al menos el rol Developer para acceso de escritura.

Bitbucket

Los Repository Access Tokens de Bitbucket son la opción recomendada (los App Passwords están obsoletos desde septiembre de 2025):

  • Repository Access Token: Vaya a Repository Settings > Security > Access Tokens. Seleccione el alcance pullrequest:write para acceso completo (incluye creación de ramas, push y gestión de PRs). Para solo lectura, seleccione el alcance repository.
  • Workspace Access Token: Vaya a Workspace Settings > Security > Access Tokens. Se aplican los mismos alcances, pero el token funciona en todos los repositorios del workspace.

Ver actividad Git

Una vez conectado un repositorio, ISO Mate sincroniza ramas, commits y pull requests cada 15 minutos. Busca claves de issue (por ejemplo, PROJ-42) en nombres de ramas, mensajes de commit y títulos de PR para vincular la actividad a los issues correspondientes.

Abra cualquier issue y desplácese hasta la sección Git Activity para ver las ramas, commits y pull requests vinculados, agrupados por repositorio. Cada elemento enlaza a la interfaz web del proveedor.

Crear ramas y pull requests

Desde la página de detalle del issue, haga clic en Create Branch para crear una nueva rama en uno o todos los repositorios conectados. El nombre de la rama se completa automáticamente con la clave del issue y el resumen. Haga clic en Create MR/PR para abrir un pull request en borrador con la clave del issue en el título.

Los pull requests se pueden marcar como borradores usando la casilla de verificación en el diálogo. Para GitLab, el prefijo “Draft:” se agrega automáticamente al título. Para GitHub, se establece la marca nativa de borrador. Active o desactive la casilla para agregar o eliminar el prefijo de borrador del título.

Estas acciones requieren acceso de escritura en el token del repositorio. Si una conexión tiene acceso de solo lectura, los botones estarán deshabilitados con un tooltip que explica el requisito.

Gestionar ramas y pull requests vinculados

Cada rama y pull request en la sección Git Activity tiene un menú de acciones (icono de tres puntos) con las siguientes opciones:

  • Unlink Branch: Elimina el vínculo entre la rama y el issue. La rama permanece en el repositorio.
  • Delete Branch: Elimina permanentemente la rama del repositorio remoto y elimina todos los registros locales. Solo disponible cuando la conexión tiene acceso de escritura. Se muestra un diálogo de confirmación antes de proceder.
  • Unlink Pull Request: Elimina el vínculo entre el pull request y el issue. El pull request permanece abierto en el proveedor.
  • Close Pull Request: Cierra el pull request en el repositorio remoto y actualiza el estado local. Solo disponible para pull requests abiertos. Se muestra un diálogo de confirmación antes de proceder.

Gestionar conexiones

En la página de configuración del proyecto, cada conexión muestra su estado (Active, Error o Syncing) y nivel de capacidad (Read Only o Read & Write). Puede editar una conexión para actualizar su token, revalidar una conexión en estado de error o eliminar una conexión por completo.

Funcionalidad

War dieser Artikel hilfreich?