Estado da solicitação de mudança do ServiceNow DevOps nos logs de pipeline do Jenkins

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Você pode usar o utilitário Gerador de Snippet do Jenkins para configurar como e quando o estado de mudança e as condições de política correspondentes devem ser exibidos nos logs de trabalho do pipeline do Jenkins. Isso permite que os desenvolvedores exibam o status da mudança nos logs do console do próprio pipeline.

    Para gerar um snippet de etapa, navegue até a Sintaxe do Pipeline a partir de um pipeline configurado, selecione a etapa SnDevOpsChange na lista Etapa de Amostra e atualize os valores das variáveis de estado de mudança na etapa. Selecione a opção ignorar erro para evitar falha no trabalho se houver um erro. Selecione Gerar script de pipeline para criar um snippet. Você pode copiar e colar o snippet no pipeline para começar a receber as notificações de estado de mudança. Atualize as seguintes variáveis na etapa SnDevOpsChange para receber notificações de estado de mudança:
    • Intervalo de pesquisa: especifica a frequência (em segundos) na qual o Jenkins pesquisa o status de mudança na ServiceNow e atualiza os logs do console com o status. O status de mudança é atualizado nos logs do console somente quando as transições de estado de mudança, atualizações de grupo de atribuição, atualizações de aprovação, data de início/término planejadaou detalhes da mudança (se houver) são atualizados.
      Nota:
      Se nenhum valor for inserido no campo, a verificação do intervalo de pesquisa não será executada para atualizar o status de mudança nos logs do console.
    • Tempo limite de criação de mudança: especifica o valor do tempo limite de criação de mudança em segundos. No tempo limite, o Jenkins verifica o status de criação da mudança na ServiceNow. Se a mudança não tiver sido criada, o pipeline será retomado ou anulado com base no sinalizador Anular na falha de criação da mudança. Por padrão, o pipeline é anulado quando o tempo limite é especificado e o sinalizador Anular na falha de criação de mudança é selecionado.
      Nota:
      Se nenhum valor for inserido no campo, a verificação de tempo limite de criação de mudança não será executada para atualizar o pipeline.
    • Anular em caso de falha na criação da mudança: anula ou retoma o pipeline se a mudança não for criada até o tempo limite de criação da mudança.
      • Selecionado: Anular
      • Limpo: Retomar
    • Tempo limite da etapa de mudança: especifica o valor do tempo limite da etapa de mudança em segundos. No tempo limite, o Jenkins verifica o status da etapa de mudança na ServiceNow. Se a etapa de mudança ainda estiver em andamento, o pipeline será retomado ou anulado com base no sinalizador Anular na etapa de mudança. Por padrão, o pipeline é anulado quando o tempo limite é especificado e o sinalizador Anular no tempo limite da etapa de mudança é selecionado.
      Nota:
      Se nenhum valor for inserido no campo, a verificação de tempo limite da etapa de mudança não será executada para atualizar o pipeline.
    • Anular no tempo limite da etapa de mudança: anula ou retoma o pipeline se a etapa de mudança ainda estiver em andamento no tempo limite da etapa de mudança.
      • Selecionado: Anular
      • Limpo: Retomar

    Você pode navegar até os logs do console no pipeline para exibir o estado de uma solicitação de mudança quando uma solicitação de mudança é criada ou quando o estado da solicitação de mudança é atualizado. As condições de política associadas ao estado da solicitação de mudança também serão avaliadas e exibidas nos logs. Por exemplo, se a política de automação avançada de solicitação de mudança do DevOps estiver ativada, as condições da política serão avaliadas e a decisão correspondente tomada (aprovação automática/rejeição automática/aprovação manual) será exibida nos logs.

    Os seguintes detalhes da solicitação de mudança são exibidos:
    • número
    • detalhes
    • status
    • sys_id
    • tipo
    • risco
    • prioridade
    • changeState
    • planeamentoInícioDate
    • planejadoEndDate
    • changeRequestURL

    Logs de estado de mudança no console de pipeline do Jenkins

    Os logs das condições de política serão exibidos para os fluxos de mudança do sistema de base da seguinte forma:
    • Política de mudança do modelo de DevOps: somente os logs serão exibidos na criação da mudança e quando o estado da mudança for atualizado.
    • Política de automação mínima de solicitação de mudança de DevOps: serão exibidos os logs junto com a decisão de mudança e as condições de política correspondentes à decisão de mudança.
    • Política de automação avançada de solicitação de mudança de DevOps: os logs junto com a decisão de mudança e as condições de política correspondentes à decisão de mudança serão exibidos.
    A entrada da política de mudança e as condições de decisão são armazenadas na tabela Decisões [sys_decision_question]. Os logs serão exibidos se os seguintes campos e operadores forem usados como entrada para as condições da política:
    Campos
    • code_coverage
    • commits_without_work_item
    • integration_tests_failed
    • load_tests_failed
    • regression_tests_failed
    • num_of_outages_in_last_7_days
    • num_of_current_outages
    • num_of_open_incidents
    • total_num_of_commits
    • tests_passing_percent
    • risco
    • code_security
    • confirmações
    Operadores
    • <=
    • >=
    • !=
    • =
    • <
    • >
    • ISNOTEMPTY
    • ISEMPTY
    • ENTRE
    • ANYTHING
    • NSAMEAS
    • SAMEAS
    • GT_FIELD
    • LT_FIELD
    Nota:
    Se algum campo for modificado em uma política de mudança diferente dos campos do sistema de base, esses campos deverão ser adicionados manualmente ao fluxo para que as condições da política sejam avaliadas.

    Se uma solicitação de mudança não for criada devido a algum problema, o motivo da falha e o estado também serão registrados no console.