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 seja implantado a partir de um dos seus repositórios do Bitbucket Cloud: envie alterações para a ramificação e o site será atualizado.

Antes de começar

Uma conta do Bitbucket Cloud com acesso aos repositórios que você deseja implantar.

1. Crie a chave no Bitbucket

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

• Um token de acesso para um repositório, projeto ou espaço de trabalho, criado nas configurações do próprio repositório, projeto ou espaço de trabalho em Tokens de acesso. Ele está vinculado a esse repositório, projeto ou espaço de trabalho, e não a uma pessoa. Conceda a ele acesso de leitura aos repositórios.
• Um token de API na sua conta da Atlassian. Selecione seu perfil, vá em 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 expiração, escolha Bitbucket como o aplicativo e selecione o acesso de leitura aos repositórios. O Bitbucket exibe o token apenas uma vez; copie-o nesse momento.

2. Conecte-o aqui

Abra Integrações no seu painel e escolha Conectar uma conta. Selecione 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 da Atlassian em vez de um token de acesso, preencha também o Nome de usuário da conta — e pressione Conectar conta.

Testamos o que você cola antes de salvar qualquer coisa. Uma chave que não funciona nunca é armazenada, e a resposta indica o que estava errado com ela. Uma chave que funciona é mantida criptografada no nosso cofre de segredos — nunca no 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, será recusado.

O que acontece a seguir

• Um site pode ser implantado diretamente de um repositório nesta conta: escolha-o na conexão de repositório do site, selecione o repositório e a ramificação, e um envio (push) realiza a implantação.
• Cada uma das outras ramificações pode ter sua própria visualização, para que você possa verificar uma alteração antes que ela chegue ao site ativo.
• Hosts estáticos baseados em Git, como Render e Azure Static Web Apps, usam esta conexão como a origem do código do site.

Se a conexão não for estabelecida

Falta um repositório. Um token de acesso alcança apenas o repositório, projeto ou espaço de trabalho no qual foi criado. Crie um no nível que abrange todos os repositórios de que você precisa.

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

A mensagem diz que a chave foi rejeitada. Quase sempre é uma de três coisas: um espaço ou uma quebra de linha copiada junto com a chave, uma chave que expirou ou uma chave que foi revogada ou regenerada após você copiá-la. Crie uma chave nova e cole-a novamente.

A conexão é estabelecida, mas algo falha posteriormente. A chave 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.

Desconexão

Abra Integrações, localize a conta e pressione Desconectar. Isso exclui a chave armazenada imediatamente. Tudo o que a estava utilizando é interrompido na próxima ação, e as telas que dependiam dela informam isso em vez de falhar silenciosamente.

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