Guia de início rápido: criar um pool de DevOps gerenciado usando um modelo Bicep

Este artigo mostra como criar um Pool de DevOps Gerenciado usando um modelo Bicep e executar um pipeline no novo pool.

Pré-requisitos

Antes de concluir as etapas neste artigo, configure a sua subscrição do Azure e a sua organização de Azure DevOps para uso com os Pools de DevOps Geridos, tal como descrito no artigo Pré-requisitos. Essas etapas precisam ser concluídas apenas uma vez por assinatura do Azure e organização do Azure DevOps.

Abra um prompt de comando (no Windows, use o Prompt de Comando do Windows ou o PowerShell) e execute os seguintes comandos.

Entre na CLI do Azure.
```
az login
```
Se você tiver mais de uma assinatura do Azure, defina sua assinatura padrão do Azure.
```
az account set --subscription "My subscription name"
```
Para obter uma lista das suas subscrições, pode executar o seguinte comando.
```
az account list -o table
```
Se você tiver vários locatários ou quiser ver mais informações sobre como trabalhar com a assinatura do Azure usando a CLI do Azure, consulte Como gerenciar assinaturas do Azure com a CLI do Azure.

Criar um grupo de recursos

Crie um grupo de recursos para conter o Pool de DevOps Gerenciado e outros recursos. Substitua <resourceGroupName> pelo nome que você deseja usar para o grupo de recursos e <location> pela região do Azure onde você deseja criar o grupo de recursos.
```
az group create --name <resourceGroupName> --location <location>
```

Revise e salve o modelo

Crie um nome de arquivo local mdp-azure-deploy.bicep com o seguinte conteúdo. Este arquivo é um modelo Bicep parametrizado que cria um Microsoft.DevOpsInfrastructure/pools recurso incluindo as dependências Microsoft.DevCenter/devcenters recurso e Microsoft.DevCenter/projects recurso.

@minLength(3)
@maxLength(44)
param poolName string

@maxLength(26)
param devCenterName string

param devCenterProjectName string
param adoOrg string
param imageName string
param poolSize int
param location string = 'eastus'

resource devCenter 'Microsoft.DevCenter/devcenters@2025-02-01' = {
  name: devCenterName
  location: location
}

resource devCenterProject 'Microsoft.DevCenter/projects@2025-02-01' = {
  name: devCenterProjectName
  location: location
  properties: {
    devCenterId: devCenter.id
  }
}

resource pool 'microsoft.devopsinfrastructure/pools@2025-09-20' = {
  name: poolName
  location: location
  properties: {
    organizationProfile: {
      organizations: [
        {
          url: adoOrg
          parallelism: 1
        }
      ]
      permissionProfile: {
        kind: 'CreatorOnly'
      }
      kind: 'AzureDevOps'
    }
    devCenterProjectResourceId: devCenterProject.id
    maximumConcurrency: poolSize
    agentProfile: {
      kind: 'Stateless'
    }
    fabricProfile: {
      sku: {
        name: 'Standard_D2ads_v5'
      }
      images: [
        {
          wellKnownImageName: imageName
          buffer: '*'
        }
      ]
      kind: 'Vmss'
    }
  }
}

Crie outro arquivo local chamado mdp-azure-deploy-parameters.bicepparam e salve-o na mesma pasta do primeiro arquivo. Atualize as propriedades a seguir para corresponder aos detalhes do seu ambiente.

Parâmetro	Valor
`poolName`	Atualize `value` com o nome desejado do seu pool. O nome deve consistir em caracteres alfanuméricos, `.`, `-`ou `_`, e ter entre 3 e 44 caracteres de comprimento. O nome deve ser globalmente exclusivo no Azure.
`devCenterName`	Atualize `value` com o nome desejado do seu Centro de Desenvolvimento.
`devCenterProjectName`	Atualize `value` com o nome desejado do seu projeto do Centro de Desenvolvimento.
`adoOrg`	Atualize `value` e substitua `your-organization` pelo nome da sua organização do Azure DevOps.
`imageName`	Este exemplo está configurado para usar uma imagem do Azure Pipelines e usa a imagem do Windows Server 2022. Se quiser alterá-lo, escolha entre os aliases predefinidos da imagem do Azure Pipelines. Os Pools de DevOps Gerenciados também dão suporte a imagens da Galeria de Computação do Azure e imagens de mercado selecionadas. Para obter informações sobre como configurar um recurso de Pools de DevOps Gerenciados para esses tipos de imagem, consulte Configurar imagens de Pools de DevOps Gerenciados.
`poolSize`	Atualize `value` com o número máximo de agentes que você deseja poder executar trabalhos simultâneos. Neste exemplo, o `poolSize` é `1`.
`location`	A região do Azure para o pool. Neste exemplo, a região é `eastus`.

using './mdp-azure-deploy.bicep'

param poolName = '<pool-name>'
param devCenterName = '<dev-center-name>'
param devCenterProjectName = '<dev-center-project-name>'
param adoOrg = 'https://dev.azure.com/fabrikam'
param location = 'eastus'
param imageName = 'windows-2022'
param poolSize = 1

Criar o pool de DevOps gerenciado

Abra um prompt de comando (no Windows, use o Prompt de Comando do Windows ou o PowerShell) e execute os seguintes comandos. Você pode ignorar os dois primeiros comandos se sua sessão da CLI do Azure do primeiro procedimento ainda estiver ativa.

Entre na CLI do Azure.
```
az login
```
Se você tiver mais de uma assinatura do Azure, defina sua assinatura padrão do Azure.
```
az account set --subscription "My subscription name"
```
Para obter uma lista das suas subscrições, pode executar o seguinte comando.
```
az account list -o table
```
Se você tiver vários locatários ou quiser ver mais informações sobre como trabalhar com a assinatura do Azure usando a CLI do Azure, consulte Como gerenciar assinaturas do Azure com a CLI do Azure.
Vá para a pasta quando salvou os arquivos mdp-azure-deploy.bicep e mdp-azure-deploy-parameters.bicepparam da etapa anterior. Neste exemplo, os arquivos são salvos em C:\examples.
```
cd c:\examples
```
Crie o pool de DevOps gerenciado. Substitua <resourceGroupName> pelo grupo de recursos criado na primeira etapa.
```
az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.bicep --parameters mdp-azure-deploy-parameters.bicepparam
```
Se sua assinatura não tiver a capacidade de configurar seu pool com a SKU de VM do Azure desejada e a contagem máxima de agentes, a criação do pool falhará com um erro semelhante à mensagem a seguir. Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97. Para resolver o problema, consulte Consultar quotas de pools DevOps geridos.

Exibir o pool criado no portal do Azure

Inicie sessão no portal Azure.
Pesquise por Pools Geridos de DevOps e selecione-o entre as opções disponíveis.
Escolha seu novo Pool de DevOps Gerenciado na lista.

Exibir o pool de agentes no Azure DevOps

Vá para o portal do Azure DevOps e entre na sua organização do Azure DevOps (https://dev.azure.com/{your-organization}).
Vá para Azure DevOps>Configurações da Organização.
Vá para Pipelines>Agent pools e verifique se o seu novo pool está listado. Se você acabou de criar o Pool de DevOps gerenciado, pode levar alguns momentos para que o novo pool apareça na lista de agentes.

Executar um pipeline em seu novo pool

Nesta etapa, criaremos um pipeline simples no repositório padrão de um projeto de DevOps do Azure e o executaremos em seu novo Pool de DevOps Gerenciado.

Vá para o portal do Azure DevOps e entre na sua organização do Azure DevOps (https://dev.azure.com/{your-organization}).
Vá para o projeto onde pretende executar o pipeline e escolha Pipelines.
Escolha Novo pipeline (ou Create Pipeline se este for o seu primeiro pipeline).
Escolha Azure Repos Git.
Escolha o repositório que tem o mesmo nome do seu projeto. Neste exemplo, o projeto é chamado FabrikamFiber, então escolhemos o repositório com o mesmo nome.
Escolha a linha de montagem inicial.
Por padrão, o modelo inicial usa um agente Linux hospedado pela Microsoft. Edite o modelo de pipeline e altere a pool seção para que ela se refira ao pool criado nas etapas anteriores.
```
# Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest
```
Neste exemplo, os Pools de DevOps Gerenciados são nomeados fabrikam-managed-pool, portanto, substitua vmImage: ubuntu-latest por name: fabrikam-managed-pools, e especifique o nome do seu Pool de DevOps Gerenciado.
```
# Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool
```
Escolha Salvar e executar e escolha Salvar e executar uma segunda vez para confirmar.
Se este for o primeiro pipeline executado neste pool, você poderá ser solicitado a conceder permissões antes que o pipeline seja executado. Para obter mais informações, consulte Este pipeline precisa de permissão para acessar um recurso antes que essa execução possa continuar.
Observe o pipeline em execução no Azure DevOps e pode-se mudar para o portal do Azure para ver o agente em execução na vista Agentes.

Limpeza de recursos

Quando tiver concluído o início rápido, exclua os recursos criados se não quiser continuar a usá-los.

Para excluir o Pool de DevOps Gerenciado, o Centro de Desenvolvimento e o Projeto do Centro de Desenvolvimento, você pode excluí-los excluindo o grupo de recursos que os contém.

Ver também

Feedback

Esta página foi útil?

Last updated on 2025-08-13