Web trigger do repositório GitHub

Os gatilhos da web do repositório do GitHub são usados para monitorar um repositório dentro de uma organização do GitHub para eventos. Quando o evento ocorre no repositório, o gatilho é ativado e inicia o fluxo de trabalho de automação.

Mapeie seu acionador para um repositório dentro de uma organização GitHub e configure o acionador para executar a automação quando ocorrerem eventos no repositório.

O gatilho da web do repositório do GitHub é compatível com os seguintes eventos em um repositório:
  • Criar
  • Fork
  • Comentário do problema
  • Problemas
  • Rótulo
  • Solicitação pull
  • Revisão da solicitação pull
  • Push
  • Estrela
  • Assistir

Por exemplo, crie um gatilho da web de repositório do GitHub para monitorar um repositório dentro de uma organização do GitHub para uma pull request. Quando uma pull request é feita no repositório monitorado, o gatilho é ativado e as próximas ações na automação são iniciadas.

Pré-requisitos

  • Você deve ter uma licença do Criador de bots ou Desenvolvedor cidadão.
  • Você precisa ter a permissão Visualizar meus bots.
  • Você deve ter todas as permissões de ACIONADORES DE EVENTO para a função.
  • Você precisa ter as permissões Fazer checkin e Fazer checkout nas pastas em que a automação está localizada.
  • Você deve estar logado na sua Control Room.
  • Os gatilhos da web do GitHub usam o Token de acesso pessoal para autenticar a identidade do perfil do usuário. O gatilho da web do GitHub oferece suporte a token de acesso clássico e de granulação fina. Certifique-se de gerar um Token de acesso pessoal nas configurações do usuário do GitHub e armazená-lo no Credential Vault. Para mais informações sobre a criação e gerenciamento de Token de acesso pessoal, consulte Gerenciamento de seus tokens de acesso pessoal.

Procedimento

  1. No painel da esquerda, clique em Automation (Automação).
  2. Clique em Criar > Task Bot.
    O assistente Criar Task Bot será exibido.
  3. Digite um nome apropriado para o bot no campo Nome.
    Todos os bots são armazenados na pasta \Bots por padrão.
  4. Opcional: Você pode adicionar uma descrição para o bot no campo Descrição.
  5. Opcional: Você pode usar o botão Escolher para salvar o bot em uma pasta diferente.
  6. Clique em Criar e editar.
    O bot é criado e o Editar Task Bot é exibido.
  7. Clique em Acionadores > GitHub e clique duas vezes ou arraste Web trigger de repositório para adicionar o Web trigger à seção Acionadores.
  8. Selecione um ou vários eventos para monitorar, no menu suspenso Monitorar evento.
  9. Insira o nome do repositório GitHub no campo Nome do repositório.
  10. Insira o nome do perfil GitHub em Perfil do usuário.
  11. Selecione uma das seguintes opções na seção Selecione o tipo de autenticação.
    O Token de acesso pessoal é selecionado como o tipo de autenticação em Selecionar o tipo de autenticação por padrão.
    • Credenciais: Clique em Escolher para selecionar o token de acesso pessoal que já está configurado no Credential Vault.
    • String insegura: Copie e cole a string do token de acesso pessoal que é gerado nas configurações do desenvolvedor do GitHub.
      Nota: Certifique-se de que o token de acesso pessoal não tenha expirado.
  12. Opcional: Adicione variáveis ao acionador na opção Resposta. Para mais informações sobre as variáveis, consulte Visão geral das variáveis.
    Nota: Se você usar uma variável existente para a resposta, certifique-se de que a caixa de seleção Usar como entrada esteja habilitada para a variável.
  13. Opcional: Adicione mais acionadores conforme necessário na seção Acionadores.
  14. Clique duas vezes ou arraste uma ação apropriada da paleta Ações para a seção Ação.
    Para obter informações sobre ações, consulte Ações para criar automações.
  15. Clique em Salvar para salvar o bot.
Quando você executa o bot usando Executar com gatilhos, o acionador da web é ativado e escuta por eventos de Problemas, Favoritos e Observar. Quando um dos eventos ocorre no repositório, o gatilho inicia a ação de Caixa de mensagem subsequente.