Gerenciar recursos de VM em ambientes

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Um ambiente do Azure Pipelines é um grupo de recursos que você pode direcionar com implantações de um pipeline. Ambientes típicos incluem Desenvolvimento, Teste ou Produção.

Para adicionar recursos de máquina física ou virtual (VM) a ambientes, instale agentes nos computadores. O histórico de implantação do ambiente fornece a rastreabilidade de cada computador. Este artigo descreve como definir e usar ambientes para gerenciar implantações em recursos de VM ou servidor.

Pré-requisitos

Para executar os procedimentos neste artigo, você precisa dos seguintes pré-requisitos:

Criar um ambiente e adicionar uma VM

Use o procedimento a seguir para adicionar uma VM ou computador físico a um ambiente.

Criar o ambiente com um recurso de VM

1. Em seu projeto do Azure DevOps, acesse Ambientes de Pipelines> e selecione Criar ambiente ou Novo ambiente.

2. Na tela Novo ambiente , insira um Nome e uma Descrição opcional.

3. Em Recurso, selecione Máquinas virtuais e, em seguida, selecione Avançar.

   

Copie o script de registro

Os scripts de agente para recursos de VM são como os scripts para agentes auto-hospedados e usam os mesmos comandos. Os scripts incluem um PAT (Token de Acesso Pessoal) do Azure DevOps para o usuário conectado, que expira três horas após a geração do script. Você só precisa do PAT para instalar o agente.

Executar o script de registro copiado na VM

1. Selecione Fechar. O novo ambiente é criado. Para copiar o script novamente, por exemplo, se o PAT expirar, selecione Adicionar recurso novamente na página do ambiente.

   

2. Execute o script copiado em cada VM de destino que você deseja registrar no ambiente.

   Observação

   Se a VM já tiver outro agente em execução, forneça um nome exclusivo para que o novo agent se registre no ambiente.

3. Depois que a VM for registrada, verifique se ela aparece na guia Recursos da página de ambiente do Azure Pipelines.

   

Usar ambientes em pipelines YAML

Você pode direcionar recursos de VM em seus trabalhos de implantação yaml referenciando seu ambiente. Para obter mais informações sobre trabalhos de implantação yaml, consulte Trabalhos de implantação e a definição jobs.deployment na referência de esquema de pipelines YAML.

O trabalho de implantação de pipeline a seguir é executado somente em VMs no VMEnv ambiente.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to VMenv
  environment: VMenv
  strategy:
     runOnce:
        deploy:   
          steps:
            - script: echo "Hello world"

Você pode direcionar uma VM específica no ambiente acrescentando o nome do recurso da VM ao nome do ambiente. O exemplo a seguir é implantado somente no recurso de VM nomeado RESOURCE-PC no VMenv ambiente.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to RESOURCE-PC in VMenv
  environment: VMenv.RESOURCE-PC  # only deploy to the VM resource named RESOURCE-PC
  strategy:
     runOnce:
        deploy:   
          steps:
            - script: echo "Hello world"

Você também pode usar a sintaxe completa da palavra-chave jobs-deployment-environment e implantar em VMs de ambiente específicas listando-as em resourceName.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to RESOURCE-PC in VMenv with full syntax
  environment: 
    name: VMenv
    resourceType: virtualMachine
    resourceName: RESOURCE-PC # only deploy to the VM resource named RESOURCE-PC
  strategy:
    runOnce:
      deploy:   
          steps:
          - script: echo "Hello world"

Estratégia de implantação

Em um trabalho de implantação, você aplica uma implantação strategy para definir como implantar seu aplicativo. As VMs dão suporte às runOnce estratégias e .rolling Para obter mais informações sobre estratégias de implantação e ganchos de ciclo de vida, consulte Estratégias de implantação.

Permissions

Na primeira vez que executar o pipeline que usa o ambiente, você deve conceder permissão para todas as execuções do pipeline acessarem o pool de agentes e o ambiente. Selecione o símbolo De espera ao lado do trabalho na tela Resumo da execução do pipeline e selecione Permitir para conceder as permissões necessárias.

Adicionar e gerenciar marcas

As marcas são uma maneira de direcionar um conjunto específico de VMs de ambiente para implantação. Quando você especifica tags na environment palavra-chave, o pipeline é implantado apenas em VMs de ambiente que têm as marcas aplicadas.

Não há limite para o número de marcas que você pode aplicar às VMs. Os nomes de marca são limitados a 256 caracteres cada.

Você pode aplicar ou remover marcas selecionando o ícone Mais ações ao lado da VM na guia Recursos do ambiente.

Você também pode aplicar marcas interativamente ao registrar o script do agente na VM.

Se você especificar várias marcas, o pipeline será implantado apenas em VMs que incluem todas as marcas. O exemplo a seguir tem como destino apenas as VMs que têm as windows marcas e prod . O pipeline não é implantado em VMs que têm apenas uma ou nenhuma das marcas.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to VM
  environment: 
    name: VMenv
    resourceType: virtualMachine
    tags: windows,prod # only deploy to VMs with both windows and prod tags
  strategy:
    runOnce:
      deploy:   
          steps:
          - script: echo "Hello world"

Exibir histórico de implantação

Selecione a guia Implantações da página de ambiente para concluir a rastreabilidade de confirmações e itens de trabalho e um histórico de implantação entre pipelines por ambiente e recurso.

Remover uma VM de um ambiente

./config.sh remove

./config.cmd remove

Conteúdo relacionado

• Criar e direcionar ambientes
• Ambiente – Recurso do Kubernetes
• Trabalhos de implantação
• Referência de esquema de pipelines YAML