Use a extensão [ ServiceNow DevOps para ações personalizadas Azure DevOps e Azure DevOps

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 8 min. de leitura

    • Instale e configure a extensão [ DevOps para Azure DevOps para enviar notificações de compilação e versão do pipeline do Azure para Velocidade de mudança para DevOps.

    Antes de Iniciar

    Função necessária: sn_devops.admin

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode usar a extensão do ServiceNow DevOps no Visual Studio Marketplace - Extensões para Azure DevOps para integrar o pipeline do Azure com a aplicação ServiceNow DevOps. Para obter mais informações sobre artefatos e pacotes em Velocidade de mudança para DevOps, consulte Artefatos e pacotes.

    • Conexão de serviçodo ServiceNow DevOps

      Necessário para conectar o pipeline do Azure a ServiceNow

    • Portal de versão do ServiceNow DevOps

      Necessário para habilitar o controle de mudanças nos pipelines de versão (CD) do Azure (somente em condições de pré-implantação).

    Tarefas personalizadas do pipeline de compilação (CI) do Azure:
    • Trabalho sem agente (servidor)
      • Tarefa personalizada deregistro de artefato do servidor do ServiceNow DevOps

        Necessário para trabalhos sem agente (servidor) para registrar um artefato na instância ServiceNow

      • Tarefa personalizada deregistro de pacote de servidor do ServiceNow DevOps

        Necessário para trabalhos sem agente (servidor) para registrar um pacote na instância ServiceNow

      • Tarefa personalizadada Aceleração de mudança de servidor do ServiceNow DevOps

        Necessário para trabalhos sem agente (servidor) para criar automaticamente uma solicitação de mudança em ServiceNow Gestão de mudanças como parte do pipeline do Azure.

        Nota:
        A tarefa de Aceleração de mudança do ServiceNow DevOps Server não requer tarefas de notificação de trabalho do ServiceNow DevOps Server.
      • Tarefa personalizadaObter mudança do servidor do ServiceNow DevOps

        Necessário para recuperar o número da solicitação de mudança em um pipeline com base em detalhes de mudança específicos para um trabalho do servidor.

      • Tarefa personalizada demudança de atualização de servidor do ServiceNow DevOps

        Necessário para atualizar os detalhes da solicitação de mudança associados a um pipeline para um trabalho do servidor.

    • Trabalho de agente
      • Tarefa personalizada deregistro de artefato do agente do ServiceNow DevOps

        Necessário para trabalhos de agente para registrar um artefato na instância ServiceNow

      • Tarefa personalizada deregistro do pacote do agente do ServiceNow DevOps

        Necessário para que trabalhos de agente registrem um pacote na instância ServiceNow

      • Tarefa personalizadaObter mudança do agente do ServiceNow DevOps

        Necessário para recuperar o número da solicitação de mudança em um pipeline com base em detalhes de mudança específicos para um trabalho de agente.

      • Tarefa personalizada demudança de atualização do agente do ServiceNow DevOps

        Necessário para atualizar os detalhes da solicitação de mudança associados a um pipeline para um trabalho de agente.

      Nota:
      As tarefas Registro de artefato do agente doServiceNow DevOps e Registro de pacote do agente do ServiceNow DevOps não são compatíveis com pipelines de versão.
    • Verificações de qualidade de software (SonarQube/SonarCloud)
      • Tarefa personalizada deregistro do Sonar de compilação da ServiceNow DevOps (para pipelines de compilação)
      • Tarefa personalizada deregistro do Sonar da versão do ServiceNow DevOps (para pipelines de versão)
      Nota:
      A tarefa de registro do Sonar de compilação da ServiceNow DevOps não é compatível com pipelines de versão.
    • Verificações de segurança:
      • Tarefa personalizadados resultados de segurança da compilação do ServiceNow DevOps (para pipelines de compilação)
      • Tarefa personalizadade resultados de segurança da versão do ServiceNow DevOps (para pipelines de versão)
      Nota:
      A tarefa Resultado de segurança da compilação da ServiceNow DevOps não é compatível com pipelines de versão.

    Procedimento

    1. Acesse o Visual Studio Marketplace, pesquise a extensão do ServiceNow DevOps e clique em Obter gratuitamente.
      Extensão do DevOps Azure
    2. Selecione sua organização Azure DevOps e clique em Instalar.
    3. No seu projeto Azure DevOps, navegue até Configurações do projeto > Pipelines > Conexões de serviço.
    4. Selecione Nova conexão de serviço e, na lista, selecione ServiceNow DevOps.
    5. Selecione Avançar e insira os seguintes detalhes:
      Método de autenticação Selecione se a autenticação é feita por meio do método baseado em token ou básico.
      Instância da ServiceNow

      https://<your-instance> .service-now.com/
      ID da ferramenta

      O sys_id da ferramenta de orquestração.

      Você pode copiar este valor usando o comando Copiar sys_id no formulário da Ferramenta de Orquestração. Se você estiver usando o espaço, selecione Mais opções de formulário ( ícone Mais opções de formulário) > Copiar sys_id no formulário de conexão da ferramenta Azure DevOps. Se você estiver usando o Catálogo de serviços ou o Clássico, selecione Ações adicionais (ícone Ações adicionais) > Copiar sys_id no formulário de conexão da ferramenta Azure DevOps.
      Nome de usuário Insira devops.integration.user.
      Senha Senha do usuário de integração de DevOps.
      Token de API Token de API para conexão com o endpoint.
      Nome da conexão de serviço Inserir conexão de DevOps
      Conceder permissão de acesso a todos os pipelines Marque a caixa de seleção.

    Exemplo

    Figura 1. Pipeline do Azure - Método de autenticação básica da conexão de serviço do ServiceNow DevOps
    Nova conexão de serviço no Azure DevOps para o método de autenticação básica
    Figura 2. Pipeline do Azure - Método de autenticação baseado em token de conexão de serviço do ServiceNow DevOps
    Nova conexão de serviço no Azure DevOps para o método de autenticação baseada em token

    Configurar um pipeline de compilação (CI) do Azure no DevOps

    Use a extensão [ ServiceNow DevOps para Azure DevOps para configurar controle de mudança e artefatos e pacotes em seu pipeline de compilação (CI) do Azure.

    Antes de Iniciar

    Função necessária: sn_devops.admin

    Procedimento

    1. Navegue até Pipelines na sua instância do Azure DevOps.
    2. Selecione o pipeline para o qual você deseja habilitar o controle de mudanças.
    3. Selecione Exibir.
      O editor YAML do pipeline é exibido junto com o painel de pesquisa de tarefas à direita.
    4. Pesquise a ação personalizada necessária no painel Tarefas e selecione-a.
      Ação personalizada Etapas
      ServiceNow DevOps Server Change Acceleration
      1. No campo Nome de exibição, insira ServiceNow Change Acceleration.
      2. No campo de endpoint da ServiceNow, insira Minha conexão.
      3. No campo Trabalho ascendente executado, insira o valor que indica o trabalho anterior na linha. Por exemplo, o trabalho antes do Servidor pode ser Teste.
      4. No campo Detalhes da solicitação de mudança, defina o código de fechamento e os campos da solicitação de mudança de dentro do pipeline.
      Selecione o ícone de informações para exibir a saída de amostra.

      Para obter mais informações sobre a aceleração de mudanças, consulte aceleração de mudanças.
      Registro de artefatos do agente do ServiceNow DevOps
      1. No campo de endpoint da ServiceNow, insira Minha conexão.
      2. No campo Carga de artefatos, insira o JSON que contém a lista de artefatos.
      Para obter mais informações sobre artefatos, consulte Artefatos e pacotes.
      Registro de pacote do agente do ServiceNow DevOps
      1. No campo de endpoint da ServiceNow, insira Minha conexão.
      2. No campo Nome do pacote, insira o nome do pacote que contém artefatos.
      3. No campo Carga de artefatos, insira o JSON que contém os detalhes da compilação e a lista de artefatos.
      Para obter mais informações sobre artefatos, consulte Artefatos e pacotes.
      Obter mudança do servidor do ServiceNow DevOps update-change-request-details-in-an-azure-devops-pipeline.html
      Mudança de atualização do servidor do ServiceNow DevOps update-change-request-details-in-an-azure-devops-pipeline.html
      Obter mudança do agente de DevOps da ServiceNow update-change-request-details-in-an-azure-devops-pipeline.html
      Mudança de atualização do agente de DevOps da ServiceNow update-change-request-details-in-an-azure-devops-pipeline.html
    5. Selecione Adicionarpara adicionar a tarefa personalizada à seção Tarefas do pipeline do Azure.

    Exemplo

    Figura 3. Pipeline do Azure: tarefa personalizada da Aceleração de mudanças para DevOps da ServiceNow
    Extensão de mudança do DevOps Azure
    Extensão do Change Acceleration da ServiceNow para DevOps

    Azure DevOps tarefas personalizadas do servidor

    Figura 4. Exemplo de detalhes da solicitação de mudança
    Detalhes da mudança do DevOps Azure

    Configurar um pipeline de CD (versão) do Azure em DevOps

    Use a extensão [ ServiceNow DevOps para Azure DevOps para configurar o controle de mudanças e artefatos e pacotes no pipeline da versão (CD) do Azure.

    Antes de Iniciar

    Função necessária: sn_devops.admin

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    O controle de mudanças nos pipelines de versão (CD) do Azure é compatível somente com portas de pré-implantação. As solicitações de mudança do portal de pré-implantação são mapeadas para a execução da etapa do primeiro trabalho nessa fase.

    As fases em um pipeline de versão do Azure são mapeadas para uma etapa. O nome da etapa de um trabalho de várias configurações ou vários agentes deve incluir somente o nome da fase e não o nome do trabalho real derivado no tempo de execução do pipeline.

    As execuções de tarefas para trabalhos ignorados são marcadas como falhas.

    Procedimento

    1. Em Azure DevOps Pipelines, navegue até o pipeline de versão e abra a janela Condições de pré-implantação.
    2. Habilite a configuração de Portões e clique em +Adicionar.
    3. Clique no Portal da versão do ServiceNow DevOps e selecione o endpoint da ServiceNow.
    4. Saia da configuração do portal da versão e expanda a seção Opções de avaliação para configurar os campos de tempo.
      Tempo entre reavaliações de portas

      Intervalo de reavaliação em minutos, horas ou dias.

      Se a solicitação de mudança for cancelada ou rejeitada, o portal de versão do pipeline do Azure continuará reavaliando o status da solicitação de mudança no intervalo configurado até o tempo limite.

      Nenhuma intervenção do usuário é necessária para novas tentativas de reavaliação depois que a solicitação de mudança já foi aprovada, rejeitada ou cancelada.
      Tempo limite após o qual as portas falham Valor de tempo limite em minutos, horas ou dias.

      Se as condições de pré-implantação falharem, os trabalhos subsequentes da fase serão marcados como com falha e a hora de início e de término será padronizada como a hora atual do sistema.
    5. Opcional: Configure artefatos no pipeline da versão (CD) do Azure.
      Para configurar artefatos usando o pipeline de compilação como origem, esses nomes devem corresponder.
      • Nome do repositório e nome do pipeline de compilação (por exemplo, DeployableRepo).
      • Propriedade de nome do artefato do pipeline de compilação e propriedade de alias de origem do artefato do pipeline de versão (por exemplo, BuildDrop).
      Além do pipeline de compilação, você pode selecionar artefatos de quaisquer outras oito origens. Para rastrear detalhes de confirmação e item de trabalho, siga estas regras.
      • Quando a origem é o pipeline de compilação, a propriedade da versão semântica dos artefatos deve estar no formato MAJOR.MINOR.PATCH (por exemplo, 5.1.3).
      • Quando a origem não for o pipeline de compilação, defina uma versão semântica implementando a interface de extensão DevOpsArtifactSemanticVersionAPI.

      Consulte Artefatos e pacotes para obter mais informações sobre artefatos.

    Exemplo

    Figura 5. ServiceNow DevOps extensão para Azure DevOps - Versão do portal
    Porta de versão do ServiceNow DevOps para Azure DevOps
    Figura 6. Configuração do portal de pré-implantação do pipeline de versão do Azure
    Configuração de portal do Azure para DevOps
    Figura 7. Configuração do artefato - criar origem do pipeline
    Configuração de YAML de artefato de DevOps
    Figura 8. Configuração do artefato - pipeline de versão
    Configuração de pipeline de artefato de DevOps