Conéctate a Bitbucket Cloud

En esta página, se describe cómo crear conexiones a Bitbucket Cloud y vínculos a repositorios de Bitbucket Cloud. 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 desean usar repositorios de código fuente de Bitbucket Cloud con Google. Específicamente, puedes usar repositorios de Bitbucket Cloud con Gemini Code Assist.

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

Antes de comenzar

  1. Accede a tu Cuenta de Google.

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

  2. 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Developer Connect API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. 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

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Developer Connect API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

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

  8. Asegúrate de tener acceso a una cuenta en Bitbucket Cloud.

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

  9. Asegúrate de ser propietario de un repositorio de Bitbucket Cloud o de tener permisos de administrador en un repositorio compartido.
  10. Opcional: Crea una clave de encriptación administrada por el cliente (CMEK) para encriptar los secretos de autenticación que crea Developer Connect.
  11. 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

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:

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 personal en Bitbucket Cloud, completa los siguientes pasos:

  1. Accede a Bitbucket Cloud.

  2. Completa los siguientes pasos para crear dos tokens de acceso en Bitbucket Cloud. Pueden ser tokens de acceso al repositorio, tokens de acceso al proyecto o tokens de acceso al espacio de trabajo.

    1. Elige las instrucciones para el tipo de token de acceso que usarás:

    2. Crea el primer token con los siguientes alcances:

      • Repositorios: lectura
      • Pull Requests: read
      • Webhooks: Lectura y escritura.

      En Developer Connect, se denomina token de acceso del autorizador.

    3. Crea el segundo token con el siguiente alcance:

      • Repositorios: lectura

      En Developer Connect, se denomina token de acceso de lectura.

    Eres responsable de administrar la vida útil de los tokens en Bitbucket Cloud. Los tokens de Bitbucket Cloud no tienen fecha de vencimiento y seguirán siendo válidos hasta que los revoques.

    Algunos tipos de tokens de Bitbucket son funciones premium disponibles exclusivamente en planes pagados. Para obtener más información, consulta Tokens de Bitbucket Cloud.

  3. Copia los tokens de acceso para usarlos en los siguientes procedimientos.

Crear una conexión

En esta sección, se describe cómo crear una conexión entre Developer Connect y Bitbucket Cloud. Si usas la consola de Google Cloud , también puedes comenzar a agregar vínculos a repositorios cuando termines de configurar tu conexión.

Para crear una conexión nueva de Bitbucket Cloud, selecciona una de las siguientes opciones:

Console

Para iniciar una conexión, completa los siguientes pasos:

  1. En la consola de Google Cloud , abre Developer Connect.

    Ir a Developer Connect

    Developer Connect muestra la página Git repositories.

    • Si ves una lista de proveedores de administración de código fuente: Selecciona un proveedor de administración de código fuente para comenzar a configurar tu primera conexión. Haz clic en Conectar en la tarjeta de Bitbucket Cloud.

    • Si ves una tabla con las conexiones existentes: Haz clic en Crear conexión > Bitbucket Cloud para configurar el proveedor de administración de código fuente.

      Se abrirá la página Create Connection.

  2. En Región, elige una región para tus recursos de conexión.

    1. En Nombre, ingresa un nombre para la conexión nueva.

  3. En Workspace, ingresa tu ID del espacio de trabajo de Bitbucket Cloud.

  4. En la sección Tokens de acceso, ingresa tus tokens de acceso de Bitbucket Cloud:

  5. Haz clic en Mostrar más para ver los parámetros de configuración opcionales.

    1. Opcional: En la sección Encriptación, selecciona una clave de CMEK para encriptar los secretos de Secret Manager que crea Developer Connect.

    2. Opcional: De forma predeterminada, Developer Connect puede actuar como proxy para las llamadas de Git a Bitbucket Cloud. Para inhabilitar esta opción, desmarca la casilla de verificación Habilitar el proxy de Developer Connect.

  6. Para terminar de configurar tu conexión, haz clic en el botón Continuar.

    Developer Connect crea tu conexión. Este proceso puede tardar unos segundos.

Una vez que se crea la conexión, aparece la página Vincular repositorios.

Sigue estos pasos para vincular repositorios a tu conexión:

  1. En la lista de repositorios disponibles, selecciona los que deseas usar.

  2. Haz clic en Aceptar.

  3. Haz clic en Vincular.

Tu conexión se agrega a la página Connections y los vínculos a tu repositorio se agregan a la página Repositories 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 Cómo configurar y usar la personalización de código de Gemini Code Assist.

gcloud

  1. Ejecuta el siguiente comando para crear un secreto de webhook en Secret Manager, donde WEBHOOK_SECRET_NAME es un nombre para tu secreto de webhook:

    cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAME

  2. Ejecuta los siguientes comandos para almacenar tus tokens de acceso personal en Secret Manager:

    gcloud secrets create AUTHORIZER_SECRET_NAME

echo -n AUTHORIZER_SECRET_DATA | gcloud secrets versions add AUTHORIZER_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:

    • AUTHORIZER_SECRET_NAME: Es un nombre para el secreto en el que Secret Manager almacena tu token de acceso del autorizador.
    • AUTHORIZER_SECRET_DATA: Es tu token de acceso del autorizador.
    • READ_SECRET_NAME: Es un nombre para el secreto en el que Secret Manager almacena tu token de acceso de lectura.
    • READ_SECRET_DATA: Es tu token de acceso de lectura.

  3. Ejecuta el comando gcloud developer-connect connections create para crear una conexión a Bitbucket Cloud:

    gcloud developer-connect connections create CONNECTION_NAME \
    --location=REGION \
    --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/AUTHORIZER_SECRET_NAME/versions/VERSION \
    --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \
    --bitbucket-cloud-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION
    --git-proxy-config-enabled

    Reemplaza lo siguiente:

    • CONNECTION_NAME: Un nombre para tu conexión
    • REGION: Es la región que se usará para tu conexión.
    • PROJECT_ID: Es el Google Cloud ID del proyecto.
    • AUTHORIZER_SECRET_NAME: Es el nombre del secreto de Secret Manager que contiene tu token a nivel del autorizador de Bitbucket Cloud.
    • READ_SECRET_NAME: Es el nombre del secreto de Secret Manager que contiene tu token de solo lectura de Bitbucket Cloud.
    • 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 latest para 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 Bitbucket Cloud. Esta función se encuentra en vista previa.

    Developer Connect completa la conexión a Bitbucket Cloud. A continuación, vincula los repositorios.

Una vez que establezcas una conexión con Bitbucket Cloud, podrás vincularte a repositorios. Puedes repetir estos pasos más adelante para vincular repositorios adicionales según sea necesario.

Para crear vínculos de repositorios en una conexión existente de Bitbucket Cloud, selecciona una de las siguientes opciones:

Console

Para crear vínculos a repositorios, completa los siguientes pasos:

  1. Abre la página Repositorios en la consola de Google Cloud .

    Abre la página Repositorios

  2. Haz clic en Vincular repositorio.

    Se abrirá el panel Vincular repositorios de Git.

  3. En la lista de conexiones, elige una.

  4. Haz clic en Continuar.

  5. En la lista de repositorios, selecciona los que deseas vincular.

    Developer Connect muestra nombres sugeridos para los recursos de tu repositorio.

  6. Selecciona una opción de nomenclatura de recursos del repositorio:

    • Generados: Usa los nombres de recursos del repositorio generados.
    • Manual: Ingresa los nombres que quieras.

  7. Haz clic en Crear.

    Developer Connect crea los vínculos del repositorio y los muestra en la consola Google Cloud .

gcloud

Ejecuta el siguiente comando para crear un vínculo a tu repositorio de Bitbucket Cloud:

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 un nombre para la nueva vinculación entre Developer Connect y tu repositorio de Bitbucket Cloud.
  • REPO_URI: Es la URL de tu repositorio en Bitbucket Cloud, incluidos el prefijo https:// y el sufijo .git.
  • CONNECTION_NAME: Es el nombre de tu conexión a Bitbucket Cloud.
  • 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-linkslist.

Si estás configurando Gemini Code Assist, continúa el proceso siguiendo los pasos que se indican en Cómo configurar y usar la personalización de código de Gemini Code Assist.

¿Qué sigue?