Conéctate a GitLab Enterprise

En esta página, se describe cómo crear conexiones a GitLab Enterprise y vínculos a repositorios de GitLab Enterprise. Puedes completar estas tareas con la consola de Google Cloud o Google Cloud CLI.

Estas instrucciones son para desarrolladores de aplicaciones, administradores de plataformas y administradores de seguridad que deseen usar repositorios de código fuente de GitLab Enterprise con Google. Específicamente, puedes usar repositorios de GitLab Enterprise con Gemini Code Assist.

Para obtener más información sobre Developer Connect, consulta la descripción general de Developer Connect.

Antes de comenzar

Accede a tu Cuenta de Google.

Si todavía no tienes una cuenta, regístrate para obtener una nueva.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

Habilitar Developer Connect también habilita la API de Secret Manager.

1. Asegúrate de tener acceso a una cuenta en GitLab Enterprise.

   Para proteger el trabajo de tu equipo, te recomendamos que completes las tareas de esta guía con una cuenta de servicio o una cuenta compartida por tu equipo, no con una cuenta personal.

2. Asegúrate de ser propietario de un repositorio de GitLab Enterprise o de tener permisos de nivel de administrador en un repositorio compartido.
3. Opcional: Crea una clave de encriptación administrada por el cliente (CMEK) para encriptar los secretos de autenticación que crea Developer Connect.
4. Opcional: Para usar las instrucciones de línea de comandos de esta guía, completa los siguientes pasos:
   1. Instala la Google Cloud CLI. Si ya instalaste gcloud CLI, asegúrate de tener la versión más reciente disponible ejecutando gcloud components update.
   2. Crea una cuenta de servicio de Developer Connect ejecutando el siguiente comando, en el que PROJECT_ID es tu Google Cloud ID del proyecto:

              gcloud beta services identity create \
                  --service=developerconnect.googleapis.com \
                  --project=PROJECT_ID
              

Requisitos del host

Si no instalaste una instancia de GitLab Enterprise Edition Server, consulta la guía de instalación de GitLab Enterprise Edition para obtener instrucciones.

Cuando sigas las instrucciones para instalar una instancia de GitLab Enterprise Edition Server, ten en cuenta lo siguiente:

• Debes configurar tu host para que controle el protocolo HTTPS. No se admiten los hosts configurados con el protocolo HTTP.

• Debes configurar tu host con la misma URL que se usa para acceder a él desde Google Cloud. Para obtener más información, consulta la documentación de GitLab para configurar la URL externa.

Roles obligatorios

Para obtener los permisos que necesitas para crear conexiones y vínculos, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Si no eres el propietario del proyecto, debes tener el rol de administrador de Developer Connect (roles/developerconnect.admin) en tu cuenta de usuario.
• Si planeas usar una CMEK para encriptar los secretos que crea Developer Connect, otorga el rol Encriptador/Desencriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) a la cuenta de servicio de Secret Manager.
• Si planeas usar gcloud CLI para completar los pasos de esta guía, necesitas el rol de administrador de Secret Manager (roles/secretmanager.admin) en la cuenta de servicio de Developer Connect.
• Si planeas usar la consola de Google Cloud para completar los pasos de esta guía, debes tener el rol de administrador de IAM del proyecto (