Usando nossa integração com o GitHub para sincronizar trabalhos entre o GitHub e o ClickUp? Adicione Automações do GitHub para construir um fluxo de trabalho eficiente. As equipes de software podem reduzir a troca de contexto usando Automações para manter tudo atualizado.
O que você vai precisar
- As integrações de automação estão disponíveis a partir do plano Business.
- O administrador ou proprietário do espaço de trabalho deve habilitar a Automação ClickApp.
- Você precisa de permissões de administrador no repositório do GitHub para configurar Automações.
- Convidados não podem usar a integração com o GitHub.
Adicione 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 será aplicada.
- Clique no botão Automações no canto superior direito.
- Clique em Adicionar automações.
- Selecione Navegar no topo.
- Selecione Github na barra lateral esquerda.
- Selecione a Automação que 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 da lista suspensa de contas existentes do GitHub.
- Para atualizar uma conta do GitHub autorizada anteriormente, você deve removê-la e adicioná-la novamente.
- Excluir uma conta não afetará nenhuma Automação existente que utilize essa conta. Você precisará adicioná-lo novamente para criar Automações no GitHub no futuro.
- Insira seu nome de usuário do GitHub e clique em Conectar Conta e autorize o ClickUp ou clique em Criar uma conta para criar uma nova conta no GitHub.com.
-
Escolha da lista suspensa de contas existentes do GitHub.
- 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.
- As opções disponíveis variarão dependendo da Automação do GitHub que você está usando.
- Clique em Criar.
- Considere dar à sua Automação do GitHub uma descrição significativa para ajudar outros a entender o que ela faz.
Automações do GitHub
Automações no GitHub usam a mesma estrutura que Automações no ClickUp.
Toda Automação é composta por um Gatilho e uma Ação. Usuários no plano Business e superiores têm a opção de usar Condições.
Gatilhos do GitHub
Quando os eventos a seguir ocorrerem no repositório GitHub especificado e as Condições forem atendidas, a Automação será executada e realizará uma Ação.
-
Solicitação de pull mesclada
-
Branch Merged
-
No Commit
-
Revisão de pull request criada
-
Revisão da solicitação pull atualizada
-
Status do CI/CD alterado
-
Solicitação de Pull Vinculada
-
Branch Vinculado
-
Compromisso 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 o branch principal for vinculado. Ou defina a prioridade da tarefa como urgente e comente quando uma solicitação de pull com a etiqueta hotfix for mesclada na branch QA .
Condições podem ser definidas para múltiplas combinações de etiquetas de solicitação de pull, base ref e valores de head ref.
Lógica de condição
Você pode utilizar a seguinte lógica de Condição:
- é qualquer um dos seguintes: A solicitação de pull inclui pelo menos um dos rótulos ou branches especificados.
- é tudo de: A solicitação de pull inclui todos os rótulos ou branches especificados.
- não é nenhum deles: O pull request não inclui nenhum dos rótulos ou branches especificados.
- não é tudo de: A solicitação de pull não inclui todos os rótulos ou branches especificados.
Para etiquetas, você pode usar a lógica listada acima e:
- está definido: Pelo menos um rótulo foi aplicado à solicitação de pull.
- não está definido: Nenhuma etiqueta foi aplicada ao pull request.
Adicione uma Condição
Para adicionar uma Condição à sua Automação no GitHub:
- De uma Automação, na seção de Gatilho, clique em Adicionar Condição.
- Selecione a que a condição deve se aplicar:
- Condição de etiqueta do Githublabel: Rótulos aplicados ao pull request.
- Ref de cabeçalho: O branch de origem contendo suas alterações propostas.
- Ramobase: O ramo alvo onde suas alterações serão aplicadas.
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 Gatilhos do GitHub.
Para que as Ações de Automação sejam aplicadas às tarefas existentes, a tarefa já deve estar vinculada ao repositório do GitHub por meio de um commit, branch ou solicitação de pull. A ação de Criar Tarefa é a única exceção, pois novas tarefas não podem ser vinculadas antecipadamente.
Ações no GitHub
Você pode usar Automações com a ação Criar Problema, que cria um novo problema no GitHub.
Por exemplo, quando um formulário de erro é enviado e cria uma tarefa em uma Lista específica, uma Automação pode criar um problema no Github.