Integrar o Azure Pipelines com o gerenciamento de alterações do ServiceNow

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Para melhorar a colaboração entre as equipas de desenvolvimento e de TI, o Azure Pipelines suporta a integração com o ServiceNow. As equipes podem reduzir os riscos associados às alterações e seguir metodologias de gerenciamento de serviços, como ITIL (Information Technology Infrastructure Library), incluindo portas de gerenciamento de alterações em pipelines de liberação.

Neste tutorial, irá aprender a:

Pré-requisitos

• Tenha uma conta HI em uma instância não desenvolvedora do ServiceNow.
• Tenha uma organização e um projeto do Azure DevOps com permissões no nível da organização para instalar extensões.
• Tenha uma pipeline de lançamento Classic ou uma pipeline YAML que faz a implementação num ambiente no seu projeto do Azure DevOps.
• Certifique-se de entender e seguir os procedimentos em Usar portas e aprovações para controlar sua implantação e Definir aprovações e verificações.

Configurar a instância ServiceNow

1. Instale a extensão Azure Pipelines em sua instância ServiceNow. Consulte Visão geral da compra para obter mais detalhes sobre a instalação de aplicativos da loja ServiceNow. Você precisa de credenciais HI para concluir a instalação.

2. Em ServiceNow, crie um novo usuário para a Conta de Serviço do Azure Pipelines e conceda a ele a função x_mioms_azpipeline.pipelinesExecution .

   

Configurar a organização e o projeto do Azure DevOps

1. Em sua organização do Azure DevOps, instale a extensão ServiceNow Change Management.

   

2. Em seu projeto do Azure DevOps, crie uma nova conexão de serviço ServiceNow usando a autenticação Básica ou a autenticação OAuth2. Para obter mais informações, consulte Criar uma conexão de serviço.

   

Configurar a linha de processamento

Você pode adicionar a integração do ServiceNow a um pipeline de lançamento Classic ou a um pipeline YAML que implementa em um ambiente.

Definir configurações de Gerenciamento de Alterações do ServiceNow

1. Na tela ServiceNow Change Management settings, em ServiceNow connection, selecione a conexão de serviço ServiceNow que você criou anteriormente.

   

2. Preencha o resto do formulário da seguinte forma:

   Configuração	Descrição
   Ação	Selecione Criar nova solicitação de alteração ou Usar solicitação de alteração existente.
   Alterar tipo	Selecione Normal, Padrão ou Emergência.
   Breve descrição	Insira um resumo da alteração.
   Cronograma de solicitação de alteração	Opcionalmente, insira o horário da alteração conforme definido pelo fluxo de trabalho do *ServiceNow*. Em Data de início planeada e Data de fim planeada, introduza data e hora UTC no formato aaaa-MM-ddTHH:mm:ssZ.
   Descrição	Opcionalmente, insira uma descrição detalhada da alteração.
   Categoria	Opcionalmente, selecione a categoria da alteração, como Hardware, Rede ou Software.
   Prioridade	Opcionalmente, selecione a prioridade da alteração.
   Risco	Opcionalmente, selecione o nível de risco para a alteração.
   Impacto	Opcionalmente, selecione o efeito que a alteração tem nos negócios.
   Item de configuração	Opcionalmente, selecione o item de configuração ao qual a alteração se aplica.
   Grupo de atribuição	Opcionalmente, selecione o grupo ao qual a alteração está atribuída.
   Parâmetros avançados>de solicitação de alteração adicional	Selecione os três pontos ao lado do campo e depois clique em Adicionar para inserir mais parâmetros. Os nomes devem ser nomes de campos, não rótulos, prefixados com u_, como u_backout_plan. Os valores devem ser válidos no ServiceNow. As entradas inválidas são ignoradas.
   Critérios de sucesso	Selecione Estado desejado da solicitação de alteração ou Critérios de sucesso avançados.
   Estado desejado da solicitação de alteração	Selecione o valor de status da solicitação de alteração necessário para que o portão seja bem-sucedido e o pipeline continue.
   Critérios avançados de sucesso	Insira uma expressão que controle quando o portão deve ser bem-sucedido. A solicitação de alteração é definida como root['result'] na resposta do ServiceNow. Por exemplo, and(eq(root['result'].state, 'New'),eq(root['result'].risk, 'Low')). Para obter mais informações, consulte Expressões.
   Nome de referência das variáveis>de saída	Para poder usar variáveis de saída em seu fluxo de trabalho de implantação, especifique um nome de referência. Você pode acessar variáveis de porta usando PREDEPLOYGATE como um prefixo em um trabalho sem agente. Por exemplo, quando o nome de referência é definido como gate1, você pode obter o número da solicitação de alteração usando a variável $(PREDEPLOYGATE.gate1.CHANGE_REQUEST_NUMBER).
   Lista de variáveis	CHANGE_REQUEST_NUMBER é o número da solicitação de alteração. CHANGE_SYSTEM_ID é o ID do sistema da solicitação de alteração.

stages:
- stage: Stage1
  jobs:
  - deployment: DeployLatest
    environment: <environment-name>
  ...
  - job: UpdateChangeRequest
    steps:
    - task: UpdateServiceNowChangeRequest@2
      displayName: 'Update ServiceNow Change Request'
      inputs:
        ServiceNowConnection: '<service-connection-name>'
        NewStatus: '<status-to-set>'
        WorkNotes: '<work-notes-for-change-request>'
        otherParameters: '{"u_<field-name>": "<valid-value>"}'
pool: server

FAQs

Quais versões do ServiceNow são suportadas?

Que tipos de pedido de alteração são suportados?

A integração do Azure Pipelines ServiceNow dá suporte a solicitações de alteração normais, padrão e de emergência.

Como faço para definir outras propriedades de alteração?

Você pode especificar mais propriedades de alteração no campo Parâmetros de solicitação de alteração adicionais ou em otherParameters. Use um formato JSON de pares chave-valor, com o nome sendo o nome do campo, não o rótulo, prefixado com u_.

Posso atualizar campos personalizados na solicitação de alteração com mais parâmetros de solicitação de alteração?

Se você definir campos personalizados na solicitação de alteração, deverá adicionar mapeamento para campos personalizados em Importar mapa de transformação de conjunto.

Como posso ver os valores do menu suspenso populados para Categoria, Estado e outros campos?

Os plug-ins Change Management Core e Change Management - Modelo de Estado devem estar ativos na sua instância do ServiceNow para que as caixas de seleção funcionem. Para obter mais informações, consulte Gerir mudanças de atualização e Atualizar os estados dos pedidos de alteração.

Recursos

• Configure seus pipelines de liberação para implantações seguras
• X sentimento como uma porta de liberação
• Problemas do GitHub como uma porta de liberação
• Crie portões personalizados.
• Exemplo de biblioteca ServerTaskHelper

Conteúdos relacionados

• Portões de liberação e aprovações
• Definir aprovações e verificações
• Configurar a intervenção manual
• Use portões e aprovações para controlar sua implantação
• Adicionar estágios, dependências e condições
• Gatilhos de liberação