Ações personalizadas do ServiceNow DevOps do mercado do GitHub

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 8 min. de leitura
  • Use as ações personalizadas do mercado GitHub para coletar dados de verificação do SonarQube, dados de segurança, pausar ou retomar o fluxo de trabalho ou retomar o fluxo de trabalho até que uma solicitação de mudança seja aprovada ou rejeitada em sua instância, ou obter e atualizar detalhes da solicitação de mudança e assim por diante.

    Como alternativa, você pode usar imagens de contêiner do Docker para implementar ações personalizadas para GitHub Actions pipelines. Para obter mais informações, consulte Implementar ações personalizadas para pipelines usando a imagem de contêiner genérica do Docker.

    Ação personalizada do SonarQube do ServiceNow DevOps

    Salve os resultados da verificação do SonarQube de um projeto iniciado pela execução do fluxo de trabalho em sua instância ServiceNow. Você deve criar a ferramenta SonarQube em sua instância e usar a ação personalizada ServiceNow DevOps do SonarQube no nível de etapas de um trabalho no fluxo de trabalho.

    Exiba os resultados da análise do SonarQube usando um dos seguintes métodos:
    • Navegar até DevOps > Resultados de qualidade do software > Resumo da qualidade do software.
    • Navegar até DevOps > Orquestrar > Execução de tarefa e selecionando um registro de execução de tarefa relevante.
    Execute as tarefas a seguir para usar a ação personalizada.
    • Crie a ferramenta SonarQube em sua instância.

      Gerar token de Usuário > Minha conta > Segurança página na ferramenta SonarQube e crie a ferramenta na instância ServiceNow usando o token gerado. Para obter mais informações, consulte Integrar SonarQube a Velocidade de mudança para DevOps — Espaço e Integrar SonarQube em Velocidade de mudança para DevOps — Clássico.

    • Crie os seguintes segredos para salvar os resultados da verificação do SonarQube na instância ServiceNow.
      • SONAR_HOST_URL: URL da instância do SonarQube. Por exemplo, https://sonarcloud.io
      • SONAR_PROJECT_KEY: a chave para identificar um projeto na instância do SonarQube. Por exemplo, org.examples:demo
    • Configure a ação personalizada ServiceNow DevOps do SonarQube no fluxo de trabalho.

      A ação personalizada servicenow-devops-sonar deve ser configurada no nível de etapas do trabalho no fluxo de trabalho com a palavra-chave usa. As entradas desta ação personalizada não devem ser adulteradas para salvar os resultados da análise do SonarQube na instância ServiceNow. Para obter mais informações, consulte ServiceNow DevOps Sonar.

    Ação personalizada do relatório de teste de DevOps da ServiceNow

    Salve os resultados de testes de unidade do projeto iniciado pela execução do fluxo de trabalho em sua instância ServiceNow. A ação personalizada ServiceNow DevOps de relatório de teste deve ser usada no nível de etapas do trabalho no fluxo de trabalho.

    Exiba os resultados de testes de unidade salvos em sua instância ServiceNow navegando até DevOps > Resultados de testes > Resumos do teste.

    Você também pode exibir navegando até DevOps > Orquestrar > Execução de tarefa e clicando em um registro de execução de tarefa relevante.

    Execute as tarefas a seguir para usar a ação personalizada.
    • Crie segredos no repositório GitHub.
    • Configure a ação personalizada DevOps de relatório de teste no fluxo de trabalho.

      A ação personalizada servicenow-devops-test-report deve ser configurada no nível de etapas do trabalho no fluxo de trabalho com a palavra-chave usa. As entradas desta ação personalizada não devem ser adulteradas para salvar os resultados de testes de unidade em sua instância ServiceNow. Para obter mais informações, consulte Relatório de teste de DevOps da ServiceNow.

    Ação personalizada do artefato de registro do ServiceNow DevOps

    Salve artefatos criados ou implantados pela execução do fluxo de trabalho em sua instância ServiceNow. Use a ação personalizada ServiceNow DevOps Registrar artefato no nível de etapas do trabalho no fluxo de trabalho.

    Exiba os detalhes dos artefatos salvos em sua instância navegando até DevOps > Artefato > Artefatos.

    Execute as seguintes tarefas para usar a ação personalizada:
    • Crie segredos no repositório GitHub.
    • Configure ServiceNow DevOps Registrar ação personalizada do artefato no fluxo de trabalho.

      A ação personalizada servicenow-devops-register-artifact deve ser configurada no nível de etapas do trabalho no fluxo de trabalho com a palavra-chave usa. As entradas desta ação personalizada não devem ser adulteradas para salvar detalhes do artefato em sua instância. Para obter mais informações, consulte Artefatos de registro do ServiceNow DevOps.

    Ação personalizada do pacote de registro do ServiceNow DevOps

    Salve pacotes criados ou implantados pela execução do fluxo de trabalho na instância ServiceNow. Use a ação personalizada ServiceNow Registrar pacote de DevOps no nível de etapas do trabalho no fluxo de trabalho.

    Exiba os detalhes do pacote salvos na instância ServiceNow navegando até DevOps > Artefato > Pacotes.

    Execute as tarefas a seguir para usar a ação personalizada.
    • Crie segredos no repositório GitHub.
    • Configure ServiceNow DevOps Registrar ação personalizada do artefato no fluxo de trabalho.

      A ação personalizada servicenow-devops-register-package deve ser configurada no nível de etapas do trabalho no fluxo de trabalho com a palavra-chave usa. As entradas desta ação personalizada não devem ser adulteradas para salvar detalhes do artefato em sua instância. Para obter mais informações, consulte Pacote de registro do ServiceNow DevOps.

    Ação personalizada da Automação de mudança para DevOps da ServiceNow

    Crie uma solicitação de mudança na instância ServiceNow para pausar e retomar a execução do fluxo de trabalho na instância ServiceNow.

    Use a ação personalizada ServiceNow DevOps Change Automation no nível de etapas do trabalho no fluxo de trabalho. Se a mudança não for criada dentro do período especificado no limite (changeCreationTimeOut) e o parâmetro abortOnChangeCreationFailure estiver habilitado, o pipeline será anulado.

    Esta ação personalizada cria uma solicitação de mudança em ServiceNow, habilita a opção Controle de mudanças e pesquisa a instância ServiceNow no intervalo de tempo definido para status de mudança até que a mudança seja aprovada ou rejeitada ou o limite de tempo limite (tempo limite) seja atingido. GitHub anula a execução do fluxo de trabalho se o limite de tempo limite for atingido e o parâmetro abortOnChangeStepTimeout estiver habilitado. Console de ações do GitHub - tempo limite da etapa de mudança

    Esta ação personalizada retoma imediatamente a execução do fluxo de trabalho quando o recibo de mudança está habilitado para o pipeline em ServiceNow sem aguardar a aprovação ou rejeição da mudança na instância ServiceNow.

    Exiba a mudança criada para a execução do fluxo de trabalho na instância ServiceNow navegando até DevOps > Orquestrar > Solicitações de Mudança de Pipeline.

    O número de mudança com status pending_decision é exibido no console de ações GitHub durante a pesquisa de status de mudança na instância ServiceNow. Detalhes como comentários de mudança, aprovado por, aprovado em e status são registrados no console de Ações GitHub depois que a mudança é aprovada, rejeitada ou cancelada pelo usuário na instância ServiceNow. Console de ações do GitHub - mudança aprovada

    Você pode navegar até os logs do console em seu pipeline para exibir o estado de uma solicitação de mudança quando uma solicitação de mudança for criada. Os detalhes da mudança serão exibidos de acordo com o intervalo de tempo de pesquisa. 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

    Mudar estado nos logs do console de pipeline do GitHub

    Nota:
    changeState é o estado da solicitação de mudança e status é o status da execução da etapa.
    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.
    Execute as tarefas a seguir para usar a ação personalizada.
    • Crie segredos no repositório GitHub.
    • Configure a ação personalizada ServiceNow DevOps de automação de mudança no fluxo de trabalho.

      A ação personalizada servicenow-devops-change deve ser configurada no nível de etapas do trabalho no fluxo de trabalho com a palavra-chave usa. As entradas desta ação personalizada não devem ser adulteradas para criar mudanças em sua instância e pesquisar o status de mudança a cada número de segundos. Para obter mais informações, consulte ServiceNow DevOps change automation.

    ServiceNow DevOps - Obter ação do GitHub de mudança

    Recupere o número da solicitação de mudança em um pipeline de Ações do GitHub com base em detalhes de mudança específicos.

    A ação personalizada Obter ação do GitHub de mudança do ServiceNow DevOps deve ser adicionada no nível da etapa em um trabalho de pipeline para recuperar o número da solicitação de mudança de uma instância da ServiceNow especificando detalhes da mudança.

    Ação do Github de mudança de atualização do ServiceNow DevOps

    Atualize os detalhes da solicitação de mudança associados a um pipeline de ações do GitHub.

    A ação personalizada do GitHub de atualização de mudança do ServiceNow DevOps deve ser adicionada no nível da etapa em um trabalho de pipeline para atualizar a solicitação de mudança em uma instância da ServiceNow. O número da solicitação de mudança cujos detalhes precisam ser atualizados e os detalhes da solicitação de mudança a serem atualizados devem ser especificados como entrada.

    Ação de resultados de segurança do ServiceNow DevOps

    Recupere os resultados da verificação de segurança na ServiceNow.

    A ação personalizada dos resultados de segurança do ServiceNow DevOps deve ser adicionada no nível da etapa em um trabalho de pipeline para recuperar os resultados da verificação de segurança na ServiceNow.