Integrar o GitLab com o ClickUp permite que você conecte a atividade do GitLab, como commits, branches e solicitações de merge, com suas tarefas do ClickUp. Isso permite que você acompanhe todas as atividades relacionadas ao GitLab dentro do ClickUp e receba notificações quando novos itens de atividade do GitLab são adicionados às tarefas. Aqui está como configurar e usar essa integração:
**Pré-requisitos:**
– A integração do GitLab está disponível em todos os planos do ClickUp.
– Apenas proprietários e administradores da área de trabalho podem configurar integrações.
– Convidados não podem usar a integração do GitLab.
– A integração do GitLab funciona com as versões local e auto-hospedada do GitLab.
**Passo 1: Autorizar o GitLab**
1. Abra o Centro de Aplicativos do ClickUp:
– No ClickUp 2.0, clique em seu avatar de conta no canto inferior esquerdo.
– No ClickUp 3.0, clique no menu de Ações Rápidas no canto superior direito.
2. Selecione “Centro de Aplicativos”.
3. Na barra lateral, selecione “Desenvolvimento”.
4. Clique em “GitLab”.
5. Clique em “Conectar”.
6. Faça login em sua conta do GitLab.
**Autorizar com gitlab.com ou GitLab auto-hospedado:**
– Se você estiver usando gitlab.com:
– Na página do Centro de Aplicativos do GitLab, clique em “Gerenciar”.
– Clique em “+ Adicionar Gitlab”.
– Selecione “Não, eu uso gitlab.com”.
– Clique em “Link Gitlab”.
– Clique em “Autorizar” para permitir que o ClickUp associe a atividade do GitLab com as tarefas do ClickUp.
– Se você estiver usando uma instância auto-hospedada do GitLab:
– Na página do Centro de Aplicativos do GitLab, clique em “Gerenciar”.
– Clique em “+ Adicionar Gitlab”.
– Selecione “Sim, eu uso uma versão hospedada do Gitlab”.
– Cole a URL do seu GitLab no campo “URL do Host” (por exemplo, https://gitlab.mydomain.com/).
– Siga as instruções para encontrar, copiar e colar seu token de acesso pessoal no campo “Token de Acesso”.
– Se sua equipe estiver atrás de um firewall, inclua seu endereço IP estático em sua lista de permissões de firewall antes de integrar.
**Passo 2: Adicionar Repositórios Pessoais ao ClickUp**
Você pode personalizar quais repositórios são compartilhados com sua área de trabalho do ClickUp, permitindo que você autorize sua conta pessoal sem anexar todos os seus repositórios. Anexar um repositório não concede acesso à base de código do seu repositório; permite que os usuários anexem itens de histórico desse repositório às Spaces especificadas.
Para adicionar um repositório ao ClickUp:
1. No 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 nome do repositório que deseja adicionar, clique em “+ Adicionar ao ClickUp”.
**Passo 3: Selecionar Spaces do ClickUp para os Repositórios**
Para anexar um repositório a uma Space do ClickUp, clique no menu suspenso à direita do nome do repositório e selecione uma ou mais Spaces.
Você deve anexar o repositório a uma Space antes de poder anexar itens do GitLab às tarefas.
**Associar Automaticamente a Atividade do GitLab no ClickUp**
O ClickUp pode associar automaticamente novas atividades do GitLab às tarefas. Para fazer isso, adicione um ID de tarefa do ClickUp em qualquer parte do título da solicitação de merge, nome da branch ou mensagem de commit do GitLab em um destes formatos:
– #{task_id}
– CU-{task_id}
– {custom_task_id}
– #{custom_task_id}
Por exemplo: #1abc2de ou CU-1abc2de
**Associar Manualmente Commits e Branches do GitLab**
Para associar manualmente um commit ou branch do GitLab a uma tarefa do ClickUp:
1. Abra uma tarefa e clique no ícone do GitLab.
2. Clique na guia “Commits” ou “Branches”, dependendo do que você deseja associar.
3. Use os menus suspensos para selecionar o Repositório e a Branch.
4. Anexe seu commit ou branch.
**Alterar Automaticamente os Status das Tarefas a partir do GitLab**
Você pode alterar o status de uma tarefa a partir de um commit, problema ou solicitação de merge adicionando o ID da tarefa do ClickUp em qualquer parte da mensagem de commit e incluindo o status desejado entre colchetes.
Por exemplo: #u7hu[staged]
**Criar Novas Branches e Solicitações de Merge do ClickUp**
Você pode criar novas branches e solicitações de merge diretamente do 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 uma nova branch diretamente no GitLab, clique em “Criar Branch” no canto inferior esquerdo do modal.
**Personalizar Nomes de Branch Auto-gerados**
Você pode personalizar o formato de nomes de branch auto-gerados usado em ações rápidas, indo para as configurações de integração do GitLab no ClickUp e modificando o formato de nomes de branch auto-gerados.
**Criar Solicitações de Merge do ClickUp**
Para criar ou vincular solicitações de merge do ClickUp:
1. Abra uma tarefa e clique no ícone do GitLab.
2. Na parte inferior esquerda do modal, clique em “Nova Solicitação de Merge”.
3. Forneça os detalhes necessários, como título, repositório, branch de origem e branch de destino.
4. Crie a solicitação de merge clicando em “Nova Solicitação de Merge”.
Após criar ou vincular uma solicitação de merge no ClickUp, um link para a tarefa do ClickUp associada é automaticamente adicionado à solicitação de merge no GitLab.
**Remover a Integração do GitLab**
Apenas proprietários e administradores da área de trabalho podem
remover a integração do GitLab. Para fazer isso:
1. Na página de integrações no ClickUp 2.0 ou no Centro de Aplicativos no ClickUp 3.0, selecione “GitLab”.
2. Na parte inferior direita, clique em “Remover Gitlab”.
**Solucionar Problemas com a Integração**
Se você encontrar problemas com a integração, pode consultar o artigo de solução de problemas do GitLab do ClickUp ou entrar em contato com o suporte ao cliente do GitLab para obter assistência.
