Configurando o Bitbucket

Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-mon, ca-tor, us-east. O Code Risk Analyzer e o DevOps Insights também serão descontinuados em todas as regiões nessa data. No entanto, se uma região não tiver uso ativo desses recursos, os recursos dessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais

Armazene seu código-fonte em um repositório novo ou existente (repo) em bitbucket.org e participe da codificação social por meio de wikis, rastreamento de problemas e solicitações pull.

Configure o Bitbucket para colaborar no código com sua equipe:

No IBM Cloud console, clique no ícone Menu > Automação da plataforma > Cadeias de ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas na qual você deseja incluir o Bitbucket.

a. Clique em Incluir ferramenta.

b. Na seção Integrações de ferramentas, clique em Bitbucket.

Se você está configurando essa integração de ferramenta no IBM Cloud Public e não autorizou o IBM Cloud a acessar o Bitbucket, clique em Autorizar para acessar o website do Bitbucket. Se você não tiver uma sessão ativa do Bitbucket, será solicitado a efetuar login. Clique em Conceder acesso para permitir que as cadeias de ferramentas do IBM Cloud acessem as partes a seguir de sua conta do Bitbucket:
- ** Leia as informações da conta **. Obtenha informações básicas sobre o usuário para preencher a interface com o usuário.
- ** Leia e modifique os problemas de seus repositórios **. Permita que o Continuous Delivery atualize os problemas para indicar quando o pipeline implementará confirmações que estiverem conectadas a esses problemas.
- Leia as configurações do projeto de sua equipe e leia os repositórios que estão contidos nos projetos da sua equipe. Permita que o Continuous Delivery se integre com os repositórios que são de propriedade de equipes.
- Leia e modifique os seus repositórios e as suas solicitações pull. Permita que o Continuous Delivery envie por push o código de amostra nos repositórios, quando os usuários solicitarem o código.
- ** Administrar seus repositórios **. Permita que o Continuous Delivery crie novos repositórios, quando solicitados pelos usuários.
- ** Leia as informações de associação da equipe **. Permita que o Continuous Delivery mostre uma lista de suas equipes no menu Proprietário que é mostrado quando você cria um novo repositório.
- Leia e modifique os webhooks de seus repositórios. Permita que o pipeline acione as construções quando as confirmações forem enviadas por push para um repositório.
Se você tiver uma sessão do Bitbucket ativa, mas não inseriu sua senha recentemente, poderá ser solicitado a inserir a senha do Bitbucket para confirmar.
Clique no servidor Bitbucket que você deseja usar.
Se você tiver um repositório do Bitbucket que deseja usar, digite a URL para o repositório. Para o tipo de repositório, clique em Existente.
Se você desejar usar um novo repositório do Bitbucket, digite um nome para o repositório, digite a URL para o repositório que você está clonando ou bifurcando e selecione o tipo de repositório:

a. Para criar um repositório vazio, clique em Novo.

b. Para criar uma cópia de um repositório, clique em Clonar.

c. Para bifurcar um repositório para que seja possível contribuir com as mudanças por meio de solicitações pull, clique em Bifurcar.
Para criar um repositório privado no servidor, marque a caixa de seleção Tornar este repositório privado.
Para usar o Bitbucket Issues para rastreamento de problemas, marque a caixa de seleção Ativar o Bitbucket Issues.
Para rastrear a implementação de mudanças de código criando tags e comentários sobre confirmações, além de rótulos e comentários sobre problemas referenciados pelas confirmações, marque a caixa de seleção Rastrear a implementação de mudanças de código.
Clique em Criar integração.
Na sua cadeia de ferramentas, na placa Ferramentas de terceiros, clique na integração de ferramenta Bitbucket para o repositório Bitbucket com o qual deseja trabalhar. O website do Bitbucket é aberto no qual é possível visualizar o conteúdo do repositório.
Se você ativou o Bitbucket Issues, clique em Bitbucket Issues para abri-lo. É possível usar essa instância do Bitbucket Issues para toda a sua cadeia de ferramentas, mesmo se a cadeia de ferramentas contém múltiplos repositórios do Bitbucket.

Se você não tiver privilégios de proprietário ou de mestre para o repositório ao qual está vinculando, sua integração será limitada porque não será possível usar um webhook. Webhooks são necessários para executar automaticamente um pipeline quando uma confirmação é enviada por push para o repositório. Sem um webhook, os pipelines deverão ser iniciados manualmente.

Configuração do Bitbucket usando a API

A integração da ferramenta Bitbucket suporta os seguintes parâmetros de configuração que você pode usar com a API e os SDKs HTTP da Toolchain ao criar, ler e atualizar integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor bitbucketgit.

Parâmetros de integração da ferramenta Bitbucket
Parâmetro	Uso	Tipo	Argumento de Terraform	Descrição
url_raiz_da_api	opcional, atualizável	Sequência	url_raiz_da_api	A API URL do Bitbucket, como `https://api.bitbucket.org`.
ramo padrão	opcional, atualizável	Sequência	ramo padrão	O nome do ramo padrão, por exemplo, `main`.
enable_traceability	opcional, atualizável, `Default: false`	Booleano	enable_traceability	Defina esse valor como `true` para rastrear a implantação de alterações de código criando tags, rótulos e comentários em commits, pull requests e problemas referenciados.
git_id	opcional, imutável	Sequência	git_id	Configure este valor para `bitbucketgit` para bitbucket.org, ou para o GUID de um servidor Bitbucket personalizado.
has_issues	opcional, atualizável, `Default: true`	Booleano	problemas_da_cadeia_de_ferramentas_ativados	Configure este valor para `true` para ativar questões sobre o repo Bitbucket e para adicionar uma placa de ferramentas de Issues à cadeia de ferramentas. Configure este valor para `false` para remover a placa de integração de ferramentas da cadeia de ferramentas. Essa configuração não impacta se Issues estão habilitados na própria reposição Bitbucket.
proprietário_da_integração	opcional, atualizável	Sequência	proprietário_da_integração	O usuário que executa operações Git.
owner_id	opcional, imutável	Sequência	owner_id	O usuário Bitbucket ou grupo que possui o repo. Esse parâmetro é necessário quando você cria um repo, ou clone ou fork um repo. Este valor é computado quando você se liga a um repo existente.
repositório privado	opcional, imutável, `Default: false`	Booleano	repositório privado	Configure este valor para `true` para fazer o repo privado quando você cria um repo, ou quando clone ou fork um repo. Este parâmetro não é usado quando você se liga a um repo existente.
repo_id	opcional, imutável	Sequência	repo_id	O ID da repo Bitbucket.
repo_name	opcional, imutável	Sequência	repo_name	O nome do repositório do Bitbucket a ser criado. Esse parâmetro é necessário quando você cria um repo, ou clone ou fork um repo. Este valor é computado quando você se liga a um repo existente.
repo_url	opcional, imutável	Sequência	repo_url	O repositório Bitbucket URL para esta integração de ferramentas. Este parâmetro é necessário quando você se liga a um repo existente. Esse valor é computado quando você cria um repo, ou clone ou fork um repo.
url_do_repositório_fonte	opcional, imutável	Sequência	url_do_repositório_fonte	O URL repositório que você deseja bifurcar ou clonar. Esse parâmetro é necessário quando você forca ou clone um repo, mas ele não é usado quando você cria um repo ou link para um repo existente.
url_token	opcional, atualizável	Sequência	url_token	O token URL usado para autorizar com o servidor Bitbucket.
tipo	necessário, imutável	Sequência	tipo	A operação para executar para inicializar a nova integração da ferramenta. Use `new` para criar um repo Git, `clone` para clonar um repo existente em um novo repo Git, `fork` para fork um repo Git existente ou `link` para se vincular a um repo Git existente.

Saiba mais sobre o Bitbucket

Para saber mais sobre o Bitbucket, consulte os recursos do Bitbucket Cloud.