Conectar ao Bitbucket Cloud

Esta página descreve como criar conexões com o Bitbucket Cloud e links para repositórios do Bitbucket Cloud. Você pode concluir essas tarefas usando o Google Cloud console, ou a Google Cloud CLI.

Estas instruções são destinadas a desenvolvedores de aplicativos, administradores de plataformas e gerentes de segurança que querem usar repositórios de código-fonte do Bitbucket Cloud com o Google. Especificamente, você pode usar repositórios do Bitbucket Cloud com Gemini Code Assist.

Para saber mais sobre o Developer Connect, consulte Visão geral do Developer Connect.

Antes de começar

Faça login na sua Conta do Google.

Se você ainda não tiver uma, inscreva-se agora.

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

A ativação do Developer Connect também ativa a API Secret Manager.

1. Verifique se você tem acesso a uma conta no Bitbucket Cloud.

   Para ajudar a manter o trabalho da sua equipe seguro, recomendamos que você conclua as tarefas neste guia usando uma conta de bot ou uma conta compartilhada pela equipe, e não uma conta pessoal.

2. Verifique se você é proprietário de um repositório do Bitbucket Cloud ou se tem permissões de administrador em um repositório compartilhado.
3. Opcional: crie uma chave de criptografia gerenciada pelo cliente (CMEK) para criptografar os secrets de autenticação criados pelo Developer Connect.
4. Opcional: para usar as instruções de linha de comando neste guia, siga estas etapas:
   1. Instale a Google Cloud CLI. Se você já instalou a CLI gcloud, verifique se tem a versão mais recente disponível executando gcloud components update.
   2. Crie uma conta de serviço do Developer Connect executando o seguinte comando, em que PROJECT_ID é o Google Cloud ID do projeto:

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

Funções exigidas

Para conseguir as permissões necessárias para criar conexões e links, peça ao administrador para conceder a você os papéis do IAM a seguir:

• Se você não for o proprietário do projeto: administrador do Developer Connect (roles/developerconnect.admin) na sua conta de usuário.
• Se você planeja usar uma CMEK para criptografar os secrets criados pelo Developer Connect: criptografador/descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) na conta de serviço do Secret Manager.
• Se você planeja usar a CLI gcloud para concluir as etapas neste guia: papel de administrador do Secret Manager (roles/secretmanager.admin) na conta de serviço do Developer Connect.
• Se você planeja usar o Google Cloud console para concluir as etapas neste guia: administrador de IAM do projeto (roles/resourcemanager.projectIamAdmin) na sua conta de usuário.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Criar tokens de acesso

Siga estas etapas para criar tokens de acesso pessoal no Bitbucket Cloud:

1. Faça login no Bitbucket Cloud.

2. Siga estas etapas para criar dois tokens de acesso no Bitbucket Cloud. Eles podem ser tokens de acesso ao repositório, tokens de acesso ao projeto, ou