Conecte sua conta do Bitbucket para que seus sites sejam implantados a partir de um repositório

O que a conexão faz por você

Conectar o Bitbucket permite que um site faça deploy a partir de um de seus repositórios do Bitbucket Cloud: faça push para a branch e o site se atualiza.

Antes de começar

Uma conta do Bitbucket Cloud com acesso aos repositórios dos quais você deseja fazer deploy.

1. Crie a chave no Bitbucket

O Bitbucket oferece dois tipos de credencial, e qualquer um funciona:

• Um token de acesso para um repositório, projeto ou workspace, criado a partir das próprias configurações desse repositório, projeto ou workspace em Tokens de acesso. Ele é vinculado a esse repositório, projeto ou workspace, e não a uma pessoa. Conceda a ele acesso de leitura aos repositórios.
• Um token de API na sua conta Atlassian. Selecione seu perfil e depois Configurações da conta → Segurança → Criar e gerenciar tokens de API → Criar token de API com escopos. Dê um nome a ele, defina uma validade, escolha o Bitbucket como o aplicativo e selecione acesso de leitura aos repositórios. O Bitbucket exibe o token uma única vez; copie-o nesse momento.

2. Conecte-o aqui

Abra Integrações no seu painel e escolha Conectar uma conta. Escolha Hospedagem de código como o grupo e Bitbucket como a conta, preencha o Token de API — e, se você criou um token na sua conta Atlassian em vez de um token de acesso, também o Nome de usuário da conta, e pressione Conectar conta.

Testamos o que você cola antes de salvar qualquer informação. Uma chave que não funciona nunca é armazenada, e a resposta informa o que estava errado com ela. Uma chave funcional é mantida criptografada em nosso cofre de segredos — nunca em nosso banco de dados — e nunca é exibida novamente, nem mesmo para você.

O nome de usuário determina como enviamos o token, portanto, insira-o apenas para um token de conta. Um token de acesso inserido com um nome de usuário, ou um token de conta sem um, é recusado.

O que acontece a seguir

• Um site pode fazer deploy diretamente de um repositório nesta conta: escolha-a na conexão de repositório do site, selecione o repositório e a branch, e um push realiza o deploy.
• Todas as outras branches podem ter sua própria pré-visualização, para que você possa verificar uma alteração antes que ela chegue ao site de produção.
• Hosts estáticos construídos via Git, como Render e Azure Static Web Apps, usam esta conexão como a origem do código do site.

Se não conectar

Falta um repositório. Um token de acesso alcança apenas o repositório, projeto ou workspace no qual foi criado. Crie um no nível que cubra todos os repositórios necessários.

Funcionou e depois parou. Ambos os tipos de token podem expirar. Crie um novo e conecte-o.

Informa que a chave foi rejeitada. Quase sempre uma de três coisas: um espaço ou uma quebra de linha copiada junto com ela, uma chave expirada ou uma chave que foi revogada ou gerada novamente após você tê-la copiado. Crie uma nova e cole-a novamente.

Conecta, mas algo falha depois. A chave se autentica, mas não possui uma permissão necessária para a ação. Crie uma nova chave com as permissões listadas acima, desconecte a conexão antiga e conecte a nova chave.

Como desconectar

Abra Integrações, localize a conta e pressione Desconectar. Isso exclui a chave armazenada imediatamente. Qualquer item que a utilizava para em sua próxima ação, e as telas que dependiam dela informam isso em vez de falharem silenciosamente.

Desconectar não desfaz o que já foi feito — registros, deploys ou configurações que alteramos em sua conta permanecem como estão. Se você acha que a chave em si pode ter vazado, revogue-a também no fornecedor; desconectar remove a nossa cópia, não a deles.