Pré-requisitos para pools de DevOps gerenciados

Há algumas coisas que você precisa preparar antes de usar os Pools de DevOps Gerenciados pela primeira vez.

Em um alto nível, você precisa:

Este artigo mostra como configurar sua assinatura do Azure e a organização do Azure DevOps para uso com Pools de DevOps Gerenciados. Essas etapas de configuração só precisam ser executadas uma única vez por organização do Azure DevOps e assinatura do Azure.

Configurar sua assinatura do Azure

1. Verificar permissões do Azure
2. Registrar o provedor de recursos de Pools de DevOps Gerenciados em sua Assinatura do Azure
3. Revisar cotas de pools de DevOps gerenciados
4. Crie um projeto de centro de desenvolvimento e centro de desenvolvimento (Se você planeja criar seus Pools de DevOps Gerenciados usando o portal do Azure, poderá criar o centro de desenvolvimento e o projeto do centro de desenvolvimento durante o processo de criação do pool.)

Verificar permissões do Azure

Para criar e gerenciar Pools de DevOps Gerenciados, você deve ter uma das seguintes funções atribuídas à sua conta na assinatura do Azure onde deseja criar os Pools de DevOps Gerenciados. As funções a seguir são listadas em ordem de menos privilegiado para mais privilegiado. O Colaborador de Infraestrutura de DevOps é a função menos privilegiada que permite criar e gerenciar Pools de DevOps gerenciados.

Para verificar as atribuições de função da sua conta, consulte Listar atribuições de função do Azure.

Para obter informações sobre como atribuir funções, consulte Etapas para atribuir uma função do Azure.

Se você estiver criando um centro de desenvolvimento e um projeto de centro de desenvolvimento durante a criação do Pool de DevOps gerenciado, deverá ter a função de Colaborador ou Proprietário atribuída à sua conta para o escopo no qual deseja criar o centro de desenvolvimento. Para obter mais informações, consulte Criar um centro de desenvolvimento e projeto do centro de desenvolvimento.

Registrar o provedor de recursos de Pools de DevOps Gerenciados em sua Assinatura do Azure

Para usar Pools de DevOps Gerenciados, registre os seguintes provedores de recursos com sua assinatura do Azure.

O registo de um provedor de recursos usa a /register/action operação. A permissão para executar esta operação será incluída se a função de colaborador ou proprietário da sua subscrição estiver atribuída à sua conta.

az provider register --namespace 'Microsoft.DevOpsInfrastructure'
az provider register --namespace 'Microsoft.DevCenter'

Register-AzResourceProvider -ProviderNamespace 'Microsoft.DevOpsInfrastructure'
Register-AzResourceProvider -ProviderNamespace 'Microsoft.DevCenter'

Para obter mais informações sobre provedores de recursos do Azure, consulte Provedores e tipos de recursos do Azure.

Revisar cotas de pools de DevOps gerenciados

Os Pools de DevOps Gerenciados usam as Cotas do Azure para gerenciar o uso dos recursos de máquina virtual que executam seus agentes. As cotas de Pools de DevOps Gerenciados são baseadas em núcleos de CPU por família de SKUs de VM do Azure. Por padrão, as regiões que oferecem suporte a Pools de DevOps Gerenciados têm cinco núcleos de cota concedidos para as seguintes famílias de SKU.

• standardBSFamily
• standardDADSv5Family
• standardDASv5Family
• standardDDSv5Family
• standardDLDSv5Family
• standardDPLDSv5Family
• standardDPLSv5Family
• standardDPSv5Family
• standardDSv2Family
• standardDSv5Family
• standardDv2Family
• standardEASv4Family
• standardEDSv5Family
• standardESv5Family
• standardFSv2Family
• standardLSv3Family

O tamanho padrão do agente para novos recursos de Managed DevOps Pools é Standard D2ads v5, que faz parte da família DADSv5 padrão. O padrão D2ads v5 usa dois núcleos, para que você possa criar um pool com até dois agentes, para um total de quatro núcleos, sem solicitar cota adicional. Para criar mais, você deve solicitar um ajuste de cota.

Ver as suas quotas

1. Para exibir as cotas para famílias de SKU em sua região, entre no portal do Azure, insira cotas na caixa de pesquisa e escolha Cotas na lista.

   

2. Escolha Managed DevOps Pools.

   

3. Escolha sua assinatura e a região onde deseja criar o pool. No exemplo a seguir, a cota de vCPUs da família DADSv5 padrão é 8 de 8, o que significa que oito núcleos estão disponíveis, mas todos os oito estão sendo usados. Se você quiser usar mais de oito núcleos para essa SKU, ou quiser usar uma SKU diferente que não tenha nenhuma cota, você pode solicitar um ajuste de cota.

   

Solicite um ajuste de cota

1. Para solicitar um aumento na cota, escolha Solicitar ajuste para o SKU desejado em sua região.

   

2. Especifique o número desejado de núcleos para a SKU selecionada e escolha Enviar. No exemplo a seguir, 20 núcleos são solicitados para vCPUs da família DSv2 padrão.

   

3. O pedido de quota demora alguns minutos a processar. O exemplo a seguir mostra o resultado de um ajuste de cota bem-sucedido.

   

   Se o ajuste de cota não puder ser aprovado automaticamente, você será direcionado a enviar uma solicitação de suporte, conforme descrito na seção a seguir.

Criar uma solicitação de suporte de cota

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 à seguinte mensagem:

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.

1. Vá para o link para iniciar uma nova solicitação de suporte para solicitar um aumento de cota. Escolha Seguinte.

   

2. Escolha Introduzir detalhes.

   

3. Insira a Região, Família de Sku, Novo limite e escolha Salvar e continuar. No exemplo a seguir, 100 núcleos são solicitados para vCPUs da família DDSv4 padrão.

   

4. Preencha os seguintes detalhes neste formulário:

   • Gravidade: escolha um dos níveis de gravidade disponíveis com base no impacto comercial.

   • Método de contacto preferencial: pode optar por ser contactado por E-mail ou por Telefone.

5. Selecione Seguinte: Rever+Criar. Confirme as informações indicadas e selecione Criar para criar um pedido de suporte.

Dentro de 24 horas, a equipe de suporte dos Pools de DevOps Gerenciados avaliará sua solicitação e entrará em contato com você.

Criar um projeto de centro de desenvolvimento e centro de desenvolvimento

Os Pools de DevOps Gerenciados exigem um centro de desenvolvimento e um projeto de centro de desenvolvimento. Você tem a opção de criar um centro de desenvolvimento e um projeto de centro de desenvolvimento ao criar seu pool no portal do Azure, mas se quiser criá-los com antecedência, execute as etapas a seguir.

• Criar um centro de desenvolvimento
• Criar um projeto de centro de desenvolvimento

Vários Pools de DevOps Gerenciados podem usar o mesmo centro de desenvolvimento e projeto de centro de desenvolvimento, e o projeto do centro de desenvolvimento não precisa estar na mesma região ou na mesma assinatura que seu Pool de DevOps Gerenciado.

Para criar um centro de desenvolvimento e um projeto de centro de desenvolvimento, você deve ter a função de Colaborador ou Proprietário atribuída à sua conta para o escopo no qual deseja criar o centro de desenvolvimento.

Criar um centro de desenvolvimento

1. Inicie sessão no portal do Azure.

2. No menu do portal do Azure, procure centros de desenvolvimento, selecione-o nas opções disponíveis e escolha Criar.

   

3. Escolha a Assinatura, o Grupo de recursos, o Nome e o Local desejados e escolha Revisar + Criar.

   

4. Na janela de confirmação, escolha Criar para criar o centro de desenvolvimento.

5. Aguarde até que o novo centro de desenvolvimento seja criado, prossiga para a próxima seção e crie um projeto de centro de desenvolvimento.

Criar um projeto de centro de desenvolvimento

1. Vá para o centro de desenvolvimento criado na seção anterior e escolha Criar projeto.

   

2. Escolha a Assinatura, o grupo de recursos, o centro de desenvolvimento, o Nome desejados e escolha Revisar + Criar.

   

3. Na janela de confirmação, escolha Criar para criar o projeto do centro de desenvolvimento.

4. Ao criar seu pool de DevOps gerenciado, especifique o centro de desenvolvimento e o projeto do centro de desenvolvimento criados nestas etapas.

Configurar sua organização do Azure DevOps

1. Conecte sua organização do Azure DevOps à ID do Microsoft Entra e verifique a associação
2. Verificar as permissões do Azure DevOps

Conecte sua organização do Azure DevOps à ID do Microsoft Entra e verifique a associação

Para criar um pool de DevOps gerenciado na sua organização do Azure DevOps, a sua organização do Azure DevOps deve estar conectada ao Microsoft Entra ID, e a sua conta de usuário deve ser membro dos seguintes locatários do Microsoft Entra ID:

• O assinante da assinatura do Azure que contém o seu Grupo de DevOps Gerido
• O locatário ao qual sua organização de DevOps do Azure está conectada

1. Exiba seu diretório atual (locatário do Azure) no portal do Azure.
2. Visualize o tenant da sua organização no Azure DevOps. Você pode ir diretamente para esta página no portal do Azure DevOps aqui: https://dev.azure.com/<your-organization>/_settings/organizationAad.
3. Se sua organização do Azure DevOps não estiver conectada à ID do Microsoft Entra, siga as etapas em Conectar sua organização à ID do Microsoft Entra e conecte-se ao locatário desejado, como o mesmo locatário que sua assinatura do Azure.

Verificar as permissões do Azure DevOps

Quando você cria um Pool de DevOps Gerenciado, a conta que você usa para entrar na assinatura do Azure que contém seu Pool de DevOps Gerenciado é usada para criar um pool de agentes correspondente em sua organização de DevOps do Azure. Para criar com êxito um Pool de DevOps Gerenciado, sua conta deve ter as seguintes permissões em sua organização do Azure DevOps.

Verificar a associação à organização do Azure DevOps

Você deve ser membro da organização do Azure DevOps antes que as permissões nesta seção possam ser atribuídas à sua conta.

Para verificar sua associação a uma organização do Azure DevOps:

1. Vá para https://dev.azure.com/{organization}/_settings/users, substituindo {organization} pelo nome da sua organização do Azure DevOps.

2. Se você puder acessar a página, revise a lista de usuários e verifique se você é membro da organização do Azure DevOps.

   Se não vir a sua conta listada ou não conseguir aceder à página, peça a um administrador da Coleção de Projetos para o adicionar como membro.

Verificar a associação ao projeto Azure DevOps

Você deve ser um membro do projeto (qualquer função é aceitável, incluindo Leitores) para cada projeto no qual deseja disponibilizar seus Pools de DevOps Gerenciados para pipelines.

Para verificar a sua participação num projeto:

1. Vá para https://dev.azure.com/{organization}/{project}/_settings/permissions, substituindo {organization} pelo nome da sua organização do Azure DevOps e {project} pelo nome do projeto.

2. Se você puder acessar a página, escolha Usuários e verifique se você está listado como usuário.

   

   Se não vir a sua conta listada ou não conseguir aceder à página, peça a um administrador da Coleção de Projetos ou a um administrador de Projetos para o adicionar como membro do projeto.

Verificar permissões de administrador ou criador ao nível de projeto para pools de agentes

Além do requisito de associação ao projeto descrito na etapa anterior, você deve ter permissões de Administrador ou Criador de pools de agentes de nível de projeto para cada projeto no qual deseja disponibilizar seus Pools de DevOps Gerenciados para pipelines.

• Você pode receber diretamente a permissão de Administrador ou Criador por um Administrador de Coleção de Projetos, um administrador de Projeto ou outro administrador de pools de agentes no nível de Projeto.
• Se você for um administrador de Coleção de Projetos ou administrador de Projetos, sua conta receberá automaticamente a permissão de Administrador .

Os Pools de DevOps Gerenciados têm dois modos diferentes para adicionar um Pool de DevOps Gerenciado aos projetos em sua organização de DevOps do Azure.

• Se você criar seu Pool de DevOps Gerenciado com Adicionar pool a todos os projetos definidos como Sim, os Pools de DevOps Gerenciados configurarão o pool para estar disponível em todos os projetos para os quais você tem a permissão de Administrador ou Criador e ignorará todos os projetos em que você não tiver essas permissões. Você pode adicionar manualmente o pool a outros projetos depois que a permissão de Administrador ou a permissão de Criador for atribuída à sua conta para esses projetos.
• Se você fornecer uma lista de projetos ao criar seu Pool de DevOps Gerenciado, deverá ter a permissão de Administrador ou Criador para cada projeto listado ou a criação do pool falhará.

Para verificar as permissões dos pools de agentes no nível do projeto:

1. 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 você deseja executar pipelines usando seu Pool de DevOps Gerenciado e escolha Configurações do projeto.

   

2. Vá para Pipelines>Pools de agentes>Segurança.

   

   Você também pode ir diretamente para as configurações de segurança dos pools de agentes no nível do https://dev.azure.com/{organization name}/{project name}/_settings/agentqueuesprojeto acessando e escolhendo Segurança.

3. Visualize a lista de permissões de utilizador para o âmbito dos pools de agentes ao nível do projeto. Neste exemplo, nenhum usuário específico é adicionado, portanto, apenas os Administradores de Coleção de Projetos e os administradores de grupo de nível de projeto padrão têm permissão para criar pools no nível do projeto ou atribuir usuários a essa função.

   

4. Se você precisar criar Pools de DevOps Gerenciados para uso neste Projeto, peça a um administrador da Coleção de Projetos, a um administrador de Projeto (ou qualquer pessoa em um dos grupos de administradores listados) ou a um administrador listado aqui para escolher Adicionar, adicioná-lo como Administrador ou Criador e escolher Salvar. Para obter mais informações, consulte Definir a segurança do pool de agentes no Azure Pipelines.

   Sugestão

   Se o botão Adicionar estiver habilitado, você terá permissão para criar Pools de DevOps Gerenciados para uso neste projeto.

   Se o botão Adicionar estiver desativado, você não terá permissão para criar Pools de DevOps Gerenciados para uso neste projeto, a menos que tenha a permissão de Criador , caso em que seu nome (ou o nome de um grupo do qual você é membro) será listado na lista de permissões de Usuário como tendo a permissão de Criador .

Próximos passos

• Crie seu primeiro pool de DevOps gerenciado