Web trigger de organização do GitHub

Os gatilhos da web da organização do GitHub são usados para monitorar uma organização do GitHub em busca de eventos. Quando o evento ocorre na organização, o gatilho é ativado e inicia o fluxo de trabalho de automação.

Mapeie seu gatilho para uma organização do GitHub e configure o gatilho para executar a automação quando ocorrerem eventos na organização.

O gatilho da web da organização do GitHub é compatível com os seguintes eventos em uma organização:
  • 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 da organização do GitHub para monitorar uma organização do GitHub em busca de problemas. Quando um problema é criado na organização monitorada, 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.
  • O gatilho da web do GitHub usa o Token de acesso pessoal para autenticar a identidade 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 organização para adicionar o Web trigger à seção Acionadores.
  8. Selecione um ou vários eventos para monitorar, no menu suspenso Monitorar evento.
    Os seguintes eventos são compatíveis:
    • Criar
    • Fork
    • Comentário do problema
    • Problemas
    • Rótulo
    • Solicitação pull
    • Revisão da solicitação pull
    • Push
    • Estrela
    • Assistir
  9. Insira o nome da organização do GitHub no campo Nome da organização.
  10. 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.
  11. 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.
  12. Opcional: Adicione mais acionadores conforme necessário na seção Acionadores.
  13. 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.
  14. Clique em Salvar para salvar o bot.
Quando você executa o bot usando Executar com gatilhos, o gatilho da web é ativado e escuta por eventos de Bifurcação, Problemas e Rótulo. Quando um dos eventos ocorre na organização, o gatilho inicia a ação de Caixa de mensagem subsequente.