Integrar commits, ramificações e solicitações de mesclagem do GitLab com tarefas do ClickUp. Isso permite que você: 

• Veja todas as atividades do GitLab relacionadas a uma tarefa no ClickUp. 
• Receba opcionalmente notificações do ClickUp quando novos itens de atividade do GitLab forem adicionados às tarefas.
• Automaticamente ou manualmente anexe atividades do GitLab a tarefas ClickUp. 
• Altere automaticamente os status com as ações do GitLab, adicionando o ID da tarefa do ClickUp aos seus commits usando este formato: #{taskID}[status].
  • Exemplo: #1abc2de[fechada]

O que você vai precisar

• A integração com o GitLab está disponível em todos os planos do ClickUp.
• Somente proprietários e administradores do espaço de trabalho podem configurar integrações.
• Convidados não podem usar a integração com o GitLab.
• A integração com o GitLab funciona tanto para versões locais quanto auto-hospedadas do GitLab.

Etapa 1: Autorizar o GitLab

Conecte e autorize o GitLab pelo ClickUp:

1. No canto superior direito, clique no menu de ações rápidas.
2. Clique em Central de Aplicativos.
3. Na barra lateral do App Center, selecione Development.
4. Clique em GitLab.
5. Selecione Conectar.
6. Faça login na sua conta do GitLab.

Autorize com gitlab.com ou com o GitLab auto-hospedado

Depois de conectar sua conta GitLab, você pode escolher autorizar usando gitlab.com ou GitLab auto-hospedado.

Usando gitlab.com:

1. Na página do GitLab App Center, clique em Manage (Gerenciar).
2. Clique em + Adicionar Gitlab.
3. Selecione Não, eu uso gitlab.com.
4. Clique em Linkar Gitlab.
5. Clique em Autorizar. Você deve autorizar o ClickUp a associar atividades do GitLab com tarefas ClickUp.

Usando o GitLab auto-hospedado:

1. Na página do GitLab App Center, clique em Manage (Gerenciar).
2. Clique em + Adicionar Gitlab.
3. Selecione **Sim, eu uso uma versão hospedada do Gitlab**.
4. Cole a URL do seu GitLab na caixa de texto URL do host .
   • URL de exemplo: https://gitlab.mydomain.com/
5. Siga as instruções para localizar, copiar e colar seu token de acesso pessoal no texto Access token Box.
   

   Se a sua equipe estiver atrás de um firewall, inclua seu endereço IP estático na lista de permissões do firewall antes de integrar. Este endereço IP estático será exibido nesta etapa.

6. Clique em Linkar Gitlab.
7. Clique em Autorizar. Você deve autorizar o ClickUp a associar a atividade do GitLab às tarefas do ClickUp.

Por motivos de segurança, exigimos que todas as integrações do GitLab que utilizam uma instância auto-hospedada do GitLab tenham um Domínio de Nível Superior (TLD). A URL não pode ter um número de porta anexado a ela. Não permitimos endereços IP ou domínios não reconhecidos como um Domínio de Nível Superior. Um exemplo de uma URL válida seria https://gitlab.clickup.com.

Etapa 2: Adicionar repositórios pessoais ao ClickUp

Várias pessoas podem autorizar o GitLab dentro do seu Espaço de Trabalho. Você pode personalizar quais repositórios são compartilhados com seu espaço de trabalho, permitindo que você autorize sua conta pessoal sem anexar todos os seus repositórios.

Vincular um repositório não concede aos usuários acesso ao código-fonte do seu repositório. Ele permite que os usuários anexem itens de histórico desse repositório aos espaços que você especificar. 

Para adicionar um repositório ao ClickUp:

1. Do Centro de Aplicativos, selecione GitLab.
2. Clique em Gerenciar.
3. Os repositórios são listados na seção Meus repositórios do Gitlab.
4. À direita do repositório que você deseja adicionar, clique em + Adicionar ao ClickUp.

Passo 3: Selecione quais espaços estão vinculados aos seus repositórios. 

Os repositórios adicionados estão listados na seção Repositórios do Gitlab adicionados ao ClickUp no canto inferior direito.

Para anexar um repositório a um espaço ClickUp, clique no menu suspenso à direita do nome do repositório e selecione um ou mais espaços.

O repositório deve ser anexado a um espaço antes que você possa anexar itens do GitLab a tarefas.

Associar automaticamente a atividade do GitLab no ClickUp 

O ClickUp pode associar automaticamente novas atividades do GitLab a tarefas.

Para fazer isso, adicione um ID de tarefa do ClickUp em qualquer parte do título da solicitação de mesclagem, do nome da ramificação ou da mensagem de confirmação em um desses formatos:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

prefixo-1

#prefix-1

Associe manualmente os commits do GitLab

Para associar manualmente um commit do GitLab a uma tarefa do ClickUp, você deve

1. Abra uma tarefa e clique no ícone do GitLab.
2. Clique na guia Confirmações.
3. Use o menu suspenso ao lado de New Merge Request para selecionar um Repo.
4. Use o menu suspenso Selecionar filial para selecionar uma filial.
5. Anexe seu commit.

Associar manualmente as ramificações do GitLab

Para associar manualmente uma ramificação do GitLab:

1. Abra uma tarefa e clique no ícone do GitLab.
2. Clique na aba Branches.
3. Use o menu suspenso ao lado de New Merge Request para selecionar um Repo.
4. Use o menu suspenso Selecionar filial para anexar uma filial.

Alterar automaticamente os status das tarefas do GitLab 

Você pode alterar o status de uma tarefa a partir de um commit, problema ou solicitação de mesclagem:

1. Adicione o ID da tarefa ClickUp ID da tarefa a qualquer parte da mensagem de commit e inclua o status que deseja entre colchetes.
   • Por exemplo: #u7hu[staged]
     

     Todos os formatos listados na seção Associar automaticamente atividades do GitLab no ClickUp deste artigo podem ser usados. Para garantir a formatação adequada, não adicione um espaço entre o ID da tarefa e as informações de status.

2. O status da tarefa será alterado.

Criar novos branches a partir do ClickUp

Crie novos branches usando ações rápidas no ClickUp:

1. Abra uma tarefa e clique no ícone do GitLab.
2. À esquerda, existem várias opções de cópia rápida geradas automaticamente. Se preferir criar um novo branch diretamente no GitLab, clique em Criar Branch no canto inferior esquerdo do modal.

Personalize os nomes de branches gerados automaticamente

Você pode personalizar o formato dos nomes de branch gerados automaticamente usados em ações rápidas:

1. A partir do Central de Aplicativos, selecione GitLab.
2. Em Formato de nomes de ramificação gerados automaticamente, faça edições.
3. No canto inferior direito, clique em Salvar.

Criar solicitações de mesclagem do ClickUp

Criar ou vincular solicitações de mesclagem do ClickUp.

Para criar uma nova solicitação de mesclagem:

1. Abra uma tarefa e clique no ícone do GitLab.
2. No canto inferior esquerdo do modal, clique em Nova Solicitação de Mesclagem.
3. Use o título predefinido da solicitação de mesclagem ou crie o seu próprio título.
4. Selecione um repositório, um ramo de origem e um ramo de destino.
5. Inserir uma descrição.
6. Crie a solicitação de mesclagem clicando em Nova Solicitação de Mesclagem.

Uma vez que você cria ou mescla uma solicitação no ClickUp, um link para a tarefa ClickUp associada é automaticamente adicionado à solicitação de mesclagem no GitLab.

Depois que uma solicitação de mesclagem for vinculada, você poderá ver quem a abriu, o revisor, o status de CI/CD e o status da solicitação de mesclagem na tarefa vinculada do ClickUp.

Remova a integração com o GitLab

Somente proprietários e administradores do espaço de trabalho podem remover a integração com o GitLab.

Para remover a integração com o GitLab:

1. No Centro de aplicativos, selecione GitLab.
2. No canto inferior direito, clique em Remover Gitlab.

Solucione problemas de integração

Leia nosso artigo de solução de problemas do GitLab ou entre em contato com o suporte ao cliente do GitLab aqui.