Configuración de GitLab

Continuous Delivery dejará de funcionar en las siguientes regiones el 10 de abril de 2026: eu-es y jp-osa. Esta interrupción también se aplica a cualquier función proporcionada dentro del servicio, incluidos Code Risk Analyzer y DevOps Insights. Más información

Continuous Delivery dejará de utilizarse en las siguientes regiones el 12 de febrero de 2027: au-syd, ca-mon, ca-tor, us-east. Code Risk Analyzer y DevOps Insights también quedarán obsoletos en todas las regiones en esa fecha. Sin embargo, si una región no tiene un uso activo de estas funciones, es posible que las funciones de esa región se suspendan antes y dejen de aceptar nuevas instancias. Más información

GitLab es un servicio de alojamiento basado en web para repositorios Git. Puede tener copias locales y remotas de sus repositorios, lo que facilita la colaboración.

Puede configurar GitLab como una integración de herramientas de la cadena de herramientas para que pueda gestionar el código fuente en un repositorio nuevo o existente en GitLab.com o en la instancia GitLab de su empresa. Participe en la codificación social mediante wikis, seguimiento de problemas y solicitudes de fusión.

Si configura la integración de esta herramienta mientras crea la cadena de herramientas, siga estos pasos:

Si está almacenando el código fuente en un repositorio GitLab, en la sección Integraciones configurables, pulse GitLab. Si está configurando esta integración de herramientas en IBM Cloud Public, debe autorizar a IBM Cloud a acceder a GitLab eligiendo entre OAuth o Token de acceso personal.
- Si elige OAuth, haga clic en Autorizar para ir al sitio web GitLab. Si no tiene ninguna sesión de GitLab activa, se le solicitará que inicie sesión. Pulse Autorizar aplicación para permitir que IBM Cloud acceda a su cuenta de GitLab. Si tiene una sesión de GitLab activa pero no ha especificado la contraseña recientemente, es posible que se le solicite que especifique su contraseña de GitLab para confirmar.
- Si elige Señal de acceso personal, debe especificar la señal de acceso personal que se utilizará para autorizar con GitLab la clonación de repositorios y realizar otras acciones en su nombre. Si no tiene una señal de acceso personal, puede seguir la documentación del sitio web de GitLab para crear una. Asegúrese de que la señal de acceso personal tenga derechos api.
Si está utilizando un repositorio en su propio servidor de GitLab, en la sección Integraciones configurables, pulse Añadir servidor personalizado.

a. Escriba un título para su servidor GitHub personalizado, especifique la raíz URL del servidor e introduzca su token de acceso personal.

b. Si no tiene una señal de acceso personal, puede seguir la documentación del sitio web de GitLab para crear una.

c. Si su servidor GitHub está bloqueado o no es accesible desde Internet, puede conectar e integrar un Delivery Pipeline Private Worker para ejecutarlo en su propia infraestructura Kubernetes y acceder a recursos internos o locales. Para obtener más información sobre Delivery Pipeline Trabajadores privados, consulte Trabajar con Delivery Pipeline Trabajadores privados.
Revise las ubicaciones de repositorio de destino predeterminadas para los repositorios de GitLab. Dichos repositorios se clonan a partir del repositorio de ejemplo. Si es necesario, cambie el nombre de los repositorios de destino.

Si tiene una cadena de herramientas y le está añadiendo esta integración de herramientas, siga estos pasos:

Desde la IBM Cloud consola, haga clic en el del menú hamburguesa > Automatización de plataformas > Cadenas de herramientas. En la página Cadenas de herramientas, pulse la cadena de herramientas para abrir su página Visión general.
Pulse Añadir herramienta.
En la sección Integraciones de herramientas, pulse GitLab.
Pulse el servidor de GitLab que desee utilizar.
Si tiene un repositorio de GitLab y desea utilizarlo, para el tipo de repositorio, pulse Existente y escriba el URL.
Si desea utilizar un repositorio de GitLab nuevo, escriba un nombre para el repositorio, escriba el URL para el repositorio que esté clonando o bifurcando, y seleccione el tipo de repositorio:

a. Para crear un repositorio vacío, pulse Nuevo.

b. Para crear una copia de un repositorio de GitLab, pulse Clonar.

c. Para bifurcar un repositorio de GitLab para que pueda aportar cambios a través de solicitudes de fusión, pulse Bifurcar.
Si desea crear un repositorio público en el servidor, desmarque el recuadro de selección Convertir este repositorio en privado.
Si desea utilizar los problemas de GitLab para el seguimiento de problemas, marque el recuadro de selección Habilitar problemas de GitLab.
Si desea realizar un seguimiento del despliegue de cambios en el código mediante la creación de etiquetas y comentarios en las confirmaciones, y etiquetas y comentarios en los problemas a los que hacen referencia las confirmaciones, marque el recuadro de selección Hacer un seguimiento del despliegue cambios de código.
Pulse Crear integración.
En la página Visión general de la cadena de herramientas, en la tarjeta Repositorios, pulse el repositorio de GitLab con el que desee trabajar. En función del repositorio que haya seleccionado, ya sea que se abra el sitio web de GitLab o el repositorio de GitLab de la empresa, donde pueda visualizar el contenido del repositorio.
Si ha habilitado Problemas de GitLab, pulse Problemas de GitLab para abrirla. Puede utilizar esta instancia de Problemas de GitLab para toda la cadena de herramientas, incluso si la cadena de herramientas contiene varios repositorios de GitLab.

Si no tiene privilegios de propietario o maestro para el repositorio al que está enlazando, la integración estará limitada porque no puede utilizar un webhook. Los webhooks se necesitan para ejecutar automáticamente un conducto cuando se envía una confirmación al repositorio. Sin un webhook, debe iniciar los conductos manualmente.

Configuración de GitLab mediante la API

La integración de GitLab herramientas admite los siguientes parámetros de configuración que puede utilizar con la API y los HTTP SDK de Toolchain al crear, leer y actualizar integraciones de herramientas.

Debe especificar la propiedad tool_type_id en el cuerpo de la solicitud con el valor gitlab.

Parámetros de integración de la herramientaGitLab
Parámetro	Uso	Tipo	Argumento de Terraform	Descripción
url_raíz_api	opcional, actualizable	Serie	url_raíz_api	La página URL de la API GitLab.
señal_api	opcional, actualizable	Contraseña	señal_api	El Token de Acceso Personal (PAT). Este parámetro sólo es necesario si `auth_type` se establece en `pat`, de lo contrario se ignora.
auth_type	opcional, actualizable, `Default: oauth`	Serie	auth_type	Establezca el método de autenticación que se utilizará para acceder al proveedor Git.
conexión_ciega	opcional, actualizable, `Default: false`	Boolean	conexión_ciega	Establezca este valor en true para indicar que el servidor no es direccionable en la Internet pública porque IBM Cloud no puede validar los detalles de conexión que usted proporciona. Algunas funciones que requieren acceso API al servidor Git se desactivarán. Delivery Pipeline sólo funciona utilizando un trabajador privado que tenga acceso de red al servidor Git.
rama_predeterminada	opcional, actualizable	Serie	rama_predeterminada	El nombre de la rama predeterminada del repositorio Git.
enable_traceability	opcional, actualizable, `Default: false`	Boolean	enable_traceability	Establezca este valor en `true` para realizar un seguimiento del despliegue de los cambios de código mediante la creación de etiquetas, tags y comentarios en commits, pull requests y cuestiones referenciadas.
id_git	opcional, inmutable	Serie	id_git	Establezca este valor en `gitlab` para gitlab.com, o en el GUID de un servidor GitLab personalizado.
has_issues	opcional, actualizable, `Default: true`	Boolean	problemas_de_cadena_de_herramientas_habilitados	Establezca este valor en `true` para habilitar Problemas en el repositorio GitLab y añadir una tarjeta de integración de la herramienta Problemas a la cadena de herramientas. Establezca este valor en `false` para eliminar la tarjeta de integración de herramientas de la cadena de herramientas. Esta acción no afecta a si los problemas están habilitados en el propio repositorio GitLab.
propietario_integración	opcional, actualizable	Serie	propietario_integración	Seleccione el usuario con el que se realizan las operaciones Git.
owner_id	opcional, inmutable	Serie	owner_id	El usuario o grupo de GitLab que es propietario del repositorio. Este parámetro es necesario al crear un repositorio, o clonar o bifurcar un repositorio. Este valor se calcula cuando se enlaza a un repositorio existente.
repositorio_privado	opcional, inmutable, `Default: true`	Boolean	repositorio_privado	Establezca este valor en `true` para que el repositorio sea privado cuando cree un repositorio, o clone o bifurque un repositorio. Este parámetro no se utiliza cuando se enlaza a un repositorio existente.
id_reposición	opcional, inmutable	Serie	id_reposición	ID del proyecto GitLab.
repo_name	opcional, inmutable	Serie	repo_name	El nombre del repositorio GitLab a crear. Este parámetro es necesario al crear un repositorio, o clonar o bifurcar un repositorio. Este valor se calcula cuando se enlaza a un repositorio existente.
repo_url	opcional, inmutable	Serie	repo_url	El URL del repo GitLab para la integración de esta herramienta. Este parámetro es necesario cuando se enlaza a un repositorio existente. Este valor se calcula al crear un repositorio, o clonar o bifurcar un repositorio.
url_repo_origen	opcional, inmutable	Serie	url_repo_origen	El URL del repositorio que desea bifurcar o clonar. Este parámetro es necesario cuando bifurca o clona un repositorio, pero no se utiliza al crear un repositorio o enlace a un repositorio existente.
url_señal	opcional, actualizable	Serie	url_señal	El token URL que se utiliza para autorizar con el GitLab servidor.
tipo	necesario, inmutable	Serie	tipo	La operación que se debe realizar para inicializar la nueva integración de herramientas. Utilice `new` para crear un repositorio Git, `clone` para clonar un repositorio existente en un nuevo repositorio Git, `fork` para bifurcar un repositorio Git existente o `link` para enlazar a un repositorio Git existente.