Los proyectos en ISO Mate agrupan incidencias bajo un prefijo de clave compartido y te permiten conectar repositorios de Git para que las ramas, los commits y los pull requests se sigan frente a las incidencias correctas. Gestionas los proyectos desde la página Proyectos del grupo DevOps de la barra lateral izquierda y conectas los repositorios desde la configuración de cada proyecto. Una vez conectado, ISO Mate mantiene la actividad del repositorio sincronizada de forma automática.
Crear un proyecto
- Abre Proyectos: En la barra lateral izquierda, despliega el grupo DevOps y selecciona Proyectos.
- Inicia un proyecto nuevo: Selecciona Nuevo Proyecto.
- Introduce lo esencial: Ponle un nombre al proyecto y una clave de 2 a 10 letras o números en mayúsculas. La clave se fija al crear el proyecto y no se puede cambiar después.
- Define valores predeterminados opcionales: Puedes elegir un responsable del proyecto, un tipo de incidencia predeterminado, un responsable predeterminado y un patrón de nombres de rama predeterminado.
- Crear: Selecciona Crear para guardar. ISO Mate abre la configuración del proyecto para que conectes un repositorio a continuación.
Las incidencias creadas dentro del proyecto toman su clave como prefijo, así que un proyecto con la clave PROJ produce PROJ-1, PROJ-2, etc.
Conectar un repositorio
- Abre la configuración del proyecto: En la lista de Proyectos, abre la configuración de un proyecto con su acción de configuración.
- Agrega una conexión: En la tarjeta Repositorios, selecciona Agregar Conexión.
- Elige un proveedor: Elige GitHub, GitLab o Bitbucket.
- Introduce los datos: Indica la URL del repositorio, un nombre para mostrar y un token de acceso.
- Conectar: Selecciona Conectar. ISO Mate valida el token y detecta si la conexión tiene acceso de Solo Lectura o de Lectura y Escritura.
Tokens de acceso por proveedor
Cada proveedor usa su propio tipo de token, e ISO Mate lee los alcances del token para decidir si la conexión puede escribir. El cuadro de diálogo muestra una guía para el proveedor seleccionado, resumida aquí.
GitHub
Usa un token de acceso personal clásico con el alcance repo, o un token de alcance detallado con Contents y Pull requests ambos en Lectura y escritura. Para acceso de solo lectura, basta con un token con Contents en Lectura.
GitLab
Usa un token de acceso personal o de proyecto con el alcance api para acceso completo, o los alcances read_api y read_repository para acceso de solo lectura.
Bitbucket
Crea un token de acceso de repositorio con el alcance pullrequest:write para acceso completo, que incluye la creación de ramas y pull requests, o el alcance repository para acceso de solo lectura.
Ver la actividad de Git
Una vez conectado un repositorio, ISO Mate sincroniza ramas, commits y pull requests cada 15 minutos y hace coincidir las claves de incidencia, por ejemplo PROJ-42, que aparecen en los nombres de rama, los mensajes de commit y los títulos de pull request para vincular la actividad con la incidencia correcta.
Abre cualquier incidencia y ve a su sección Actividad Git para ver las ramas, los commits y los pull requests vinculados, agrupados por repositorio y cada uno con un enlace al proveedor. También puedes actualizar la sección cuando quieras con su acción de sincronización.
Crear ramas y pull requests
Desde la sección Actividad Git de una incidencia, selecciona Crear Rama para crear una rama en un repositorio conectado, con el nombre de rama rellenado a partir de la incidencia. Selecciona Crear MR/PR para abrir un pull request que lleva la clave de la incidencia en su título.
El cuadro de diálogo del pull request empieza como borrador y añade un prefijo “Draft:” al título. Activa o desactiva la casilla Marcar como borrador para añadir o quitar ese prefijo. Ambas acciones necesitan una conexión con acceso de escritura, así que en una conexión de solo lectura los botones aparecen deshabilitados con una información sobre herramientas que explica el motivo.
Gestionar ramas y pull requests vinculados
Cada rama y pull request de la sección Actividad Git tiene un menú de acciones con las siguientes opciones.
- Desvincular rama: Elimina el vínculo entre la rama y la incidencia. La rama permanece en el repositorio.
- Eliminar rama: Elimina la rama del repositorio remoto tras una confirmación. Solo aparece cuando la conexión tiene acceso de escritura.
- Desvincular Pull Request: Elimina el vínculo entre el pull request y la incidencia. El pull request permanece abierto en el proveedor.
- Cerrar Pull Request: Cierra el pull request en el proveedor tras una confirmación y está disponible para pull requests abiertos.
También puedes copiar el nombre de una rama o un comando de checkout ya preparado desde cada rama para pasar rápidamente a tu flujo de trabajo local.
Gestionar conexiones
En la página de configuración del proyecto, cada conexión muestra su estado (Activa, Error o Sincronizando) y su nivel de capacidad (Solo Lectura o Lectura y Escritura). Puedes editar una conexión para actualizar su token, revalidar una conexión que esté en estado de error o eliminar una conexión por completo.