Usando nossa integração com o GitHub para sincronizar o trabalho entre o GitHub e o ClickUp? Adicione Automatizações do GitHub para construir um fluxo de trabalho eficiente. As equipes de software podem reduzir a troca de contexto usando Automatizações para manter tudo atualizado.
O que você precisará
Integrações de automação estão disponíveis nos planos Business e superiores.
O administrador ou proprietário do Workspace deve habilitar o ClickApp de Automação.
Você precisa de permissões de administrador no repositório do GitHub para configurar Automações.
Os convidados não podem usar a integração do GitHub.
Adicionar uma Automação do GitHub no ClickUp
Você pode adicionar Automações do GitHub nos níveis de Espaço, Pasta e Listas da Hierarquia do ClickUp.
Navegue até o Espaço, Pasta ou Lista onde a Automação se aplicará.
Clique no botão Automatizar no canto superior direito.
Clique em Criar Automações.
Selecione o GitHub na barra lateral esquerda.
Selecione a Automação que você deseja usar, ou clique em Mostrar Mais para ver mais Automações do GitHub disponíveis.
Conecte sua conta do GitHub usando as seguintes opções:
Escolha na lista suspensa as contas do GitHub existentes.
Para atualizar uma conta do GitHub autorizada anteriormente, você deve removê-la e adicioná-la novamente.
A remoção de uma conta não afetará nenhuma Automação existente que use essa conta. Você precisará adicioná-la novamente para criar Automações do GitHub no futuro.
Digite seu nome de usuário do GitHub e clique em Conectar Conta e autorizar o ClickUp ou clique em Criar uma conta para criar uma nova conta no GitHub.com.
Especifique quem pode usar sua conta do GitHub para criar Automações.
Configure o Gatilho, Condições e Ações.
Cada Automação do GitHub permite que você escolha um repositório específico (repo).
As opções disponíveis variarão dependendo da Automação do GitHub que você está usando.
Clique em Criar.
Considere dar uma descrição significativa à sua Automação do GitHub para ajudar os outros a entender o que ela faz.
Automações do GitHub
As Automações do GitHub usam a mesma estrutura das Automações no ClickUp.
Cada Automação consiste em um Gatilho e uma Ação. Os usuários dos planos Business e superiores têm a opção de usar Condições.
Gatilhos do GitHub
Quando os seguintes eventos ocorrem no repositório GitHub especificado, e as Condições são atendidas, a Automação será executada e realizará uma Ação.
Merge de Pull Request
Merge de Branch
Em Commit
Avaliação de Pull Request Criada
Avaliação de Pull Request Atualizada
Mudança de Status do CI/CD
Pull Request Vinculado
Branch Vinculado
Commit Vinculado
Condições do GitHub
As Automações do GitHub relacionadas a pull requests suportam uma ou mais Condições.
Por exemplo, você pode atualizar o status da tarefa quando um pull request para a branch principal estiver vinculado. Ou definir a prioridade da tarefa como urgente e comentar quando um pull request com o rótulo hotfix for mesclado na branch de QA.
As condições podem ser definidas para várias combinações de rótulos de pull request, base ref e head ref.
Lógica da Condição
Você pode usar a seguinte lógica de Condição:
é qualquer um de: O pull request inclui pelo menos um dos rótulos ou branches especificados.
é todos de: O pull request inclui todos os rótulos ou branches especificados.
não é nenhum de: O pull request não inclui nenhum dos rótulos ou branches especificados.
não é todos de: O pull request não inclui todos os rótulos ou branches especificados.
Para rótulos, você pode usar a lógica listada acima e:
está definido: Pelo menos um rótulo foi aplicado ao pull request.
não está definido: Nenhum rótulo foi aplicado ao pull request.
Adicionar uma Condição
Para adicionar uma Condição à sua Automação do GitHub:
A partir de uma Automação, na seção Gatilho, clique em Adicionar Condição.
Selecione a que a condição deve se aplicar:
Condição de rótulo GitHub: Rótulos aplicados ao pull request.
Head ref: A branch de origem que contém suas alterações propostas.
Base ref: A branch de destino onde suas alterações serão aplicadas.
Selecione a lógica da Condição.
Escolha o valor do rótulo ou branch a ser usado com esta condição. As Condições são sensíveis a maiúsculas e minúsculas. Elas devem corresponder exatamente ao nome do rótulo ou branch, ou não atenderão aos critérios e acionarão a Automação.
Clique em Adicionar outra para incluir um rótulo ou branch adicional a ser usado.
Clique em Adicionar Condição para adicionar várias Condições.
Ações do ClickUp
Todas as Ações de Automação, exceto nossa ação de webhook, estão disponíveis para atualizar tarefas usando os Gatilhos do GitHub
.
Para que as Ações de Automação sejam aplicadas a tarefas existentes, a tarefa deve estar vinculada ao repositório do GitHub, vinculando um commit, branch ou pull request. A única exceção é a ação Criar Tarefa, pois as novas tarefas não podem ser vinculadas antecipadamente.
Ações no GitHub
Você pode usar as Automações com a Ação de Criar Problema, que cria um novo problema no GitHub.
Por exemplo, quando um formulário de bug é enviado e cria uma tarefa em uma Lista específica, uma Automação pode criar um problema no Github.
