GitHub Spoke
Gerencie o controle de versão distribuída e o código-fonte em GitHub da instância ServiceNow. Crie fluxos em ServiceNow para gerenciar recursos colaborativos, como acompanhamento de bugs, solicitações de recurso, tarefas e assim por diante, para projetos em GitHub. Exiba e analise dados de uso significativos para assinaturas de software GitHub Enterprise Cloud e GitHub Enterprise Server para que você possa recuperar licenças obsoletas.
Solicitar aplicativos na Store
Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.
Assinatura do IntegrationHub
Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.
Versão do spoke
GitHub spokev 3. 3 . 0 é a versão mais recente.
Versões com suporte
Este spoke foi criado para GitHubVersão da API v 3, mas pode ser compatível com versões posteriores.
Requisitos do spoke
- GitHub conta
- Usuário com credenciais de administrador
- Token para autenticar o. ServiceNow instância
GitHub Módulo webhooks
Webhooks bidirecionais podem ser configurados para serem notificados sobre os eventos necessários. A política de roteamento define condições que devem ser atendidas para notificar o. ServiceNow aplicação. Essas condições são baseadas nos eventos em GitHubsobre o qual você deseja ser notificado. Quando as condições são atendidas, a política de roteamento aciona o subfluxo associado, o que, por sua vez, automatiza o. GitHubtarefas.
Os webhooks bidirecionais exigem configuração separada e podem ser usados independentemente sem usar as ações do spoke. Por padrão, a aplicação GitHub Webhooks está disponível no GitHub spokee tem os seguintes módulos:
- GitHub Registros do webhook
- GitHub Políticas de roteamento de webhook
Use GitHubMódulo de registros do webhook para atribuir um token e fornecer o caminho da API. Você deve gerar um URL de retorno de chamada aqui e fornecer este URL em GitHub. Uma política de roteamento padrão é fornecida no GitHubMódulo Políticas de roteamento do webhook. A política de roteamento padrão oferece suporte a eles GitHubcampos:
| Compatível GitHubcampos | ||
|---|---|---|
| Ação | Criador do cartão do projeto | Ref |
| Referência base | Nota do cartão do projeto | Tipo de referência |
| Corpo do comentário de confirmação | Nota anterior do cartão do projeto | Liberar ativos |
| Comentário de confirmação criado em | Cartão do projeto atualizado em | Autor da versão |
| Caminho do comentário de confirmação | Coluna do projeto criada em | Corpo da versão |
| Comentário de confirmação atualizado em | Nome da coluna do projeto | Versão criada em |
| Usuário do comentário de confirmação | Nome anterior da coluna do projeto | Rascunho da versão |
| Forçar envio por push | Coluna do projeto atualizada em | Nome da versão |
| URL da instância do GitHub | Projeto criado em | Versão publicada em |
| Problema atribuído a | Nome do projeto | Nome do marcador da versão |
| Responsáveis pelo problema | Corpo anterior do projeto | Confirmações de destino da versão |
| Corpo do problema | Nome anterior do projeto | Repositório arquivado |
| Problema encerrado em | Estado do Projeto | Repositório criado em |
| Emitir comentário | Projeto atualizado em | Descrição do repositório |
| Contagem de comentários do problema | Solicitação de extração atribuída a | Repositório inativo |
| Comentário do problema criado em | Responsáveis pela solicitação de extração | Nome completo do repositório |
| Comentário do problema atualizado em | Corpo da solicitação de extração | O repositório tem problemas |
| Problema criado em | Solicitação de extração encerrada em | O repositório tem projetos |
| Problema rotulado como | Extrair contagem de comentários da solicitação | Status de importação do repositório |
| Rótulos do problema | Solicitação de extração criada em | Licença do repositório |
| Problema bloqueado | Rascunho da solicitação de extração | Contagem de ocorrências em aberto do repositório |
| Marco do problema | Solicitação de extração rotulada como | Responsável pelo repositório |
| Corpo anterior do problema | Rótulos da solicitação de extração | Repositório privado |
| Comentário anterior do problema | Solicitação de extração bloqueada | Repositório enviado em |
| Marco anterior do problema | Solicitação de extração passível de ser mesclada | Repositório selecionado em |
| Título anterior do problema | Solicitação de extração mesclada | Repositório atualizado em |
| Problema atribuído anteriormente a | Solicitação de extração mesclada em | Intervalo afetado do alerta de vulnerabilidade do repositório |
| Problema rotulado anteriormente como | Marco da solicitação de extração | Identificador externo de alerta de vulnerabilidade do repositório |
| Estado do problema | Corpo anterior da solicitação de extração | Alerta de vulnerabilidade do repositório fixado em |
| Título do problema | Título anterior da solicitação de extração | Nome do pacote de alerta de vulnerabilidade do repositório |
| Problema atualizado em | Solicitação de extração atribuída anteriormente a | Descrição do comunicado de segurança |
| Usuário do problema | Solicitação de extração rotulada anteriormente como | ID do comunicado de segurança |
| Marco encerrado em | Solicitação de extração passível de substituição | Comunicado de segurança publicado em |
| Marco criado em | Corpo da revisão da solicitação de extração | Severidade do aviso de segurança |
| Criador do marco | Comentário da revisão de pull request | Resumo do comunicado de segurança |
| Descrição do marco | Contagem de comentários de revisão da solicitação de extração | Comunicado de segurança atualizado em |
| Marco com vencimento em | Comentário de revisão da solicitação de extração criado em | Comunicado de segurança retirado em |
| Estado do marco | Caminho do arquivo de comentário de revisão da solicitação de extração | Login do remetente |
| Título do marco | Comentário de revisão de solicitação de extração Comentário anterior | Mensagem de confirmação de status |
| Marco atualizado em | Comentário de revisão da solicitação de extração atualizado em | Contexto de status |
| Descrição da organização | Corpo anterior da revisão da solicitação de extração | Status criado em |
| Login da organização | Estado de revisão da solicitação de extração | Descrição do status |
| Pré-lançamento | Estado da solicitação de extração | Nome do status |
| Corpo do projeto | Título da solicitação de extração | Estado do status |
| Cartão do projeto arquivado | Solicitação de extração atualizada em | Status atualizado em |
| Cartão do projeto criado em | Usuário da solicitação de extração | Evento do webhook |
Para usar outras condições na política de roteamento, crie uma política de roteamento no GitHubMódulo Políticas de roteamento do webhook e especifique as condições de acordo com sua necessidade. Consulte Configure o webhook bidirecional para o spoke do GitHub para obter informações sobre como configurar os webhooks.
Gatilhos do spoke
ServiceNow oferece suporte a eventos específicos em GitHub que criam gatilhos. Primeiro, você deve configurar um fluxo com uma definição de gatilho compatível. Quando ocorre um evento, por exemplo, uma solicitação por push, no GitHub, ele envia a carga por meio de um webhook para ServiceNow instância. Depois disso, o fluxo que você configurou é acionado em ServiceNow instância para automatizar um fluxo de trabalho. Os eventos compatíveis são:
| Categoria | Gatilho | Descrição |
|---|---|---|
| Gestão de ramificações | Ramificação criada | O fluxo é acionado quando você cria uma ramificação em GitHub. |
| Gestão de repositórios | Solicitação de extração aberta | O fluxo é acionado quando você inicia uma nova solicitação de extração em GitHub. |
| Solicitação de extração editada | O fluxo é acionado quando você atualiza uma solicitação de extração em GitHub. | |
| Solicitação de extração fechada | O fluxo é acionado quando você fecha uma solicitação de extração em GitHub. | |
| Solicitação de extração atribuída | O fluxo é acionado quando você atribui uma solicitação de extração a um usuário em GitHub. | |
| Solicitação de extração reaberta | O fluxo é acionado quando você reabre uma solicitação de extração em GitHub. | |
| Ramificação do repositório | O fluxo é acionado quando você fork um repositório no GitHub. | |
| Envio de repositório | O fluxo é acionado quando você envia por push para um repositório em GitHub. | |
| Gestão de versões | Versão criada | O fluxo é acionado quando os detalhes de uma versão são criados em GitHub. |
| Versão editada | O fluxo é acionado quando os detalhes de uma versão são atualizados em GitHub. | |
| Versão excluída | O fluxo é acionado quando uma versão é removida em GitHub. | |
| Versão liberada | O fluxo é acionado quando uma versão é liberada em GitHub. |
Para obter informações sobre como configurar os gatilhos do GitHub spoke, consulte Ative a definição do gatilho em ServiceNow instância. Para obter mais informações sobre integração de entrada, consulte Integração de entrada condicional e orientada por eventos.
Subfluxos do spoke
. GitHub spokefornece um subfluxo de amostra para lidar com vários GitHubeventos de webhook. Os subfluxos de amostra disponíveis são:
| Subfluxo | Descrição | Compatível GitHubEvento |
|---|---|---|
| Processar eventos do webhook de ramificação do GitHub e marcar | Manipula eventos de webhook de ramificação e marcador. | Ramificação e marcador |
| Processar eventos do webhook de confirmação do GitHub | Manipula eventos de webhook de confirmação. | Confirmar |
| Processar eventos do webhook de problemas do GitHub | Lida com eventos de webhook de problemas. | Ocorrência |
| Processar eventos do webhook de marcos do GitHub | Processa eventos de webhook de marcos. | Marco |
| Processar eventos do webhook do projeto do GitHub | Manipula eventos de webhook do projeto. | Projeto |
| Processar eventos do webhook de solicitação de extração do GitHub | Manipula eventos de webhook de solicitação de extração. | Pull request |
| Processar eventos de webhook de push do GitHub | Processa eventos de webhook de solicitação por push. | Solicitação por push |
| Processar eventos do webhook da versão do GitHub | Manipula eventos de webhook de versão. | Versão |
| Processar eventos do webhook do repositório do GitHub | Manipula eventos de webhook do repositório. | Repositório |
| Processar eventos do webhook de segurança do GitHub | Manipula eventos de webhook de segurança. | Segurança |
| Processar eventos do webhook do GitHub | Manipula tudo GitHubeventos de webhook. |
Nota:
Este subfluxo lida com tudo GitHubeventos. Você pode personalizar este subfluxo para lidar com outros GitHubeventos de webhook que não são compatíveis por padrão. |
Para criar subfluxos para lidar com outros GitHubeventos de webhook ou manipulam os compatíveis GitHubEventos do webhook De forma diferente, personalize o subfluxo Eventos do webhook do GitHub do processo. Para isso, você deve criar uma cópia do subfluxo, analisar a carga e personalizar o subfluxo de acordo com sua necessidade. A carga é uma das entradas para o subfluxo.
Ao personalizar subfluxos, você deve confirmar se os subfluxos estão configurados para evitar loops infinitos.
Nota:
- Você deve configurar webhooks para usar o subfluxo do spoke. Consulte Configure o webhook bidirecional para o spoke do GitHub para obter informações sobre como configurar e configurar o webhook.
- Os subfluxos de amostra são executados como um usuário por padrão. Ele pode ser configurado para ser executado como um sistema.
- GitHub spoke compatível com carga da aplicação/json. Configure o. GitHubwebhook de acordo. Consulte GitHub Desenvolvedor documentação para obter instruções sobre como criar e configurar um webhook.
Ações do spoke
. GitHub spokefornece ações para gerenciar ramificações, problemas, repositórios e código-fonte quando ocorrem eventos em ServiceNow. As ações disponíveis incluem:
| Categoria | Ação | Descrição |
|---|---|---|
| Gestão de ramificações | Criar ramificação | Cria uma ramificação em GitHubCom base em um SHA de confirmação específico. |
| Excluir ramificação | Exclui uma ramificação do GitHubrepositório. | |
| Obter ramificação | Recupera os detalhes de uma ramificação no GitHubrepositório. | |
| Obter proteção de ramificações | Recupera os detalhes de restrição da ramificação necessária. | |
| Listar ramificações | Recupera a lista de todas as ramificações em um repositório. | |
| Remover proteção de ramificações | Remove a proteção na ramificação necessária. | |
| Atualizar proteção de ramificações | Atualiza a proteção na ramificação necessária. | |
| Gestão de ocorrências | Criar comentário no problema | Cria comentário sobre um problema necessário. |
| Criar Problema | Cria um problema para o repositório necessário. | |
| Excluir comentário do problema | Exclui o comentário sobre um problema necessário. | |
| Bloquear problema | Bloqueia o problema necessário. Isso limita a conversa somente aos colaboradores. | |
| Pesquisar comentários no problema | Recupera a lista de comentários sobre um problema. | |
| Pesquisar problemas | Recupera a lista de problemas de um repositório. | |
| Desbloquear problema | Desbloqueia o problema necessário. Isso abre a conversa para todos os usuários. | |
| Atualizar comentário no problema | Atualiza um comentário sobre um problema. | |
| Atualizar problema | Atualiza os detalhes do problema necessário. | |
| Recuperação de Metadados | Pesquisar campos por ação | Recupera a lista de campos de um filtro de ação no GitHubTabela Campos. |
| Pesquisar metadados de ramificações | Recupera metadados das ramificações. | |
| Pesquisar metadados de problemas | Recupera metadados dos problemas. | |
| Pesquisar metadados dos marcos | Recupera metadados dos marcos. | |
| Pesquisar metadados de solicitações de extração | Recupera metadados das solicitações de extração. | |
| Gestão da organização | Obter plano da organização | Recupera o nome do plano de uma organização. |
| Lista de membros da organização | Recupera a lista de todos os membros em uma organização. | |
| Listar repositórios da organização | Recupera a lista de todos os repositórios em uma organização. | |
| Remover membro da organização | Remove um usuário de uma organização. | |
| Pesquisar fluxo de eventos da organização | Recupera a lista de eventos em uma organização com base na data de retrospectiva fornecida. | |
| Pesquisar fluxo de colaboradores externos da organização | Recupera a lista de todos os colaboradores externos em uma organização. | |
| Remover colaborador externo da organização | Remove um colaborador externo de uma organização. | |
| Pesquisar fluxo de colaboradores externos pendente da organização | Recupera uma lista de colaboradores pendentes em um repositório. | |
| Pesquisar fluxo de convites da organização | Recupera uma lista de convites em uma organização. | |
| Gestão de repositórios | Adicionar colaborador | Adiciona colaborador ao repositório necessário. |
| Criar comentário na solicitação de extração | Criar comentários de revisão em uma solicitação de extração. | |
| Criar marco | Cria marco para o repositório necessário. | |
| Criar solicitação de extração | Cria uma solicitação de extração para um repositório. | |
| Criar resposta no comentário de revisão da solicitação de extração | Cria resposta a um comentário de revisão para uma solicitação de extração. | |
| Criar repositório | Cria um repositório em GitHub. | |
| Excluir comentário na solicitação de extração | Exclui o comentário de revisão em uma solicitação de extração. | |
| Excluir marco | Exclui o marco do repositório necessário. | |
| Listar comentários na solicitação de extração | Recupera a lista de todos os comentários de revisão em uma solicitação de extração. | |
| Listar marcos | Recupera a lista de todos os marcos em um repositório. | |
| Listar eventos do repositório | Recupera a lista de eventos em um repositório. | |
| Pesquisar solicitações de extração | Recupera os detalhes das solicitações de extração de um repositório. | |
| Pesquisar repositórios | Recupera os detalhes dos repositórios com base em um usuário ou organização específico. | |
| Mesclar solicitação de extração | Mescla a solicitação de extração a um repositório. | |
| Remover colaborador | Remove colaborador de um repositório. | |
| Atualizar comentário na solicitação de extração | As atualizações revisam os comentários fornecidos para uma solicitação de extração. | |
| Atualizar marco | Atualiza os detalhes de um marco em um repositório. | |
| Atualizar solicitação de extração | Atualiza os detalhes de uma solicitação de extração em um repositório. | |
| Atualizar repositório | Atualiza os detalhes de um repositório em GitHub. | |
| Gestão de código-fonte | Criar comentário na confirmação | Cria um comentário para a confirmação necessária usando seu SHA. |
| Criar ou atualizar um arquivo | Cria um arquivo ou atualiza um arquivo existente em um repositório. | |
| Obter comentários por ID de confirmação | Recupera comentários fornecidos para uma única confirmação. | |
| Obter informações de confirmação por ID | Recupera o conteúdo da referência de confirmação necessária. | |
| Obter conteúdo do arquivo | Recupera o conteúdo de um arquivo em um repositório. Nota: Esta ação é compatível com arquivos com tamanho de arquivo de até 1 MB. |
|
| Listar confirmações em um repositório | Recupera os detalhes de todas as confirmações feitas em um repositório. | |
| Gestão de usuários | Obtenha todos os usuários do Enterprise Server | Recupera a lista de todos GitHub Usuários do Enterprise Server. |
| Listar organizações para o usuário autenticado | Recupera a lista de organizações das quais o usuário conectado é membro. | |
| Suspender usuário | Suspende um GitHub conta de usuário. | |
| Pesquisar usuário autenticado | Recupera informações sobre o usuário autenticado. |
Agentes de IA disponíveis
Instalar Now Assist Spokes e comece a usar os agentes de IA disponíveis. Para obter mais informações, consulte Now Assist Para Spokes.
Este spoke fornece agentes de IA autônomos que imitam inteligência semelhante à humana para executar tarefas em seu ServiceNow instância.
- Em ServiceNow Sistema agentic, você pode criar um fluxo de trabalho agentic que compreende um conjunto de instruções de modelo de linguagem grande (LLM) junto com um ou mais agentes de IA autônomos para executar um objetivo. Consulte Create an agentic workflow Para obter informações sobre como adicionar agentes de IA para criar fluxos de trabalho do agente de acordo com sua necessidade e fornecer o gatilho necessário.
Você também pode pesquisar outros agentes de IA disponíveis e adicioná-los ao fluxo de trabalho do agente. Para obter mais informações, consulte Find AI agents.
- Você pode criar um clone do agente de IA do spoke necessário e personalizá-lo de acordo com seu requisito. Consulte Duplicate an AI agent para obter mais informações sobre como criar um clone.
- Consulte Now Assist AI agents Para obter informações sobre agentes de IA.
Os agentes de IA disponíveis incluem:
| Agente de IA | Descrição |
|---|---|
| Agente de IA da gestão de ramificações do GitHub | Gerencia e mantém o. GitHub ramificações. Além disso, recupera informações sobre GitHub ramificações. |
| Agente de IA da gestão de problemas do GitHub | Gerencia e automatiza tarefas relacionadas ao GitHub no Integration Hub. |
| Agente de IA da gestão de repositórios do GitHub | Gerencia os repositórios do GitHub manipulando as operações do repositório, solicitações de extração, comentários na solicitação de extração e marcos. |
| Agente de IA de gestão de código-fonte do GitHub | Gerencia o código-fonte e lida com os arquivos do repositório, confirmações e comentários. |
Procurando um agente de IA?
- Pode haver agentes de IA instalados com o. Now Assistaplicações que não são usadas em fluxos de trabalho agentivos. Para saber como ver todos os agentes disponíveis em sua instância, consulte Encontre agentes de IA .
- Para encontrar agentes que podem não estar instalados em sua instância, visite Mercado de agentes de IA em ServiceNow Store.
Nota:
Certifique-se de que o usuário que executa um agente de IA tenha as funções e permissões necessárias para acessar dados ou executar operações em dados na tabela associada ao agente de IA.
Módulos de spoke
. GitHub o spoke adiciona esses módulos ao seu ServiceNow instância.
| Módulo | Descrição |
|---|---|
| GitHub Responsável | Exibe o. GitHub registros do responsável que você criou. |
| GitHub Repositórios | Exibe os detalhes do GitHub repositórios associados ao GitHub responsáveis. |
Requisitos de aliases de conexão e credencial
IntegrationHub usa aliases para gerenciar conexões e informações de credenciais e credenciais de OAuth. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.
Para obter informações sobre como configurar o spoke, consulte Configure o. GitHub spoke.