En esta página, se explica cómo conectarse al host de GitLab Enterprise Edition a Cloud Build.
Antes de comenzar
-
Enable the Cloud Build and Secret Manager APIs.
Requisitos de host
Si no instalaste una instancia de GitLab Enterprise Edition Server, consulta el vínculo de GitLab Enterprise Edition para obtener instrucciones.
Sigue las instrucciones para instalar un servidor de GitLab Enterprise Edition ten en cuenta lo siguiente:
Debes configurar el host para que controle el protocolo
HTTPS
. Hosts configurados con el protocoloHTTP
no son compatibles.Debes configurar el host con la misma URL que se usa para llegar a él desde Google Cloud. Si quieres obtener más información, consulta la documentación de GitLab para configurar la URL externa.
Permisos de IAM obligatorios
Para conectar tu host de GitLab Enterprise Edition, otorga el rol de administrador de conexión de Cloud Build (roles/cloudbuild.connectionAdmin
) a tu cuenta de usuario.
Para agregar los roles necesarios a tu cuenta de usuario, consulta Configura el acceso a los recursos de Cloud Build. Para obtener más información sobre los roles de IAM asociados con Cloud Build, consulta Roles y permisos de IAM.
Si tu instancia de GitLab Enterprise Edition se aloja en una red privada, consulta Cómo compilar repositorios desde GitLab Enterprise Edition en una red privada para obtener información sobre los roles de IAM adicionales que se requieren antes de la conexión del host.
Cómo conectarse a un host de GitLab Enterprise Edition
Antes de crear una conexión de host para tu instancia de GitLab Enterprise Edition, debes crear tokens de acceso personal en GitLab Enterprise Edition siguiendo los siguientes pasos:
Accede a tu instancia de GitLab Enterprise Edition.
En la página de la edición empresarial de GitLab de tu instancia, haz clic en tu avatar, en la esquina superior derecha.
Haz clic en Editar perfil.
En la barra lateral izquierda, selecciona Tokens de acceso.
Verás la página Tokens de acceso personal.
Crea un token de acceso con el permiso
api
para usarlo en la conexión y desconexión de repositorios.Crea un token de acceso con el permiso
read_api
para asegurarte de que los repositorios de Cloud Build puedan acceder al código fuente en los repositorios.
Console
Para conectar tu host de GitLab Enterprise Edition a Cloud Build, sigue estos pasos:
Abre la página Repositorios en la consola de Google Cloud.
Verás la página Repositorios.
En la parte superior de la página, selecciona la pestaña 2nd gen.
En el selector de proyectos de la barra superior, selecciona tu proyecto de Google Cloud.
Haz clic en Create host connection para conectar un host nuevo a Cloud Build.
En el panel izquierdo, selecciona GitLab como proveedor de origen.
En la sección Configurar conexión, ingresa la siguiente información:
Región: Selecciona una región para tu conexión.
Nombre: Ingresa un nombre para tu conexión.
En la sección Detalles del host, selecciona o ingresa la siguiente información:
Proveedor de GitLab: Selecciona Self-managed GitLab Enterprise Edition como proveedor.
URL del host: Ingresa la URL del host de tu conexión. Por ejemplo,
https://my-gle-server.net
Certificado de CA: Haz clic en Explorar para subir tu certificado autofirmado.
En Tipo de conexión, selecciona una de las siguientes opciones:
Internet pública: Selecciona esta opción si se puede acceder a tu instancia a través de Internet pública.
Acceso a redes privadas: Selecciona esta opción si tu instancia está alojada en una red privada.
En Servicio del Directorio de servicios, selecciona la ubicación de tu servicio:
- En el proyecto
your-project
- En otro proyecto
- Ingresar manualmente
Si seleccionas En otro proyecto o Ingresar manualmente, ingresa la siguiente información:
Project: Ingresa o selecciona el ID de tu proyecto de Google Cloud en el menú desplegable.
Región: En este campo, se preselecciona la región de tu conexión. La región especificada de tu servicio debe coincidir con la región asociada a tu conexión.
Espacio de nombres: Selecciona el espacio de nombres de tu servicio.
Servicio: Selecciona el nombre del servicio en tu espacio de nombres.
- En el proyecto
En la sección Personal access tokens, ingresa la siguiente información:
Token de acceso a la API: Ingresa el token con el acceso de permiso
api
. Este token se usa para conectar y desconectar repositorios.Token de acceso a la API de lectura: Ingresa el token con el acceso al permiso
read_api
. Los activadores de Cloud Build usan este token para acceder el código en los repositorios.
Haz clic en Conectar.
Después de hacer clic en el botón Conectar, tus tokens de acceso personal se almacenarán de forma segura en Secret Manager. Después de la conexión con el host, Cloud Build también crea un secreto de webhook en tu nombre. Puedes ver y administrar secretos en la página de Secret Manager. Puedes ver y administrar tus secretos en la Secret Manager .
Creaste correctamente una conexión de GitLab Enterprise Edition.
gcloud
Antes de conectar tu host de GitLab Enterprise Edition a Cloud Build, completa los siguientes pasos para almacenar tus credenciales:
Crea un secreto de webhook en Secret Manager con el siguiente comando:
cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create my-gle-webhook-secret --data-file=-
Si almacenas tus secretos en un proyecto de Google Cloud diferente del que planeas usar para crear una conexión de host, ingresa el siguiente comando para otorgarle a tu proyecto acceso al agente de servicio de Cloud Build:
PN=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)") CLOUD_BUILD_SERVICE_AGENT="service-${PN}@gcp-sa-cloudbuild.iam.gserviceaccount.com" gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:${CLOUD_BUILD_SERVICE_AGENT} \ --role="roles/secretmanager.admin"
Aquí:
- PROJECT_ID es tu ID del proyecto de Cloud.
Ahora puedes conectar tu host de GitLab Enterprise Edition a Cloud Build.
Completa los siguientes pasos:
Ingresa el siguiente comando para crear una conexión de GitLab Enterprise Edition:
gcloud builds connections create gitlab CONNECTION_NAME \ --host-uri=HOST_URI \ --project=PROJECT_ID \ --region=REGION \ --authorizer-token-secret-version=projects/PROJECT_ID/secrets/API_TOKEN/versions/SECRET_VERSION \ --read-authorizer-token-secret-version=projects/PROJECT_ID/secrets/READ_TOKEN/versions/SECRET_VERSION \ --webhook-secret-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET/versions/SECRET_VERSION
Aquí:
- CONNECTION_NAME es el nombre de tu conexión.
- HOST_URI es el URI de tu instancia de GitLab Enterprise Edition. Por ejemplo,
https://my-gle-server.net
- PROJECT_ID es tu ID del proyecto de Cloud.
- REGION es la región de tu conexión.
- API_TOKEN es el nombre de tu token con alcance
api
. - READ_TOKEN es el nombre de tu token con el permiso
read_api
. - SECRET_VERSION es la versión de tu secreto.
- WEBHOOK_SECRET es el secreto de tu webhook.
Creaste correctamente una conexión de GitLab Enterprise Edition.
Terraform
Puedes conectar tu host de GitLab Enterprise Edition a Cloud Build. con Terraform.
En el siguiente ejemplo, el fragmento de código hace lo siguiente:
- Configura el proveedor de Google de Terraform
- Crea un secreto para almacenar tu token de acceso personal de GitLab Enterprise Edition.
- Otorga los permisos necesarios al agente de servicio de Cloud Build para acceder a los secretos
Crea una conexión de GitLab Enterprise Edition
// Configure the Terraform Google provider terraform { required_providers { google = {} } } // Create secrets and grant permissions to the Cloud Build service agent resource "google_secret_manager_secret" "api-pat-secret" { project = "PROJECT_ID" secret_id = "GITLAB_PAT_API" replication { auto {} } } resource "google_secret_manager_secret_version" "api-pat-secret-version" { secret = google_secret_manager_secret.api-pat-secret.id secret_data = "GITLAB_API_TOKEN" } resource "google_secret_manager_secret" "read-pat-secret" { project = "PROJECT_ID" secret_id = "GITLAB_PAT_READ" replication { auto {} } } resource "google_secret_manager_secret_version" "read-pat-secret-version" { secret = google_secret_manager_secret.pat-secret.id secret_data = "GITLAB_API_TOKEN" } resource "google_secret_manager_secret" "webhook-secret-secret" { project = "PROJECT_ID" secret_id = "WEBHOOK_SECRET" replication { auto {} } } resource "google_secret_manager_secret_version" "webhook-secret-secret-version" { secret = google_secret_manager_secret.webhook-secret-secret.id secret_data = "WEBHOOK_SECRET_VALUE" } data "google_iam_policy" "serviceagent-secretAccessor" { binding { role = "roles/secretmanager.secretAccessor" members = ["serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudbuild.iam.gserviceaccount.com"] } } resource "google_secret_manager_secret_iam_policy" "policy-pak" { project = google_secret_manager_secret.private-key-secret.project secret_id = google_secret_manager_secret.private-key-secret.secret_id policy_data = data.google_iam_policy.serviceagent-secretAccessor.policy_data } resource "google_secret_manager_secret_iam_policy" "policy-rpak" { project = google_secret_manager_secret.webhook-secret-secret.project secret_id = google_secret_manager_secret.webhook-secret-secret.secret_id policy_data = data.google_iam_policy.serviceagent-secretAccessor.policy_data } resource "google_secret_manager_secret_iam_policy" "policy-whs" { project = google_secret_manager_secret.webhook-secret-secret.project secret_id = google_secret_manager_secret.webhook-secret-secret.secret_id policy_data = data.google_iam_policy.serviceagent-secretAccessor.policy_data } // Create the connection and add the repository resource resource "google_cloudbuildv2_connection" "my-connection" { project = "PROJECT_ID" location = "REGION" name = "CONNECTION_NAME" gitlab_config { authorizer_credential { user_token_secret_version = google_secret_manager_secret_version.pat-secret-version.id } read_authorizer_credential { user_token_secret_version = google_secret_manager_secret_version.pat-secret-version.id } webhook_secret_secret_version = google_secret_manager_secret_version.webhook-secret-secret-version.id } depends_on = [ google_secret_manager_secret_iam_policy.policy-pak, google_secret_manager_secret_iam_policy.policy-rpak, google_secret_manager_secret_iam_policy.policy-whs ] }
Aquí:
- PROJECT_ID es tu ID del proyecto de Cloud.
- GITLAB_PAT_API es tu token de acceso personal con acceso a
api
. - GITLAB_API_TOKEN es tu token de acceso personal.
- GITLAB_PAT_READ es tu token de acceso personal con acceso a
read_api
. - WEBHOOK_SECRET es el nombre del secreto que contiene el valor secreto del webhook.
- WEBHOOK_SECRET_VALUE es el valor del secreto de tu webhook.
- REGION es la región de tu conexión.
- CONNECTION_NAME es el nombre de tu conexión de GitLab Enterprise Edition.
- URI es el URI de tu conexión. Por ejemplo,
https://my-gitlab-enterprise-server.net
Creaste correctamente una conexión de GitLab Enterprise Edition.
¿Qué sigue?
- Obtén información para conectar un repositorio de GitLab Enterprise Edition.
- Aprende a compilar e implementar tus cargas de trabajo en Google Cloud con componentes de CI/CD administrados por Google en tu canalización de GitLab. Consulta GitLab en Google Cloud.