Integração com o Bitbucket

Integrar commits, branches e pull requests do Bitbucket com tarefas do ClickUp. Isso permite que você:

  • Veja toda a atividade relacionada a uma tarefa diretamente no ClickUp.

  • Receba opcionalmente notificações do ClickUp quando novos itens de atividade do Bitbucket forem adicionados às tarefas.

  • Anexe automaticamente (ou manualmente) atividades do Bitbucket às tarefas ClickUp.

  • Altere automaticamente os Status com ações do Bitbucket adicionando o ID da tarefa ClickUp aos seus commits usando este formato #{taskID}[status] Por exemplo: #1abc2de[fechada]

Captura de tela de uma notificação de atividade de tarefa do Bitbucket.

O que você vai precisar

Autorize o ClickUp a se conectar ao Bitbucket

Você pode integrar o ClickUp e o Bitbucket.org ou a versão auto-hospedada do Bitbucket. O processo de autorização é diferente dependendo da versão do Bitbucket que você usa.

Opção 1: Autorize uma conta Bitbucket.org

Nota: Apenas administradores do ClickUp podem vincular repositórios aos Espaços da sua Equipe.

  1. Abra a Central de Aplicativos.
  2. Clique em **Bitbucket**.
  3. Clique em Ativar Bitbucket para Equipe.
  4. Clique em + Adicionar Bitbucket.
  5. Selecione No, I use Bitbucket.com e clique em Link Bitbucket.

    Captura de tela do prompt para selecionar o tipo de conta do Bitbucket que você usa.
  6. Se você não estiver logado, será solicitado que faça login na sua conta do Bitbucket.org.

  7. Revise as permissões necessárias e clique em Conceder acesso

Captura de tela da mensagem de permissões para autorizar o ClickUp.

Agora que você autorizou sua conta, prossiga para o próximo passo de vincular repositórios Bitbucket ao seu Espaço de trabalho.

Opção 2: Autorize uma conta Bitbucket auto-hospedada

Se você estiver usando uma versão auto-hospedada do Bitbucket, pode autorizar o ClickUp criando um token de acesso HTTP. Saiba mais sobre os tokens de acesso HTTP do Bitbucket.

  1. Abra a Central de Aplicativos.
  2. Clique em **Bitbucket**
  3. Clique em Ativar o Bitbucket para a equipe
  4. Clique em + Adicionar Bitbucket
  5. Selecione Yes, I use a hosted version of Bitbucket (Sim, eu uso uma versão hospedada do Bitbucket ) e siga as próximas etapas no Bitbucket.

    Captura de tela da opção de usar a versão hospedada do Bitbucket.
  6. No seu Bitbucket hospedado, clique no avatar do seu perfil de usuário no canto superior direito.

  7. Selecione Gerenciar conta.

    Captura de tela do menu do perfil de usuário do Bitbucket.
  8. Selecione tokens de acesso HTTP na barra lateral esquerda.

  9. Crie um novo token de acesso com permissões de **administrador** em **projetos** e **repositórios**.

  10. Copie o token de acesso HTTP fornecido.

  11. De volta ao ClickUp, cole o token copiado no campo Token de acesso.

  12. Insira os detalhes da sua conta Bitbucket, incluindo:

    • URL do host

    • URL canônico (opcional)

    Captura de tela dos detalhes da conta Bitbucket.
  13. Selecione suas preferências:

    • Usar segredo hospedado?

    • IP estático

  14. Clique em Vincular Bitbucket.

Agora que você autorizou sua conta, prossiga para o próximo passo de vincular repositórios Bitbucket ao seu Espaço de trabalho.

Anexe repositórios Bitbucket ao seu espaço de trabalho

O ClickUp permite que várias pessoas autorizem o Bitbucket dentro do seu Espaço de trabalho, e também permite que você personalize quais repositórios são compartilhados com seu Espaço de trabalho.

Isso significa que você pode autorizar sua conta pessoal sem anexar todos os seus repositórios; você pode personalizar quais deles anexar.

Anexar um repositório não concede aos usuários acesso ao código-fonte do seu repositório de forma alguma. Isso simplesmente permite aos usuários anexar itens de histórico para aquele repositório aos Espaço(s) que você especificar.

Nota: Vocêsó pode associar repositórios do Bitbucket onde possui acesso de administrador.

Captura de tela dos repositórios do Bitbucket e a opção de adicioná-los à ClickUp.

Etapa 3: selecione quais espaços estão anexados aos seus repositórios

Você pode personalizar quais Espaços os repositórios estão vinculados expandindo a lista suspensa à direita de Repos de Equipe. Para que você possa anexar itens do Bitbucket a tarefas, o espaço deve ser anexado ao repositório.

Captura de tela mostrando repositórios Bitbucket vinculados com espaços ClickUp.

Associe automaticamente a atividade do Bitbucket no ClickUp

O ClickUp automaticamente detectará qualquer nova atividade e a associará com as tarefas.

Para habilitar isso, você deve:

Adicione um ID da tarefa ClickUp em qualquer parte do título da solicitação de pull, nome do branch ou mensagem de commit nestes formatos:

#{task_id}

CU-{task_id}

{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

prefixo-1

Associar manualmente a atividade do Bitbucket

Captura de tela do ícone do Bitbucket em uma tarefa ClickUp.
  1. Clique no ícone do Bitbucket em qualquer tarefa

  2. Selecione um repositório

  3. Selecione um Branch

  4. Anexe seu commit

Altere automaticamente o status da tarefa via Bitbucket

Você também pode alterar o status de uma tarefa a partir de um commit ou pull request.
Para fazer isso:

Adicione o ID da tarefa da ClickUp em qualquer parte da mensagem de commit, assim como o status que deseja entre colchetes.
Por exemplo: #ud5b[pronto]

Animação de uma alteração de status de tarefa de um git push do Bitbucket.

Nota: Você também pode vincular IDs de tarefas do Bitbucket de volta ao ClickUp!

Captura de tela de um commit no Bitbucket.
  1. Acesse as configurações do repositório

  2. Clique em Links

  3. Adicione novo link

  4. Tipo de link: Personalizado

  5. Link URL: app.clickup.com/t/\1

  6. Chave de link: CU-(\w{3,10})(\[\w+\])?

Isso vale tanto para commits quanto para solicitações de pull.

Ações

Crie novos branches rapidamente e com facilidade dentro do ClickUp com nossas ações rápidas.

  1. Clique no ícone do Bitbucket para abrir o modal do Git

  2. À esquerda, há uma variedade de opções de cópia rápida geradas automaticamente, como nome sugerido, comando para fazer checkout e vincular um novo branch localmente, comando para vincular um único commit ou um comando para abrir uma solicitação pull

Captura de tela do modal de branch do git em uma tarefa ClickUp.

Você pode personalizar o nome gerado automaticamente usado nessas opções nas configurações de integração do Bitbucket!

Captura de tela das configurações de nome de branch do Bitbucket.

Solicitações de pull

Agora, você pode criar solicitações de pull diretamente no ClickUp ou vincular as já existentes! Para criar uma nova solicitação de pull no ClickUp:

  1. Clique no ícone do Bitbucket na tarefa que deseja vincular e clique no botão "Nova Solicitação de Pull".

  2. No modal, um título de pull request sugerido será pré-preenchido com um título sugerido. Se você não gostar do título gerado automaticamente, pode ajustá-lo nas configurações de integração do Bitbucket.

  3. Selecione um branch de destino e um branch de origem

  4. Insira uma descrição

  5. Crie a solicitação de pull

Assim que você criar uma solicitação de pull na ClickUp ou vincular uma existente, um link para a tarefa associada da ClickUp será adicionado à solicitação de pull!

Captura de tela de uma notificação de tarefa vinculada no Bitbucket.

Uma vez que uma solicitação de pull é vinculada, você poderá ver quem a abriu, o revisor (se houver um atribuído), o status de CI/CD e o status da solicitação de pull (aberta, revisão solicitada, em revisão, mesclada, fechada) tudo dentro da tarefa ClickUp vinculada!

Captura de tela da atividade da solicitação pull no modal git do ClickUp.

Você está tendo problemas com o Bitbucket?

Leia nosso documento de solução de problemas ou pergunte ao suporte ao cliente do Bitbucket aqui.

Remover integração com o Bitbucket

Apenas os proprietários e administradores do Espaço de trabalho podem desativar integrações.

Para remover a integração, no App Center:

  1. Selecione Bitbucket.
  2. Role para baixo e clique em Remover autorização para meus repositórios no Bitbucket.

Esse artigo foi útil?