Estas instruções são para desenvolvedores de aplicativos, administradores de plataforma e gerentes de segurança que querem usar repositórios de código-fonte do Bitbucket Cloud com o Google. Especificamente, é possível usar repositórios do Bitbucket Cloud com o Gemini Code Assist.
Para saber mais sobre o Developer Connect, consulte Visão geral do Developer Connect.
Antes de começar
-
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.-
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 deste guia usando uma conta de bot ou uma conta compartilhada pela sua equipe, não uma conta pessoal.
- Verifique se você é proprietário de um repositório do Bitbucket Cloud ou se tem permissões de administrador em um repositório compartilhado.
- Opcional: crie uma chave de criptografia gerenciada pelo cliente (CMEK) para criptografar os secrets de autenticação criados pelo Developer Connect.
- Opcional: para usar as instruções de linha de comando deste guia, siga estas etapas:
- Instale a CLI do Google Cloud. Se
você já instalou a CLI gcloud anteriormente, verifique se tem
a versão mais recente disponível executando
gcloud components update. - 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
- Instale a CLI do Google Cloud. Se
você já instalou a CLI gcloud anteriormente, verifique se tem
a versão mais recente disponível executando
Funções exigidas
Para receber as permissões necessárias para criar conexões e links, peça ao administrador para conceder a você os seguintes papéis do IAM:
-
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 deste guia:
Papel de administrador do Secret Manager (
roles/secretmanager.admin) na conta de serviço do Developer Connect. -
Se você planeja usar o console do Google Cloud para concluir as etapas deste guia:
Administrador do 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 papéis personalizados ou outros papéis predefinidos.
Criar tokens de acesso
Crie tokens de acesso pessoal no Bitbucket Cloud seguindo estas etapas:
Siga as etapas abaixo para criar dois tokens de acesso no Bitbucket Cloud. Eles podem ser tokens de acesso ao repositório, tokens de acesso ao projeto ou tokens de acesso ao espaço de trabalho.
Escolha as instruções para o tipo de token de acesso que você vai usar:
Crie o primeiro token com os seguintes escopos:
- Repositórios: leitura.
- Solicitações de pull: leitura.
- Webhooks: leitura e gravação.
No Developer Connect, ele é chamado de token de acesso do autorizador.
Crie o segundo token com o seguinte escopo:
- Repositórios: leitura.
No Developer Connect, ele é chamado de token de acesso de leitura.
Você é responsável por gerenciar a vida útil dos tokens no Bitbucket Cloud. Os tokens do Bitbucket Cloud não têm validade e permanecem válidos até que você os revogue.
Alguns tipos de tokens do Bitbucket são recursos premium disponíveis exclusivamente em planos pagos. Para mais informações, consulte Tokens do Bitbucket Cloud.
Copie os tokens de acesso para usar nos procedimentos a seguir.
Crie uma conexão
Nesta seção, descrevemos como criar uma conexão entre o Developer Connect e o Bitbucket Cloud. Se você estiver usando o console do Google Cloud , também poderá começar a adicionar links a repositórios ao concluir a configuração da conexão.
Para criar uma nova conexão do Bitbucket Cloud, selecione uma das seguintes opções:
Console
Para iniciar uma conexão, siga estas etapas:
No console do Google Cloud , abra o Developer Connect.
O Developer Connect exibe a página Repositórios Git.
- Se você encontrar uma lista de provedores de gerenciamento de código-fonte: comece a configurar sua primeira conexão selecionando um provedor de gerenciamento de código-fonte. Clique em Conectar no card do Bitbucket Cloud.
Se você encontrar uma tabela com as conexões atuais: defina o provedor de gerenciamento de código-fonte clicando em Criar conexão > Bitbucket Cloud.
A página Criar conexão é aberta.
Em Região, escolha uma região para os recursos de conexão.
- Em Nome, insira um nome para a nova conexão.
Em Espaço de trabalho, insira o ID do espaço de trabalho do Bitbucket Cloud.
Na seção Tokens de acesso, insira seus tokens de acesso do Bitbucket Cloud:
- Token de acesso do autorizador: insira seu token de acesso do autorizador.
- Token de acesso de leitura: insira seu token de acesso de leitura.
Clique em Mostrar mais para ver as configurações opcionais.
Opcional: na seção Criptografia, selecione uma chave CMEK para criptografar os secrets do Secret Manager criados pelo Developer Connect.
Opcional: por padrão, o Developer Connect pode atuar como um proxy para chamadas do Git para o Bitbucket Cloud. Para desativar essa opção, desmarque a caixa de seleção Ativar o proxy do Developer Connect.
Para concluir a configuração da conexão, clique no botão Continuar.
O Developer Connect cria sua conexão. Esse processo pode levar alguns segundos.
Depois que a conexão for criada, a página Vincular repositórios vai aparecer.
Siga estas etapas para vincular repositórios à sua conexão:
Na lista de repositórios disponíveis, selecione os que você quer usar.
Clique em OK.
Clique em Vincular.
Sua conexão é adicionada à página Conexões, e os links do repositório são adicionados à página Repositórios no console do Google Cloud . É possível adicionar mais links às conexões atuais a qualquer momento.
Se você estiver configurando o Gemini Code Assist, siga as etapas em Configurar e usar a personalização de código do Gemini Code Assist.
gcloud
Crie um secret de webhook no Secret Manager executando o comando a seguir, em que WEBHOOK_SECRET_NAME é um nome para o secret de webhook:
cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAMEArmazene seus tokens de acesso pessoal no Secret Manager executando os seguintes comandos:
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=-Substitua:
- AUTHORIZER_SECRET_NAME: um nome para o secret em que o Secret Manager armazena o token de acesso do autorizador.
- AUTHORIZER_SECRET_DATA: seu token de acesso do autorizador.
- READ_SECRET_NAME: um nome para o secret em que o Secret Manager armazena seu token de acesso de leitura.
- READ_SECRET_DATA: seu token de acesso de leitura.
Execute o comando
gcloud developer-connect connections createpara criar uma conexão com o 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-enabledSubstitua:
- CONNECTION_NAME: um nome para a conexão.
- REGION: a região a ser usada para a conexão.
- PROJECT_ID: o ID do projeto do Google Cloud.
- AUTHORIZER_SECRET_NAME: o nome do secret do Secret Manager que contém o token de nível de autorizador do Bitbucket Cloud.
- READ_SECRET_NAME: o nome do secret do Secret Manager que contém o token somente leitura do Bitbucket Cloud.
- WEBHOOK_SECRET_NAME: o nome do secret do Secret Manager que contém o secret do webhook.
- VERSION: o número da versão de cada secret. Pode ser
latestpara usar o número da versão mais recente. --git-proxy-config-enabled: uma flag opcional que permite que o Developer Connect atue como um proxy para chamadas do Git para o Bitbucket Cloud.
O Developer Connect conclui a conexão com o Bitbucket Cloud. Em seguida, vincule aos repositórios.
Vincular a repositórios usando uma conexão atual
Depois de estabelecer uma conexão com o Bitbucket Cloud, é possível vincular a repositórios. Repita essas etapas mais tarde para vincular outros repositórios, conforme necessário.
Para criar links de repositório em uma conexão atual do Bitbucket Cloud, selecione uma das seguintes opções:
Console
Para criar links para repositórios, siga estas etapas:
Abra a página Repositórios no console do Google Cloud .
Clique em Vincular repositório.
O painel Vincular repositórios Git é aberto.
Na lista de conexões, escolha uma.
Clique em Continuar.
Na lista de repositórios, selecione os que você quer vincular.
O Developer Connect mostra nomes sugeridos para os recursos do repositório.
Selecione uma opção de nomenclatura de recurso de repositório:
- Gerado: use os nomes de recursos de repositório gerados.
- Manual: insira os nomes que quiser.
Clique em Criar.
O Developer Connect cria os links do repositório e os exibe no console do Google Cloud .
gcloud
Crie um link para o repositório do Bitbucket Cloud executando o seguinte comando:
gcloud developer-connect connections git-repository-links create REPO_NAME \
--clone-uri=REPO_URI \
--connection=CONNECTION_NAME \
--location=REGION
Substitua:
- REPO_NAME: um nome para o novo link entre o Developer Connect e o Bitbucket Cloud Repository.
- REPO_URI: o URL do repositório no Bitbucket Cloud,
incluindo o prefixo
https://e o sufixo.git. - CONNECTION_NAME: o nome da sua conexão com o Bitbucket Cloud.
- REGION: a região da conexão.
O Developer Connect cria os links do repositório.
Para listar repositórios vinculados, execute o comando developer-connect connections git-repository-linkslist.
Se você estiver configurando o Gemini Code Assist, siga as etapas em Configurar e usar a personalização de código do Gemini Code Assist.