Modelar um pipeline Jenkins em DevOps

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • Modele um Jenkins pipeline mapeando o pipeline para um app e mapeando DevOps etapas do pipeline para Jenkins fases.

    Antes de Iniciar

    O plug-in Jenkins para ServiceNow DevOps é fornecido para habilitar a aceleração de mudanças para que sua ferramenta de orquestração possa se comunicar com ServiceNow DevOps e controlar determinados aspectos das execuções de pipeline.

    Instale o plug-in do Jenkins Marketplace. Navegue até Gerenciar Jenkins > Configuração do sistema > Plug-ins na sua instância do Jenkins. Pesquise o plug-in ServiceNow DevOps e selecione-o e, em seguida, selecione Instalar.

    Função necessária: sn_devops.admin

    Por Que e Quando Desempenhar Esta Tarefa

    Pipelines com script (Jenkinsfile) e trabalhos de estilo livre são compatíveis.

    Para pipelines do Jenkinsfile, as etapas do pipeline são criadas, mapeadas e associadas a tarefas de orquestração automaticamente, em vez de manualmente.

    Procedimento

    1. Mapeie seu pipeline para um app em DevOps.
      1. Navegar até DevOps > Aplicações e pipelines > Apps e abra o registro da aplicação para associar ao pipeline.
      2. Na lista relacionada Pipelines, clique em Editar... para selecionar um pipeline a ser associado à aplicação ou clique em Novo para criar o pipeline.
        Para um novo pipeline, preencha o campo Pipeline de Orquestração usando o nome completo do projeto conforme especificado no Jenkins.
        Nota:
        Ao associar um pipeline a um app, as etapas do pipeline também são obtidas durante a importação.
      3. Clique em Enviar.
    2. Abra o registro do pipeline novamente e marque a caixa de seleção Rastrear para que os eventos do pipeline sejam recebidos.
      Nota:
      A caixa de seleção Rastrear deve ser marcada para integrar o pipeline com DevOps.
    3. Crie DevOps etapas automaticamente ou manualmente para mapear para cada Jenkins fase do pipeline para que uma tarefa de orquestração seja criada.
      • Para pipelines declarativos ou com script, execute o pipeline Jenkins para criar e mapear automaticamente as etapas do pipeline em DevOps.

        As etapas do pipeline são criadas, mapeadas e associadas automaticamente quando DevOps recebe notificações de etapa do pipeline do Jenkins durante a execução.

      • Para trabalhos de estilo livre, crie e mapeie manualmente cada etapa de pipeline para um trabalho de pipeline Jenkins.

        Na lista relacionada Etapas, clique em Novo para criar uma etapa DevOps para cada fase do pipeline Jenkins (campoFase de Orquestração )

        Nota:
        O valor do campo da fase Orquestração de cada etapa faz distinção entre maiúsculas e minúsculas e deve corresponder ao nome original da fase do pipeline Jenkins correspondente.
        Nome Nome da etapa do pipeline.
        Pipeline Pipeline no qual a etapa está configurada.
        Tipo Tipo de etapa do pipeline.
        • Criar e Testar
        • Teste
        • Implantar
        • Implantar e Testar
        • Manual
        • Implantação de Produção
        Pedido

        Ordem na qual as etapas são executadas.

        Nota:
        A ordem das etapas determina a ordem dos cartões na IU do pipeline.

        A ordem dos cartões na IU do pipeline é por execução de tarefa.
        Fase de orquestração

        Jenkins nome da fase do pipeline (diferencia maiúsculas de minúsculas).

        Nota:
        Para associação de etapa com Jenkins fases de pipeline, o campo Fase de Orquestração deve ser configurado.
        Serviço de negócios Serviço de configuração que se aplica à etapa.

        Depois que as tarefas de orquestração forem criadas, associe cada tarefa de orquestração na lista relacionada Tarefas de Orquestração a uma etapa de pipeline DevOps.

    4. Opcional: Habilite o controle de mudanças automaticamente ou manualmente com base no tipo de pipeline.
      • Para pipelines declarativos ou com script, se você tiver usado o script snDevOpsChange no pipeline, execute o pipeline Jenkins para habilitar automaticamente o controle de mudanças. Você também pode habilitar o controle de mudanças manualmente seguindo as etapas fornecidas para trabalhos de estilo livre.
      • Para trabalhos de estilo livre, marque a caixa de seleção Controle de mudança em uma etapa para habilitar a aceleração de mudança e os campos de configuração correspondentes.
        Nota:
        O Gestão de mudanças da ServiceNow deve ser instalado para a aceleração de mudanças.
        Alterar recebimento

        Selecione para habilitar o recibo de mudança para a etapa para que o pipeline não seja pausado quando uma solicitação de mudança for criada.

        Todos os dados do pipeline estão incluídos na mudança, mas a aprovação não é necessária para que o pipeline prossiga.
        Mudar grupo de aprovação

        Grupo de aprovação da solicitação de mudança.

        O grupo de aprovação de mudança se torna o grupo de atribuição na solicitação de mudança DevOps.

        Nota:
        Certifique-se de que o grupo selecionado tenha membros e um gerente de grupo para que o campo do aprovador não fique em branco.
        Tipo de mudança Tipo de solicitação de mudança a ser criado.
        • Normal (padrão)
        • Padrão
        • Emergência
        Modelo de mudança Modelo de mudança para a solicitação de mudança. Para obter mais informações, consulte DevOps modelos de mudança.

        Modelo

        Nota:
        Este campo é mostrado somente quando o tipo de mudança é Normal ou Emergência.

        Lista de modelos a serem usados para preencher automaticamente os campos das solicitações de mudança Normal ou Emergencial.

        Selecione um modelo ou crie um novo.

        Modelo de mudança padrão

        Nota:
        Este campo é mostrado somente quando o tipo de mudança é Padrão.
        		 Lista de modelos de mudança padrão a serem usados para solicitações de mudança padrão.
        Nota:
        Este campo é obrigatório para o tipo de mudança padrão.
        Mudar filiais controladas

        (Somente várias filiais) Lista separada por vírgulas de ramificações sob controle de mudança. Caracteres curinga são compatíveis.
    5. Navegar até DevOps > Ferramentas > Ferramentas de Orquestração e no registro da ferramenta Jenkins, copie o valor do campo DevOps URL do Webhook.
      A URL do webhook contém o local DevOps para Jenkins enviar mensagens, incluindo o sys_id da ferramenta:

      https://<devops.integration.user> :<password> @<your-instance> .service-now.com/api/sn_devops/v1/devops/tool/event/{sys_id do registro}

    Exemplo

    Figura 1. app DevOps
    Pipeline de DevOps
    Figura 2. DevOps pipeline
    Etapas do pipeline de DevOps
    Figura 3. DevOps etapa do pipeline
    Fases do pipeline de DevOps