Conéctate a Bitbucket Data Center

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

Estas instrucciones están dirigidas a desarrolladores de aplicaciones, administradores de plataformas y administradores de seguridad que deseen usar repositorios de código fuente de Bitbucket Data Center con Google. Específicamente, puedes usar repositorios de Bitbucket Data Center con Gemini Code Assist.

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

Antes de comenzar

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

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

  3. 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.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 APIs

  4. Asegúrate de tener acceso a una cuenta en el centro de datos de Bitbucket.

    Para ayudar a mantener seguro 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.

  5. Asegúrate de tener un repositorio de Bitbucket Data Center o de tener permisos de nivel de administrador en un repositorio compartido.
  6. Opcional: Crea una clave de encriptación administrada por el cliente (CMEK) para encriptar los secretos de autenticación que crea Developer Connect.
  7. Para usar las instrucciones de la línea de comandos de esta guía, completa los siguientes pasos (opcional):
    1. Instala la Google Cloud CLI. Si ya instalaste gcloud CLI, ejecuta gcloud components update para asegurarte de tener la última versión disponible.
    2. 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
              

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 Data Center, completa los siguientes pasos:

  1. Accede a Bitbucket Data Center.

  2. Sigue las instrucciones de la documentación de Bitbucket Data Center para crear dos tokens de acceso HTTP y otorgar los siguientes permisos.

    Developer Connect admite tokens de acceso de usuario, proyecto y repositorio.

    • Crea un token con el permiso repository admin. En Developer Connect, este token se llama token de acceso de administrador.
    • Crea un token con el permiso repository read. En Developer Connect, este token se denomina token de acceso de lectura.

    Eres responsable de administrar la duración de los tokens de Bitbucket Data Center en Bitbucket Data Center. Para ayudar a proteger tu código fuente, puedes establecer una fecha de vencimiento durante la creación del token. Si no estableces una fecha de vencimiento, el token seguirá siendo válido hasta que lo revoques en Bitbucket Data Center.

  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 Data Center. 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 nueva conexión de Bitbucket Data Center, 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 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 Bitbucket Data Center.
    • Si ves una tabla con las conexiones existentes, configura el proveedor de administración de código fuente haciendo clic en Crear conexión > Bitbucket Data Center.

      Se abrirá la página Crear conexión.

  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 URL del host, ingresa la URL del host del centro de datos de Bitbucket al que deseas conectarte.

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

    • Token de acceso de administrador: Ingresa el token con el acceso al permiso de administrador del repositorio.

    • Token de acceso de lectura: Ingresa el token con el acceso al permiso de lectura del repositorio.

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

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

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

  6. Haz clic en el botón Continuar. Developer Connect crea tu conexión. Este proceso puede tardar unos segundos.

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:

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

  2. Haz clic en Aceptar.

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

  1. Ejecuta el siguiente comando para crear un secreto de webhook en Secret Manager, en el que 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 en Secret Manager:

    gcloud secrets create ADMIN_SECRET_NAME
    
    echo -n ADMIN_SECRET_DATA | gcloud secrets versions add ADMIN_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:

    • ADMIN_SECRET_NAME: Es un nombre para el secreto que almacena tu token de acceso de administrador.
    • ADMIN_SECRET_DATA: Es tu token de acceso de administrador.
    • READ_SECRET_NAME: Es un nombre para el Secret que 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 Data Center:

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

    Reemplaza lo siguiente:

    • CONNECTION_NAME: Es un nombre para tu conexión.
    • REGION: Es la región que se usará para la conexión.
    • HOST_URI: Es el URI de tu host de Bitbucket Data Center, incluido el prefijo https://.
    • PROJECT_ID: Es el ID del proyecto de Google Cloud.
    • ADMIN_SECRET_NAME: Es el nombre del secreto de Secret Manager que contiene tu token de acceso de administrador.
    • READ_SECRET_NAME: Es el nombre del secreto de Secret Manager que contiene tu token de acceso de lectura.
    • 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 Data Center.

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

Una vez que hayas establecido una conexión con Bitbucket Data Center, podrás vincularte 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 existente de Bitbucket Data Center, 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 tus recursos de repositorio.

  6. 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.
  7. Haz clic en Crear.

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

gcloud

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

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 el vínculo nuevo entre Developer Connect y tu repositorio de Bitbucket Data Center.
  • REPO_URI: Es la URL de tu repositorio en Bitbucket Data Center, incluidos el prefijo https:// y el sufijo .git.
  • CONNECTION_NAME: Es el nombre de tu conexión a Bitbucket Data Center.
  • 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 Configura y usa la personalización de código de Gemini Code Assist.

¿Qué sigue?