Integrar Jenkins em Velocidade de mudança para DevOps — Espaço

Versão de lançamento: Xanadu

Atualizado 1 de ago. de 2024

5 min. de leitura

Conecte-se à sua instância Jenkins usando o playbook do Espaço de mudança de DevOps para descobrir pipelines.

Antes de Iniciar

Conclua as tarefas especificadas no tópico Comece com Velocidade de mudança para DevOps.

Instale e habilite o plug-in ServiceNow DevOps para Jenkins. Se você já o instalou, atualize para a versão mais recente. Para obter instruções, consulte configure-jenkins-plugin.html.

Função necessária: sn_devops.admin ou sn_devops.tool_owner

Procedimento

Navegar até Espaços > Espaço de mudança de DevOps e use uma das seguintes opções para abrir o playbook para integrar Jenkins.

Você pode conectar uma ferramenta de uma aplicação se também souber quais pipelines específicos devem ser associados e rastreados nessa aplicação para simplificar a configuração. Isso permitirá que você associe e importe facilmente dados de Jenkins.

Opção	Etapas
Página inicial	Selecione Conectar uma ferramenta. No modal Conectar a uma ferramenta, selecione a ferramenta na categoria apropriada. Por exemplo, se você quiser se conectar a Jenkins como uma ferramenta de orquestração, selecione Jenkins na categoria Orquestração.
Módulo de aplicações	Selecione Aplicações ( ) na navegação primária. Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte app-create-workspace.html. No painel Ações recomendadas, selecione o cartão Conectar a uma ferramenta. No modal Conectar a uma ferramenta, selecione a ferramenta na categoria apropriada. Por exemplo, se você quiser se conectar a Jenkins como uma ferramenta de orquestração, selecione Jenkins na categoria Orquestração.
Módulo de ferramentas	Selecione Ferramentas ( ) na navegação primária. Na lista Capacidade, selecione a categoria apropriada. Por exemplo, se você quiser se conectar a Jenkins como uma ferramenta de orquestração, selecione a categoria Orquestração. Selecione Conectar uma ferramenta. No modal Conectar a uma ferramenta, selecione Jenkins.

Importante:

Se você quiser descobrir e rastrear objetos da ferramenta, como pipelines, ao se conectar à ferramenta, deverá conectar sua ferramenta no módulo Aplicação.

No campo Nome da ferramenta, insira um nome para a ferramenta.
Na atividade do playbook de detalhes da instância do Jenkins :
1. Insira o URL da sua instância Jenkins.
2. Insira as credenciais de login (senha, token de acesso ou token de API) da instância Jenkins.
  Para gerar o token de API, consulte Conectar-se a Jenkins usando autenticação de token de API.
3. Se sua instância Jenkins estiver anexada a um MID Server, selecione a opção MID Server e insira seus detalhes.
  Um MID Server será necessário se a instância da ferramenta estiver hospedada no local. Para obter mais informações sobre o MID Server, consulte Seleção de MID Server
Selecione Conectar.
As verificações de permissão são executadas nas credenciais que você inseriu.
As permissões necessárias e as permissões disponíveis são exibidas. Se você quiser inserir credenciais com permissões melhores, selecione Inserir credenciais novamente. Para obter informações detalhadas sobre todas as permissões necessárias, consulte Jenkins permissões em Permissões necessárias para DevOps ferramentas.
Você pode optar por continuar com a conexão da ferramenta mesmo se não tiver todas as permissões necessárias.
Selecione Avançar.
Especifique o acesso para a ferramenta.
1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por.
  As tarefas que esses usuários nos grupos podem executar dependem da função atribuída a eles.
  - DevOps Função de proprietário da ferramenta: pode exibir e editar a ferramenta.
  - DevOps Função de proprietário da aplicação: pode exibir a ferramenta e associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines).
  - DevOps Função de administrador: pode editar todas as ferramentas.
  - Outras funções DevOps : pode exibir a ferramenta.
  Nota:
  Se você não selecionar um grupo e ignorar esta etapa, todos os usuários com a função de proprietário da ferramenta DevOps poderão editar a ferramenta.
2. Se você optar por controlar o acesso à ferramenta, a opção Todos os proprietários de app podem exibir e associar objetos de ferramenta a aplicações ficará disponível para seleção.
  Esta opção permite que todos os usuários com a função de proprietário de app DevOps acessem a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta.
3. Selecione Atribuir.
Instale o plug-in ServiceNow DevOps para Jenkins.

Para obter mais informações sobre a extensão, consulte configure-jenkins-plugin.html.
Selecione Configurar para definir automaticamente a configuração de DevOps da ServiceNow na sua instância Jenkins.
Importante:
Você deve primeiro instalar e habilitar o plug-in ServiceNow DevOps para Jenkins. Se você já o instalou, atualize para a versão mais recente. Para obter instruções, consulte configure-jenkins-plugin.html.

Para configurar webhooks automaticamente, o acesso de administrador Jenkins é necessário.

Se você optar por configurar automaticamente esta ferramenta, a configuração existente para a configuração do ServiceNow DevOps em Jenkins será substituída.

Você pode adicionar um total de dez configurações da ServiceNow.
Figura 1. Define automaticamente a configuração do ServiceNow DevOps no Jenkins

Para configurar webhooks manualmente no Jenkins, consulte Configurar webhooks manualmente para Jenkins.

Você também pode habilitar a pesquisa noturna para recuperar dados de quaisquer pipelines rastreados selecionando a opção Habilitar propriedade de pesquisa no módulo Administração. Consulte Propriedades Velocidade de mudança para DevOps.
Importante:
Se você estiver se conectando pela página inicial ou pelo módulo Ferramentas, a conexão será concluída e você será direcionado para a página Resumo.

Se você estiver se conectando do módulo Aplicações, os pipelines disponíveis em sua instância serão descobertos. Você pode rastrear e importar dados históricos deles.
Selecione os pipelines que você deseja rastrear na atividade do playbook Selecionar pipelines.
Para cada pipeline selecionado, todas as etapas são importadas para a última execução bem-sucedida.
Opcional: Na atividade Atribuir serviços a etapas de pipeline, especifique Tipo de etapa e Serviço para cada etapa de pipeline.

A conclusão desta etapa como parte da integração da ferramenta permite que os painéis Insights de DevOps mostrem dados mais significativos imediatamente.
Se você quiser importar dados de pipeline, selecione o intervalo de datas e selecione Enviar.
Na página Resumo, selecione Exibir registro da ferramentapara revisar os detalhes da ferramenta Jenkins conectada.

Nota:
Se a credencial da ferramenta tiver sido alterada, você deverá atualizar as credenciais na instância ServiceNow. Para obter mais informações, consulte Atualizar credenciais da ferramenta de terceiros em Velocidade de mudança para DevOps.

Resultado

Você integrou com sucesso sua ferramenta [ Jenkins a Velocidade de mudança para DevOps.