Integrar Azure DevOps a Velocidade de mudança para DevOps — Espaço

Conecte-se à sua instância Azure DevOps usando o playbook do Espaço de mudança de DevOps para coletar dados para funções de planejamento, codificação, orquestração, artefato e qualidade de software.

Você pode se conectar a Azure DevOps (ADO) no nível da sua organização ou no nível do projeto individual. Se você estiver se conectando no nível do projeto, para cada projeto da sua organização, você deverá repetir o processo de conexão. Depois de se conectar a uma instância da ferramenta, você pode definir configurações adicionais que permitem que DevOps importe pipelines, registros de execução de tarefa e registros de execução de etapa.

Quando você configura webhooks em sua instância Azure DevOps para enviar dados para Velocidade de mudança para DevOps, Azure DevOps usa autenticação de token para o usuário de integração por padrão. As Velocidade de mudança para DevOps APIs são invocadas usando a autenticação de token e você não precisa inserir o nome de usuário e a senha de integração ao configurar. Se o usuário devops.system não estiver disponível na instância da ServiceNow, você deverá definir a propriedade Alternar para este usuário após a autenticação baseada em token ser bem-sucedida. Para obter mais informações, consulte Propriedades Velocidade de mudança para DevOps. A etapa para inserir o nome de usuário e a senha de integração é necessária somente nos seguintes cenários:

• Se a Configuração de DevOps estiver instalada, as APIs de Configuração de DevOps serão invocadas usando a autenticação básica.
• Se você usar a conexão de serviço de REST API de invocação do Azure. Você deve habilitar a propriedade This property decides whether to create a Generic Connection on configure operation for Azure DevOps neste caso.

Nota:

Velocidade de mudança para DevOps usa o termo instância para se referir a uma ocorrência específica de uma ferramenta. Azure DevOps usa o termo projeto.

Conectar uma organização

Conecte e configure sua instância Azure DevOps diretamente no nível da sua organização Azure DevOps. Todos os projetos dentro da organização podem ser descobertos e você pode optar por configurar vários projetos dentro da organização. Você pode gerenciar a ferramenta no nível da organização.

Antes de Iniciar

Conclua as tarefas especificadas no tópico Comece com Velocidade de mudança para DevOps.

Função necessária: sn_devops.admin ou sn_devops.tool_owner

Procedimento

1. Navegar até Espaços > Espaço de mudança de DevOps e use uma das seguintes opções para abrir o Playbook para integração Azure DevOps.

   Opção	Etapas
   Página inicial	Selecione Conectar uma ferramenta. No modal da ferramenta Conectar-se a um, selecione Azure DevOps na categoria apropriada (Orquestração, Plano, Código, Artefato ou Qualidade do software).
   Módulo de aplicações	Selecione Aplicações ( ) na navegação primária. Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte Criar uma aplicação - Espaço. No painel Ações recomendadas, selecione o cartão Conectar a uma ferramenta. No modal da ferramenta Conectar-se a um, selecione Azure DevOps na categoria apropriada (Orquestração, Plano, Código, Artefato ou Qualidade do software).
   Módulo de ferramentas	Selecione Ferramentas ( ) na navegação primária. Na lista Capacidade, selecione a categoria apropriada (Orquestração, Planejamento, Codificação, Artefato ou Qualidade de software). Selecione Conectar uma ferramenta. No modal Conectar a uma ferramenta, selecione Azure DevOps.

   Importante:

   Se você quiser descobrir e rastrear objetos da ferramenta, como pipelines, planos ou repositórios ao se conectar à ferramenta, deverá conectar sua ferramenta do módulo Aplicação.
2. No modal Conectar-se a uma ferramenta, insira os detalhes da conexão.
   1. Selecione Conectar uma organização na lista suspensa.
   2. Insira o URL Azure DevOps da organização.
   3. No campo Nome da ferramenta, insira um nome para a ferramenta.

   4. Selecione Avançar.

      

      O DevOps playbook é aberto para ajudá-lo a concluir as tarefas de integração.

3. Na seção Inserir detalhes da instância do Azure DevOps, selecione um dos seguintes valores no campo Tipo de credencial.

   Opção	Descrição
   Token de acesso pessoal	Insira a senha ou o token de acesso para acessar esta instância. Para obter informações sobre como criar um PAT, consulte Token de acesso pessoal (PAT).
   OAuth 2.0	Pré-requisitos: Criar um locatário no Microsoft Entra Adicionar um usuário ao locatário em Microsoft Entra Criar uma organização no portal do Azure Criar um app Azure DevOps Registrar Azure DevOps como um provedor OAuth Definir configurações de nível de projeto e organização Criar registro de credencial e obter token OAuth Usar um registro de credencial do OAuth existente Selecione a opção Usar um registro de credencial OAuth existente. Selecione um valor no campo Credencial. Criar um novo registro de credencial Desmarque a opção Usar um registro de credencial OAuth existente. Insira a ID da aplicação do Azure (disponível na seção Visão geral do registro de aplicação do Azure no Azure) no campo ID da aplicação (cliente). Insira a ID do diretório da aplicação do Azure (disponível na seção Visão geral do registro da aplicação do Azure no Azure) no campo ID do diretório (locatário). Insira o segredo do cliente da sua aplicação do Azure (disponível na seção Certificados e segredos do registro da aplicação do Azure no Azure) no campo Segredo do cliente.

4. Se a instância da ferramenta estiver anexada a um MID Server, selecione a opção MID Server e insira seus detalhes.

   Para obter mais informações sobre o MID Server, consulte Seleção do MID Server.

5. Selecione Conectar.
6. As verificações de permissão são executadas nas credenciais que você inseriu.
   As permissões necessárias e as permissões disponíveis são exibidas. Se você quiser inserir credenciais com permissões melhores, selecione Inserir credenciais novamente. Para obter informações detalhadas sobre todas as permissões necessárias, consulte Permissões do Azure DevOps em Permissões necessárias para DevOps ferramentas.

   Você pode optar por continuar com a conexão da ferramenta mesmo se não tiver todas as permissões necessárias.

   Nota:

   Ao integrar uma organização, o privilégio de administradores de projeto requer que o proprietário do PAT seja um membro do grupo de administradores de coleção de projetos da organização.

   Você precisa do privilégio Administradores de projeto somente para integrar a ferramenta. Depois que a ferramenta for integrada com sucesso, você poderá optar por desativar o privilégio de Administrador de projeto no PAT.

   

7. Especifique o acesso para a ferramenta.
   1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por.
      As tarefas que esses usuários nos grupos podem executar dependem da função atribuída a eles.

      • DevOps Função de proprietário da ferramenta: pode exibir e editar a ferramenta.
      • DevOps Função de proprietário da aplicação: pode exibir a ferramenta e associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines).
      • DevOps Função de administrador: pode editar todas as ferramentas.
      • Outras funções DevOps : pode exibir a ferramenta.

      Nota:

      Se você não selecionar um grupo e ignorar esta etapa, todos os usuários com a função de proprietário da ferramenta DevOps poderão editar a ferramenta.
   2. Se você optar por controlar o acesso à ferramenta, a opção Todos os proprietários de apps de DevOps podem exibir e associar objetos da ferramenta a aplicações ficará disponível para seleção.
      Esta opção permite que todos os usuários com a função de proprietário de app DevOps acessem a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta.
   3. Selecione Atribuir.
      
8. Instale a extensão ServiceNow DevOps em sua instância Azure DevOps.

   A extensão ServiceNow DevOps criará automaticamente conexões de serviço ao configurar webhooks. As conexões de serviço são necessárias para enviar notificações de compilação e versão de Azure DevOps. A extensão também contém tarefas personalizadas para modificar os Azure DevOps pipelines para controle de mudanças, artefatos e pacotes.

   Para obter mais informações sobre a extensão, consulte Use a extensão ServiceNow DevOps para ações personalizadas Azure DevOps e Azure DevOps.

   Nota:

   Se pular este passo, para enviar notificações do Azure DevOps, será necessário criar manualmente as conexões de serviço após configurar os webhooks.

   Depois de instalar a extensão, selecione Marcado como instalado.

   

9. Configure webhooks automaticamente em sua instância Azure DevOps para enviar dados para Velocidade de mudança para DevOps.
   Escolha enviar dados por meio de pesquisa noturna ou configurando webhooks para enviar dados em tempo real.

   • Webhooks: habilite notificações em tempo real para suas execuções de pipeline. As notificações em tempo real são ideais para manter as informações mais atualizadas, principalmente para automatizar as solicitações de mudança.

     Para usar webhooks, selecione Configurar.

   • Pesquisa noturna: se você optar por não configurar agora, poderá habilitar a pesquisa noturna mais tarde para buscar dados para todos os planos rastreados definindo a propriedade Enable Polling como Sim.

   1. Insira o nome de usuário e a senha de integração DevOps.

      Para obter informações sobre como criar o usuário e a senha de integração DevOps, consulte Configurar conta do usuário de integração no Velocidade de mudança para DevOps.

      Nota:

      • A etapa para inserir o nome de usuário e a senha de integração é necessária para configurar somente quando a Configuração de DevOps está instalada ou a propriedade This property decides whether to create a Generic Connection on configure operation for Azure DevOps está habilitada. Se esta etapa não for necessária, os webhooks serão configurados usando a autenticação baseada em token.
      • Quando a configuração de DevOps estiver instalada ou a propriedade Conexão genérica na operação de configuração do Azure DevOps estiver habilitada, você poderá gerar novamente o token (configurar automaticamente com o novo token) somente a partir da IU do espaço, o que atualizará a senha do usuário de integração. Quando a Configuração de DevOps não está instalada, o token pode ser gerado novamente a partir do espaço e da IU clássica para autenticação baseada em token. Gere novamente seu token periodicamente para melhorar a segurança.
   2. Selecione os projetos para os quais você deseja configurar webhooks.

   3. Selecione Configurar.

      

   Para configurar webhooks manualmente, selecione Configurar manualmente. Para obter mais informações, consulte Configurar webhooks em Azure DevOps manualmente.

   A configuração e a descoberta do Webhook acontecem em segundo plano e você é direcionado para a página Resumo.

   

10. Na página Resumo, selecione Exibir registro da ferramenta para revisar os detalhes da ferramenta conectada.

Resultado

Você integrou com sucesso sua ferramenta Azure DevOps a Velocidade de mudança para DevOps no nível da organização.

O que Fazer Depois

Na guia Projetos na página de registro da ferramenta, selecione um projeto para navegar até a página de registro do projeto. A partir daqui, você pode descobrir objetos de projeto e configurar webhooks para o projeto.

• Selecione Descobrir para descobrir os objetos do projeto, incluindo planos (quadros), repositórios e pipelines existentes.
• Se você criou a ferramenta diretamente no nível do projeto, selecionar Descobrir projetos na guia Projetos da página de registro da ferramenta também descobrirá todos os projetos da sua organização.
• Selecione Configurar e insira as credenciais do usuário de integração para configurar webhooks para o projeto.
• Se você estiver na página de registros da ferramenta, selecionar Configurar projetos e inserir as credenciais do usuário de integração fornecerá a lista de projetos não configurados em sua organização. Selecione os projetos para os quais você deseja que os webhooks sejam configurados e selecione Configurar.
  Nota:

  A etapa para inserir o nome de usuário e a senha de integração é necessária para configurar webhooks somente quando a configuração de DevOps está instalada ou a propriedade Conexão genérica na operação de configuração do Azure DevOps está desabilitada. Se esta etapa não for necessária, os webhooks serão configurados usando a autenticação baseada em token.
• Para importar dados históricos para os objetos do projeto, como planos, repositórios ou pipelines, associe os objetos a uma aplicação e importe os dados. Para obter mais informações, consulte Associar objetos de ferramenta a aplicações - Espaço.

Conectar um projeto

Conecte e configure sua instância Azure DevOps diretamente no nível do projeto. Se você tiver vários projetos na organização, deverá conectar cada um deles separadamente.

Antes de Iniciar

Conclua as tarefas especificadas no tópico Comece com Velocidade de mudança para DevOps.

Função necessária: sn_devops.admin ou sn_devops.tool_owner

Procedimento

1. Navegar até Espaços > Espaço de mudança de DevOps e use uma das seguintes opções para abrir o Playbook para integração Azure DevOps.

   Opção	Etapas
   Página inicial	Selecione Conectar uma ferramenta. No modal da ferramenta Conectar-se a um, selecione Azure DevOps na categoria apropriada (Orquestração, Plano, Código, Artefato ou Qualidade do software).
   Módulo de aplicações	Selecione Aplicações ( ) na navegação primária. Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte Criar uma aplicação - Espaço. No painel Ações recomendadas, selecione o cartão Conectar a uma ferramenta. No modal da ferramenta Conectar-se a um, selecione Azure DevOps na categoria apropriada (Orquestração, Plano, Código, Artefato ou Qualidade do software).
   Módulo de ferramentas	Selecione Ferramentas ( ) na navegação primária. Na lista Capacidade, selecione a categoria apropriada (Orquestração, Planejamento, Codificação, Artefato ou Qualidade de software). Selecione Conectar uma ferramenta. No modal Conectar a uma ferramenta, selecione Azure DevOps.

   Importante:

   Se você quiser descobrir e rastrear objetos da ferramenta, como pipelines, planos ou repositórios ao se conectar à ferramenta, deverá conectar sua ferramenta do módulo Aplicação.
2. No modal Conectar-se a uma ferramenta, insira os detalhes da conexão.
   1. Selecione Conectar um projeto na lista suspensa.
   2. Insira a URL Azure DevOps do projeto.
   3. No campo Nome da ferramenta, insira um nome para a ferramenta.

   4. Selecione Avançar.

      O DevOps playbook é aberto para ajudá-lo a concluir as tarefas de integração.

   

3. Insira os detalhes da instância da sua ferramenta.
   1. Na seção Inserir detalhes da instância do Azure DevOps, selecione um dos seguintes valores no campo Tipo de credencial.
      • Token de acesso pessoal: insira a senha ou o token de acesso para acessar esta instância.

        Para obter informações sobre como criar um PAT, consulte Token de acesso pessoal (PAT).

      • OAuth 2.0: Pré-requisitos:
        • Criar um locatário no Microsoft Entra
        • Adicionar um usuário ao locatário em Microsoft Entra
        • Criar uma organização no portal do Azure
        • Criar um app Azure DevOps
        • Registrar Azure DevOps como um provedor OAuth
        • Definir configurações de nível de projeto e organização
        • Criar registro de credencial e obter token OAuth
        Usar um registro de credencial do OAuth existente
        1. Selecione a opção Usar um registro de credencial OAuth existente.
        2. Selecione um valor no campo Credencial.
        Criar um novo registro de credencial
        1. Desmarque a opção Usar um registro de credencial OAuth existente.
        2. Insira a ID da aplicação do Azure (disponível na seção Visão geral do registro de aplicação do Azure no Azure) no campo ID da aplicação (cliente).
        3. Insira a ID do diretório da aplicação do Azure (disponível na seção Visão geral do registro da aplicação do Azure no Azure) no campo ID do diretório (locatário).
        4. Insira o segredo do cliente da sua aplicação do Azure (disponível na seção Certificados e segredos do registro da aplicação do Azure no Azure) no campo Segredo do cliente.
        
   2. Opcional: Se a instância da ferramenta estiver anexada a um MID Server, selecione a opção MID Server e insira seus detalhes.

      Para obter mais informações sobre o MID Server, consulte Seleção do MID Server.

   3. Selecione Conectar.
   4. As verificações de permissão são executadas nas credenciais que você inseriu.
      As permissões necessárias e as permissões disponíveis são exibidas. Se você quiser inserir credenciais com permissões melhores, selecione Inserir credenciais novamente. Para obter informações detalhadas sobre todas as permissões necessárias, consulte Permissões do Azure DevOps em Permissões necessárias para DevOps ferramentas.

      Você pode optar por continuar com a conexão da ferramenta mesmo se não tiver todas as permissões necessárias.

      Nota:

      Ao integrar um Projeto, o privilégio de Administradores de Projeto requer que o proprietário do PAT seja um membro do grupo de Administradores de Projeto do projeto.

      Você precisa do privilégio Administradores de projeto somente para integrar a ferramenta. Depois que a ferramenta for integrada com sucesso, você poderá optar por desativar o privilégio de Administrador de projeto no PAT.

      

   5. Selecione Avançar.
4. Especifique o acesso para a ferramenta.
   1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por.
      As tarefas que esses usuários nos grupos podem executar dependem da função atribuída a eles.

      • DevOps Função de proprietário da ferramenta: pode exibir e editar a ferramenta.
      • DevOps Função de proprietário da aplicação: pode exibir a ferramenta e associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines).
      • DevOps Função de administrador: pode editar todas as ferramentas.
      • Outras funções DevOps : pode exibir a ferramenta.

      Nota:

      Se você não selecionar um grupo e ignorar esta etapa, todos os usuários com a função de proprietário da ferramenta DevOps poderão editar a ferramenta.
   2. Se você optar por controlar o acesso à ferramenta, a opção Todos os proprietários de apps de DevOps podem exibir e associar objetos da ferramenta a aplicações ficará disponível para seleção.
      Esta opção permite que todos os usuários com a função de proprietário de app DevOps acessem a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta.
   3. Selecione Atribuir.
      
5. Instale a extensão ServiceNow DevOps em sua instância Azure DevOps.

   A extensão ServiceNow DevOps criará automaticamente conexões de serviço ao configurar webhooks. As conexões de serviço são necessárias para enviar notificações de compilação e versão de Azure DevOps. A extensão também contém tarefas personalizadas para modificar os Azure DevOps pipelines para controle de mudanças, artefatos e pacotes.

   Para obter mais informações sobre a extensão, consulte Use a extensão ServiceNow DevOps para ações personalizadas Azure DevOps e Azure DevOps.

   Nota:

   Se pular este passo, para enviar notificações do Azure DevOps, será necessário criar manualmente as conexões de serviço após configurar os webhooks.

   Depois de instalar a extensão, selecione Marcado como instalado.

   

6. Configure webhooks automaticamente em sua instância Azure DevOps para enviar dados para Velocidade de mudança para DevOps.
   Escolha enviar dados por meio de pesquisa noturna ou configurando webhooks para enviar dados em tempo real.

   • Webhooks: habilite notificações em tempo real para suas execuções de pipeline. As notificações em tempo real são ideais para manter as informações mais atualizadas, principalmente para automatizar as solicitações de mudança.

     Para usar webhooks, selecione Configurar.

   • Pesquisa noturna: se você optar por não configurar agora, poderá habilitar a pesquisa noturna mais tarde para buscar dados para todos os planos rastreados definindo a propriedade Enable Polling como Sim.

   1. Insira o nome de usuário e a senha de integração DevOps.

      Para obter informações sobre como criar o usuário e a senha de integração DevOps, consulte Configurar conta do usuário de integração no Velocidade de mudança para DevOps.

      Nota:

      • A etapa para inserir o nome de usuário e a senha de integração é necessária para configurar somente quando a Configuração de DevOps está instalada ou a propriedade This property decides whether to create a Generic Connection on configure operation for Azure DevOps está habilitada. Se esta etapa não for necessária, os webhooks serão configurados usando a autenticação baseada em token.
      • Quando a configuração de DevOps estiver instalada ou a propriedade Conexão genérica na operação de configuração do Azure DevOps estiver habilitada, você poderá gerar novamente o token (configurar automaticamente com o novo token) somente a partir da IU do espaço, o que atualizará a senha do usuário de integração. Quando a Configuração de DevOps não está instalada, o token pode ser gerado novamente a partir do espaço e da IU clássica para autenticação baseada em token. Gere novamente seu token periodicamente para melhorar a segurança.
   2. Selecione Configurar.

      

      Para configurar webhooks manualmente, selecione Configurar manualmente. Para obter mais informações, consulte Configurar webhooks em Azure DevOps manualmente.

      Importante:

      • Se você estiver se conectando pela página inicial ou pelo módulo Ferramentas, a conexão será concluída e você será direcionado para a página Resumo.
      • Se você estiver se conectando do módulo Aplicações, planos, repositórios e pipelines disponíveis em seu projeto serão descobertos. Você pode rastrear e importar dados históricos deles.
7. Selecione os planos para acompanhar.
   1. Selecione os planos para os quais você deseja rastrear atualizações e associar à aplicação.

   2. Selecione Avançar.

      

   3. Se você quiser importar dados do plano, selecione o intervalo de datas e selecione Enviar.

      Você pode importar até 90 dias de dados.

      

8. Selecione os repositórios a serem rastreados.
   1. Selecione os repositórios para os quais você deseja rastrear atualizações e associar à aplicação.

   2. Selecione Avançar.

      

   3. Se você quiser importar dados do repositório, selecione o intervalo de datas e selecione Enviar.

      Você pode importar até 90 dias de dados.

      

9. Selecione os pipelines a serem rastreados.

   1. Selecione os pipelines para os quais você deseja rastrear atualizações e associar à aplicação.

   2. Selecione Avançar.

      

   3. Para cada pipeline selecionado, todas as etapas ou fases são importadas para a última execução bem-sucedida. Na atividade Atribuir serviços a etapas do pipeline, você pode selecionar o seguinte para cada etapa do pipeline:

      1. Tipo de etapa do pipeline: selecione um tipo de etapa para o qual você deseja atribuir um serviço.

         Dica:

         Especifique pelo menos o tipo de etapa Prod deploy para etapas que representam a implantação de produção para permitir que DevOps identifique execuções de pipeline bem-sucedidas como implantações de produção.

      2. Serviço: selecione o serviço de aplicações CMDB para o qual a etapa do pipeline é mapeada.

         O serviço de aplicações é mapeado aproximadamente para o ambiente. Se você usar a mesma etapa de pipeline para implantar em ambientes diferentes, deixe o campo em branco. As informações de serviço permitem que DevOps identifique e gere relatórios sobre métricas operacionais, como incidentes, indisponibilidades e assim por diante.

   4. Selecione Avançar.

      

   5. Se você quiser importar dados de pipeline, selecione o intervalo de datas e selecione Enviar.

      Você pode importar até 90 dias de dados.

      

10. Você será direcionado para a página Resumo.

    Na página Resumo, selecione Exibir registro da ferramenta para revisar os detalhes da ferramenta conectada.

    

Resultado

Você integrou com sucesso sua ferramenta Azure DevOps a Velocidade de mudança para DevOps no nível do projeto.

O que Fazer Depois

Na guia Projetos na página de registro da ferramenta, selecione um projeto para navegar até a página de registro do projeto. A partir daqui, você pode descobrir objetos de projeto e configurar webhooks para o projeto.

• Selecione Descobrir projetos para descobrir os objetos do projeto, incluindo planos existentes (quadros), repositórios e pipelines. Isso também descobrirá todos os projetos da sua organização.
• Selecione Configurar projetos para configurar webhooks para o projeto.
• Se você estiver na página de registros da ferramenta, selecionar Configurar projetos e inserir as credenciais do usuário de integração fornecerá a lista de projetos não configurados em sua organização. Selecione os projetos para os quais você deseja que os webhooks sejam configurados e selecione Configurar.
  Nota:

  A etapa para inserir o nome de usuário e a senha de integração é necessária para configurar webhooks somente quando a configuração de DevOps está instalada ou a propriedade Conexão genérica na operação de configuração do Azure DevOps está desabilitada. Se esta etapa não for necessária, os webhooks serão configurados usando a autenticação baseada em token.
• Para importar dados históricos para os objetos do projeto, como planos, repositórios ou pipelines, associe os objetos a uma aplicação e importe os dados. Para obter mais informações, consulte Associar objetos de ferramenta a aplicações - Espaço.

Tarefas relacionadas

• Configurar webhooks a partir do registro da ferramenta