Spoke do Jenkins v2
Gerencie compilações, usuários, configurações e trabalhos no servidor Jenkins. Recupere dados do Jenkins para usar em um fluxo.
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 Integration Hub
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
Spoke do Jenkins v2 v1.2.0 é a versão mais recente.
Dependências do spoke
Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:
- Tempo de execução do ServiceNow IntegrationHub (com.glide.hub.integration.runtime)
- Etapa de ação do ServiceNow IntegrationHub — REST (com.glide.hub.action_step.rest)
- Modelo de ação do ServiceNow IntegrationHub — fluxo de dados (com.glide.hub.action_type.datastream)
Requisitos do spoke
O Spoke do Jenkins v2 v2 requer a geração de um token de API. Consulte Proteção de segurança: novo sistema de token de API no Jenkins 2.129+ para obter mais informações sobre os tokens de API.
Versões com suporte
Todas as versões entre 2.176.2 a 2.222.1.
Módulos de spoke
Você pode configurar Spoke do Jenkins v2 v2 para receber atualizações do Jenkins em sua instância ServiceNow. Nas políticas de roteamento, são definidas as condições que devem ser atendidas para receber atualizações em sua instância ServiceNow. Quando as condições são atendidas, a política de roteamento aciona o subfluxo associado que, por sua vez, automatiza as tarefas do Jenkins. Isso requer configuração separada e pode ser usado de forma independente sem usar as ações do spoke. Consulte Configurar um webhook para o spoke do Jenkins para obter informações sobre como instalar e configurar os webhooks. Para usar outras condições na política de roteamento ou personalizar os subfluxos padrão, consulte Personalizar um webhook.
- Palavras-chave
- Número de Compilação
- Nome do trabalho
- Caminho do Trabalho
- Mostrar campos relacionados
Por padrão, a aplicação Jenkins v2 está disponível no Spoke do Jenkins v2 e tem estes módulos:
| Módulo | Descrição |
|---|---|
| Subfluxos de resposta do Webhook | Detalhes da chave de autorização do webhook para autorizar solicitações do Jenkins. |
| Detalhe de cliente do Webhook | Detalhes sobre os subfluxos em Spoke do Jenkins v2. |
- Subfluxo de resposta do webhook do Jenkins v2 [sn_jenkinsv2_spoke_webhook_answer_subflow]
- Detalhes do cliente do webhook do Jenkins [sn_jenkinsv2_spoke_webhook_client_details]
Subfluxos do spoke
| Subfluxo | Descrição |
|---|---|
| Criar trabalho do Jenkins | Recebe atualizações do Jenkins na instância ServiceNow. |
| Subfluxo de resposta do Webhook do Jenkins: processar informações de compilação | Cria o trabalho do Jenkins e recupera as informações. Para personalizar este subfluxo, crie uma cópia do subfluxo e altere-o de acordo com seus requisitos. |
| Criar trabalho do Jenkins com parâmetros | Cria o trabalho do Jenkins com os parâmetros especificados e recupera as informações. |
Ações do spoke
O Spoke do Jenkins v2 fornece ações para automatizar tarefas do Jenkins quando ocorrem eventos em ServiceNow. As ações disponíveis incluem:
| Categoria | Ação | Descrição |
|---|---|---|
| Gestão de build | Excluir compilação | Exclui uma compilação de um trabalho do servidor Jenkins. |
| Obter ID de compilação | Recupera o ID de compilação de um trabalho executado do servidor Jenkins. | |
| Obter carimbo de data / hora de compilação | Recupera o carimbo de data/hora de compilação de um determinado trabalho do servidor Jenkins. | |
| Obter console Saída | Recupera a saída do console de compilação de um determinado trabalho do servidor Jenkins. | |
| Lista Compilações | Recupera todas as compilações de um determinado trabalho do servidor Jenkins. | |
| Executar compilação com parâmetros | Executa um trabalho com parâmetros no servidor Jenkins. | |
| Obter histórico de compilação | Recupera um intervalo do histórico de compilação de um determinado trabalho do servidor Jenkins. | |
| Obter compilação informações | Recupera o carimbo de data/hora da compilação, o status da compilação e as informações de compilação completas de um determinado trabalho do servidor Jenkins. | |
| Obter compilação número | Recupera o número de compilação de um trabalho do servidor Jenkins com base em um filtro de compilação predefinido, como a última compilação bem-sucedida. | |
| Executar Criar | Executa um trabalho no servidor Jenkins. | |
| Pesquisar compilações por intervalo de datas | Recupera todas as compilações entre o intervalo de datas de um determinado trabalho do servidor Jenkins. | |
| Pesquisar confirmações por compilação | Recupera as confirmações de determinada compilação de um trabalho do servidor Jenkins. | |
| Pesquisar nós da fase por compilação | Recupera informações sobre as ações do Sonar, as fases reinicializáveis e os nós de todas as fases de uma compilação específica de determinado trabalho de pipeline do servidor Jenkins. | |
| Pesquisar fases por compilação | Recupera o status da compilação, hora de início, hora de término, duração e fases de uma compilação específica para um determinado trabalho de pipeline do servidor Jenkins. | |
| Pesquisar relatório de teste por compilação | Recupera informações sobre os resumos de teste, o número total de testes executados, testes aprovados, testes com falha, testes ignorados e tempo necessário para executar testes JUnit em uma compilação específica para um determinado trabalho do servidor Jenkins. | |
| Gestão de configuração | Criar nó | Cria um nó que você pode iniciar com o software Java Web Start. Um nó é uma máquina que faz parte do ambiente do Jenkins e é capaz de executar trabalhos. |
| Excluir nó | Exclui um nó do servidor Jenkins. | |
| Obter versão | Recupera a versão do servidor Jenkins. | |
| Reiniciar Jenkins | Reinicia o servidor Jenkins. | |
| Testar conexão | Testa a conexão com o servidor Jenkins. | |
| Gestão de vagas | Copiar trabalho | Cria um trabalho copiando um trabalho existente do servidor Jenkins. |
| Criar pasta | Cria uma pasta do servidor Jenkins para organizar trabalhos. | |
| Criar trabalho | Cria um trabalho do servidor Jenkins a partir de um arquivo XML. | |
| Excluir pasta | Exclui uma pasta existente do servidor Jenkins. | |
| Excluir trabalho | Exclui um trabalho do servidor Jenkins. | |
| Listar trabalhos por pasta | Recupera todos os trabalhos de uma determinada pasta do servidor Jenkins. | |
| Obter configuração do trabalho | Recupera a configuração XML de um trabalho do servidor Jenkins. | |
| Recarregar Trabalho | Recarrega um trabalho do servidor Jenkins. | |
| Renomear trabalho | Renomeia um trabalho do servidor Jenkins. | |
| Gestão de usuários | Criar usuário | Cria um usuário do servidor Jenkins. |
| Excluir Usuário | Exclui um usuário do servidor Jenkins existente. | |
| Exibir gestão | Adicionar trabalho à exibição | Adiciona um trabalho à exibição do servidor Jenkins. As exibições são contêineres para organizar trabalhos. Conforme uma instância do Jenkins cresce, você pode criar exibições para grupos e categorias apropriados. Por exemplo, você pode criar uma exibição de compilação, que exibe somente trabalhos específicos de compilação. |
| Criar Exibição | Cria uma exibição do servidor Jenkins. | |
| Excluir exibição | Exclui uma exibição do servidor Jenkins. | |
| Listar trabalhos por exibição | Recupera todos os trabalhos de uma exibição no servidor Jenkins. | |
| Remover trabalho da exibição | Remove um trabalho de uma exibição do servidor Jenkins. |
Requisitos de conexão e credencial
Integration Hub 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.
Este spoke usa o registro de alias de conexão e credencial do Jenkins v2 para autorizar ações. Para usar o alias de conexão do spoke, crie um registro de conexão associado e um registro de credencial associado. Para obter informações sobre como configurar o spoke, consulte Configurar o spoke do Jenkins.
Requisitos do MID Server
Essas ações usam chamadas REST, que são executadas em um MID Server. Use o registro de conexão associado ao alias do Jenkins para configurar onde as ações são executadas, bem como definir MID Server atributos de seleção. Para obter mais informações, consulte MID server.