> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> GitLab te ayuda a administrar repositorios, issues, merge requests y canales de CI/CD a través de tu cuenta conectada.

# GitLab

Usa GitLab cuando tu flujo de trabajo necesite leer o cambiar proyectos, issues, merge requests, archivos de repositorio o pipelines. Funciona bien cuando pasos posteriores pueden proporcionar IDs de proyecto, IIDs de issue, nombres de rama, SHAs o IDs de trabajo.

## Configuración

| Option | Required | Description |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta conectada de GitLab que se usará para este paso. |
| Action | Yes | La acción de GitLab que se va a realizar (por ejemplo Get Current User, Get Project, List Projects, Create Project). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta GitLab en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay una conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de Arguments

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las dos pestañas se mantienen sincronizados.

## Acciones comunes

| Action | Description |
| - | - |
| **Get Current User** | Recupera la cuenta de usuario conectada de GitLab. |
| **Get Project** | Recupera un proyecto por ID o ruta. |
| **List Projects** | Enumera los proyectos accesibles para el usuario conectado. |
| **Create Project** | Crea un nuevo proyecto de GitLab. |
| **List Project Issues** | Enumera issues de un proyecto con filtros. |
| **Create Project Issue** | Crea un nuevo issue en un proyecto. |
| **Update Project Issue** | Actualiza un issue existente en un proyecto. |
| **Get MR Approvals** | Recupera el estado de aprobación de un merge request. |
| **Get Merge Request** | Recupera detalles de un merge request. |
| **List Merge Requests** | Enumera merge requests en los proyectos accesibles. |
| **List Pipeline Jobs** | Enumera trabajos en un pipeline. |
| **Get Job Details** | Recupera detalles de un trabajo de CI/CD. |
| **Cancel Job** | Cancela un trabajo de CI/CD en ejecución. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso almacena la respuesta de GitLab como la salida del paso. La estructura de la respuesta depende de la acción.

Usa la referencia de salida completa en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta GitLab si todavía no lo has hecho.
2. Añade un paso de **GitLab** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get Current User** en **Action**.
5. Completa los campos requeridos. Usa **Insert Variable** para referenciar la salida de un paso anterior en cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Casos de uso

### Crear un issue a partir de un formulario

1. Get Current User
2. Get Project
3. Create Project Issue

### Revisar un merge request

1. List Merge Requests
2. Get Merge Request
3. Get MR Approvals

### Actualizar código y ejecutar CI

1. Get Repository File
2. Update Repository File
3. Create Pipeline
4. List Pipeline Jobs

## Notas

* Este paso depende de una integración conectada de GitLab en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta de GitLab pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar marca de autorización de terceros.

## Uso de GitLab como herramienta del agente

También puedes añadir GitLab como una herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **GitLab**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de GitLab cuando son relevantes para la conversación.

Ver también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md) y [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.