Estas instrucciones están dirigidas a desarrolladores de aplicaciones, administradores de plataformas y administradores de seguridad que quieran usar repositorios de código fuente de GitLab con Google. En particular, puedes usar repositorios de GitLab con Gemini Code Assist.
Para obtener más información sobre Developer Connect, consulta Descripción general de Developer Connect.
Antes de comenzar
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Developer Connect, Secret Manager APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.-
Asegúrate de tener acceso a una cuenta en GitLab.
Para ayudar a mantener seguro 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 una cuenta personal.
- Asegúrate de tener un repositorio de GitLab o de tener permisos de nivel de administrador en un repositorio compartido.
- Opcional: Crea una clave de encriptación administrada por el cliente (CMEK) para encriptar los secretos de autenticación que crea Developer Connect.
- Para usar las instrucciones de la línea de comandos de esta guía, completa los
siguientes pasos (opcional):
- Instala la Google Cloud CLI. Si
ya instalaste gcloud CLI, ejecuta
gcloud components updatepara asegurarte de tener la última versión disponible. - Crea una cuenta de servicio de Developer Connect
ejecutando el siguiente comando, en el que PROJECT_ID es el ID del proyecto deGoogle Cloud :
gcloud beta services identity create \ --service=developerconnect.googleapis.com \ --project=PROJECT_ID
- Instala la Google Cloud CLI. Si
ya instalaste gcloud CLI, ejecuta
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:
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:
Encriptador/desencriptador de CryptoKey de Cloud KMS (
roles/cloudkms.cryptoKeyEncrypterDecrypter) en la cuenta de servicio de Secret Manager. -
Si planeas usar gcloud CLI para completar los pasos de esta guía:
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:
Administrador de IAM del proyecto (
roles/resourcemanager.projectIamAdmin) en tu cuenta de usuario.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Crea tokens de acceso
Para crear tokens de acceso en GitLab, completa los siguientes pasos:
Sigue las instrucciones de la documentación de GitLab para crear tokens de acceso personal, tokens de acceso de grupo o tokens de acceso de proyecto con los siguientes permisos:
- Un token con permiso de
apipara conectar y desconectar repositorios. - Un token con permiso
read_apipara permitir que Developer Connect lea el código fuente en tus repositorios. - En el caso de los tokens de acceso de grupo y de proyecto, los tokens deben tener un rol de encargado de mantenimiento o superior.
- Un token con permiso de
Crear una conexión
En esta sección, se describe cómo crear una conexión entre Developer Connect y GitLab. Si usas la consola de Google Cloud , también puedes comenzar a agregar vínculos a repositorios cuando termines de configurar la conexión.
Para crear una conexión de GitLab nueva, selecciona una de las siguientes opciones:
Console
Para iniciar una conexión, completa los siguientes pasos:
En la consola de Google Cloud , abre Developer Connect.
Developer Connect muestra la página Repositorios de Git.
- Si ves una lista de proveedores de administración de código fuente, selecciona uno para comenzar a configurar tu primera conexión. Haz clic en Conectar en la tarjeta de GitLab.
Si ves una tabla con las conexiones existentes, configura el proveedor de administración de código fuente haciendo clic en Crear conexión > GitLab.
Se abrirá la página Crear conexión.
En Región, elige una región para tus recursos de conexión.
- En Nombre, ingresa un nombre para la conexión nueva.
En la sección Tokens de acceso, ingresa los tokens de tu cuenta:
- Token de acceso a la API: Ingresa el token de acceso con el permiso
api. - Token de acceso a la API de lectura: Ingresa el token de acceso con el permiso
read_api.
Eres responsable de garantizar que tus tokens de GitLab sigan siendo válidos. Los tokens de GitLab tienen una vida útil máxima de 365 días, a menos que el creador del token o un administrador especifiquen lo contrario. Para aprender a administrar la configuración de vencimiento de los tokens y las notificaciones, consulta la documentación de GitLab sobre tokens de acceso personal, tokens de acceso de grupo y tokens de acceso de proyecto.
- Token de acceso a la API: Ingresa el token de acceso con el permiso
Haz clic en Mostrar más para ver los parámetros de configuración opcionales.
Opcional: En la sección Encriptación, selecciona una clave de CMEK para encriptar los secretos de Secret Manager que crea Developer Connect.
Opcional: De forma predeterminada, Developer Connect puede actuar como un proxy para las llamadas de Git a GitLab. Para inhabilitar esta opción, desmarca la casilla de verificación Habilitar el proxy de Developer Connect.
Haz clic en Continuar.
Una vez que se cree la conexión, aparecerá la página Vincular repositorios.
Completa los siguientes pasos para vincular repositorios a tu conexión:
En la lista de repositorios disponibles, selecciona los que quieres usar.
Haz clic en Aceptar.
Haz clic en Vincular.
Tu conexión se agrega a la página Conexiones y los vínculos de tu repositorio se agregan a la página Repositorios en la consola de Google Cloud . Puedes agregar más vínculos a las conexiones existentes en cualquier momento.
Si estás configurando Gemini Code Assist, continúa el proceso siguiendo los pasos que se indican en Configura y usa la personalización de código de Gemini Code Assist.
gcloud
Ejecuta el siguiente comando para crear un secreto de webhook en Secret Manager, en el que WEBHOOK_SECRET_NAME es un nombre para el secreto de webhook:
cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAMEAlmacena tus tokens de acceso en Secret Manager ejecutando los siguientes comandos:
gcloud secrets create API_SECRET_NAME echo -n API_SECRET_DATA | gcloud secrets versions add API_SECRET_NAME --data-file=- gcloud secrets create READ_SECRET_NAME echo -n READ_SECRET_DATA | gcloud secrets versions add READ_SECRET_NAME --data-file=-Reemplaza lo siguiente:
- API_SECRET_NAME: Es un nombre para el Secret que almacena
el token con el permiso
api. - API_SECRET_DATA: Es el token con el permiso
api, similar aglpat-XXXXXXXXXXXXXXXX. - READ_SECRET_NAME: Es un nombre para el Secret que almacena
el token con el permiso
read_api. - READ_SECRET_DATA: Es el token con el permiso
read_api, similar aglpat-XXXXXXXXXXXXXXXX.
- API_SECRET_NAME: Es un nombre para el Secret que almacena
el token con el permiso
Inicia una conexión a tu cuenta de GitLab ejecutando el comando
developer-connect connections create:gcloud developer-connect connections create CONNECTION_NAME \ --location=REGION \ --gitlab-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/API_SECRET_NAME/versions/VERSION \ --gitlab-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \ --gitlab-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION \ --git-proxy-config-enabledReemplaza lo siguiente:
- CONNECTION_NAME: Es un nombre para tu conexión.
- REGION: Es la región de tu conexión.
- PROJECT_NAME: Es el ID del proyecto de Google Cloud.
- API_SECRET_NAME: Es el nombre del
secreto de Secret Manager que contiene el token
con el permiso
api. - READ_SECRET_NAME: Es el nombre del
secreto de Secret Manager que contiene el token
con el permiso
read_api. - WEBHOOK_SECRET_NAME: Es el nombre del secreto de Secret Manager que contiene tu secreto de webhook.
- VERSION: Es el número de versión de cada secreto. Puede ser
latestpara usar el número de versión más reciente. --git-proxy-config-enabled: Es una marca opcional que permite que Developer Connect actúe como proxy para las llamadas de Git a GitLab.
Developer Connect completa la conexión a GitLab. A continuación, vincula a los repositorios.
Vincula repositorios con una conexión existente
Una vez que hayas establecido una conexión con GitLab, podrás vincularla a los repositorios. Puedes repetir estos pasos más adelante para vincular repositorios adicionales según sea necesario.
Para crear vínculos de repositorio en una conexión de GitLab existente, selecciona una de las siguientes opciones:
Console
Para crear vínculos a repositorios, completa los siguientes pasos:
Abre la página Repositorios en la consola de Google Cloud .
Haz clic en Vincular repositorio.
Se abrirá el panel Vincular repositorios de Git.
En la lista de conexiones, elige una.
Haz clic en Continuar.
En la lista de repositorios, selecciona los que deseas vincular.
Developer Connect muestra nombres sugeridos para tus recursos de repositorio.
Selecciona una opción de asignación de nombres para el recurso del repositorio:
- Generados: Usa los nombres de recursos del repositorio generados.
- Manual: Ingresa tus propios nombres.
Haz clic en Crear.
Developer Connect crea los vínculos del repositorio y los muestra en la consola de Google Cloud .
gcloud
Vincula un repositorio de GitLab ejecutando el siguiente comando:
gcloud developer-connect connections git-repository-links create REPO_NAME \
--clone-uri=REPO_URI \
--connection=CONNECTION_NAME \
--location=REGION
Reemplaza lo siguiente:
- REPO_NAME: Es el nombre del vínculo del repositorio.
- REPO_URI: Es el vínculo a tu repositorio, similar
a
https://gitlab.com/my-project/test-repo.git. - CONNECTION_NAME: Es el nombre de tu conexión.
- REGION: Es la región de tu conexión.
Developer Connect crea los vínculos del repositorio.
Para enumerar los repositorios vinculados, ejecuta el
comando developer-connect connections git-repository-links list.
Si estás configurando Gemini Code Assist, continúa el proceso siguiendo los pasos que se indican en Configura y usa la personalización de código de Gemini Code Assist.