Agentes alojados na Microsoft

Os agentes hospedados pela Microsoft só estão disponíveis com os Serviços de DevOps do Azure, que são hospedados na nuvem. Não podes usar agentes alojados na Microsoft ou o pool de agentes Azure Pipelines com o Azure DevOps Server on-premises. Com estas versões on-premises, deve usar agentes auto-hospedados.

Se seus pipelines estiverem no Azure Pipelines, você poderá executar convenientemente seus trabalhos usando um agente hospedado pela Microsoft. Com agentes hospedados pela Microsoft, a manutenção e as atualizações acontecem automaticamente.

Você sempre tem a versão mais recente da imagem da VM especificada em seu pipeline. Cada vez que executar uma pipeline, obterá uma nova máquina virtual para cada tarefa na pipeline. A máquina virtual é descartada após um trabalho. Qualquer alteração feita por um trabalho no sistema de arquivos da máquina virtual, como o check-out do código, não estará disponível no próximo trabalho.

Os agentes hospedados pela Microsoft podem executar trabalhos diretamente na VM ou em um contêiner.

O Azure Pipelines fornece um conjunto de agentes predefinido chamado Azure Pipelines com agentes alojados na Microsoft.

Para muitas equipas, este processo é a forma mais simples de executar os seus trabalhos. Você pode experimentá-lo primeiro para ver se funciona para a sua compilação ou implantação. Caso contrário, você pode usar agentes de Conjuntos de Dimensionamento de Máquina Virtual ou um agente auto-hospedado.

Programa informático

O pool de agentes do Azure Pipelines oferece várias imagens de máquina virtual para escolher, cada uma incluindo uma ampla gama de ferramentas e software. Você pode ver o software instalado para cada imagem escolhendo o link Software incluído na tabela a seguir. Para obter mais informações sobre o ciclo de vida do software e o cronograma de substituição de imagens e software, consulte GitHub Actions Runner Images - Software and Image Support.

Como identificar pipelines usando uma imagem hospedada obsoleta

Para identificar pipelines que estão a usar uma imagem obsoleta, vá até à seguinte localização na sua organização: https://dev.azure.com/{organization}/{project}/_settings/agentqueues, e filtre pelo nome da imagem para confirmar. O exemplo a seguir verifica a vs2017-win2016 imagem.

Você também pode consultar o histórico de trabalhos para imagens obsoletas em vários projetos usando o script localizado aqui, como ilustrado no exemplo abaixo.

./QueryJobHistoryForRetiredImages.ps1 -accountUrl https://dev.azure.com/{org} -pat {pat}

Usar um agente hospedado pela Microsoft

jobs:
- job: Linux
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - script: echo hello from Linux
- job: macOS
  pool:
    vmImage: 'macOS-latest'
  steps:
  - script: echo hello from macOS
- job: Windows
  pool:
    vmImage: 'windows-latest'
  steps:
  - script: echo hello from Windows

Evite referências codificadas

Quando você usa um agente hospedado pela Microsoft, sempre use variáveis para se referir ao ambiente de compilação e aos recursos do agente. Por exemplo, não fixe a letra da unidade de disco ou a pasta que contém o repositório. O layout preciso dos agentes hospedados está sujeito a alterações sem aviso prévio.

Equipamento

Os agentes alojados na Microsoft que executam imagens do Windows e Linux são aprovisionados em máquinas virtuais para fins gerais do Azure com uma CPU de 2 núcleos, 7 GB de RAM e 14 GB de espaço em disco SSD. Estas máquinas virtuais estão co-localizadas na mesma geografia que a sua organização Azure DevOps.

Os agentes que executam imagens do macOS são aprovisionados em Mac pros com uma CPU de 3 núcleos, 14 GB de RAM e 14 GB de espaço em disco SSD. Estes agentes são sempre executados nos Estados Unidos, independentemente da localização da organização do Azure DevOps. Se a soberania dos dados é importante para ti e se a tua organização não estiver nos EUA, então não deves usar imagens do macOS. Mais informações.

Todas estas máquinas têm, pelo menos, 10 GB de espaço livre em disco para a execução dos pipelines. Este espaço livre é consumido quando o pipeline realiza o check-out do código fonte, descarrega pacotes, extrai imagens do Docker ou gera ficheiros intermediários.

Rede

Em algumas configurações, talvez seja necessário saber o intervalo de endereços IP onde os agentes estão implementados. Por exemplo, se precisar de conceder acesso aos agentes alojados através de uma firewall, poderá restringir esse acesso pelo endereço IP. Como o Azure DevOps utiliza a rede global do Azure, os intervalos de IP variam ao longo do tempo. A Microsoft publica um arquivo JSON semanal listando intervalos de IP para datacenters do Azure, divididos por região. Este ficheiro é atualizado semanalmente com novos intervalos de IP planeados. Apenas a versão mais recente do ficheiro fica disponível para transferência. Se precisar de versões anteriores, tem de transferi-las e arquivá-las todas as semanas à medida que ficam disponíveis. Os novos intervalos de IP entram em vigor na semana seguinte. Recomendamos que volte a consultar frequentemente (pelo menos uma vez por semana) para garantir que mantém uma lista atualizada. Se os trabalhos do agente começarem a falhar, um passo importante de resolução de problemas é confirmar que a configuração corresponde à lista mais recente de endereços IP. Os intervalos de endereços IP para os agentes hospedados estão listados no arquivo semanal em AzureCloud.<region>, como AzureCloud.westus para a região Oeste dos Estados Unidos.

Os agentes hospedados são executados na mesma geografia do Azure que a sua organização. Cada geografia contém uma ou mais regiões. Embora o seu agente possa operar na mesma região que a sua organização, não é garantido que o faça. Para obter a lista completa de intervalos de IP possíveis para o agente, utilize os intervalos de IP de todas as regiões contidas na sua geografia. Por exemplo, se sua organização estiver localizada na geografia dos Estados Unidos, você deverá usar os intervalos de IP para todas as regiões dessa geografia.

Para determinar sua geografia, navegue até https://dev.azure.com/<your_organization>/_settings/organizationOverview, obtenha sua região e localize a geografia associada na tabela de geografia do Azure. Depois de identificar a sua geografia, use os intervalos de IP do ficheiro semanal para todas as regiões dessa geografia.

Para identificar os possíveis intervalos de IP para agentes hospedados pela Microsoft

1. Identifique a região da sua organização nas configurações da organização.
2. Identifique a Geografia do Azure para a região da sua organização.
3. Mapeie os nomes das regiões em sua geografia para o formato usado no arquivo semanal, seguindo o formato de AzureCloud.<region>, como AzureCloud.westus. Você pode mapear os nomes das regiões da lista Geografia do Azure para o formato usado no arquivo semanal ao rever os nomes de região passados para o construtor das regiões conforme definido no código-fonte da classe Region, nas Bibliotecas de Gerenciamento do Azure para .NET.

   Nota

   Como não há nenhuma API nas Bibliotecas de Gerenciamento do Azure para .NET para listar as regiões de uma geografia, você deve listá-las manualmente, conforme mostrado no exemplo a seguir.

4. Recupere os endereços IP de todas as regiões da sua área geográfica do ficheiro semanal. Se a sua região for o Sul do Brasil ou o Oeste da Europa, você deve incluir intervalos de IP adicionais com base na sua geografia de fallback, conforme descrito na nota a seguir.

Exemplo

No exemplo a seguir, os intervalos de endereços IP de agentes hospedados para uma organização na região Oeste dos Estados Unidos são recuperados do arquivo semanal. Como a região Oeste dos EUA está na geografia dos Estados Unidos, os endereços IP de todas as regiões da geografia dos Estados Unidos estão incluídos. Neste exemplo, os endereços IP são gravados no console.

using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

namespace WeeklyFileIPRanges
{
    class Program
    {
        // Path to the locally saved weekly file
        const string weeklyFilePath = @"C:\MyPath\ServiceTags_Public_20230904.json";

        static void Main(string[] args)
        {
            // United States geography has the following regions:
            // Central US, East US, East US 2, East US 3, North Central US, 
            // South Central US, West Central US, West US, West US 2, West US 3
            // This list is accurate as of 9/8/2023
            List<string> USGeographyRegions = new List<string>
            {
                "centralus",
                "eastus",
                "eastus2",
                "eastus3",
                "northcentralus",
                "southcentralus",
                "westcentralus",
                "westus",
                "westus2",
                "westus3"
            };

            // Load the weekly file
            JObject weeklyFile = JObject.Parse(File.ReadAllText(weeklyFilePath));
            JArray values = (JArray)weeklyFile["values"];

            foreach (string region in USGeographyRegions)
            {
                string tag = $"AzureCloud.{region}";
                Console.WriteLine(tag);

                var ipList =
                    from v in values
                    where tag.Equals((string)v["name"], StringComparison.OrdinalIgnoreCase)
                    select v["properties"]["addressPrefixes"];

                foreach (var ip in ipList.Children())
                {
                    Console.WriteLine(ip);
                }
            }
        }
    }
}

Etiquetas de serviço

Os agentes hospedados pela Microsoft não podem ser listados por marcas de serviço. Se estiver a tentar conceder acesso aos agentes alojados aos seus recursos, terá de seguir o método de listagem de permissões do intervalo de IP.

Segurança

Os agentes hospedados pela Microsoft são executados na plataforma segura do Azure. No entanto, você deve estar ciente das seguintes considerações de segurança.

• Embora os agentes alojados pela Microsoft corram numa rede pública Azure, não lhes são atribuídos endereços IP públicos. Assim, entidades externas não podem direcionar agentes alojados pela Microsoft.
• Os agentes alojados pela Microsoft são executados em VMs individuais, que são reimaginadas após cada execução. Cada agente é dedicado a uma única organização e cada VM hospeda apenas um único agente.
• Há vários benefícios em executar seu pipeline em agentes hospedados pela Microsoft, do ponto de vista da segurança. Se você executar código não confiável em seu pipeline, como contribuições de forks, será mais seguro executar o pipeline em agentes hospedados pela Microsoft do que em agentes auto-hospedados que residem em sua rede corporativa.
• Quando um pipeline precisa aceder aos seus recursos corporativos atrás de um firewall, deves permitir o intervalo de endereços IP para a região do Azure. Isto pode aumentar a sua exposição, uma vez que a gama de endereços IP é bastante grande e uma vez que as máquinas nesta gama também podem pertencer a outros clientes. A melhor maneira de evitar isso é evitar a necessidade de acessar recursos internos. Para obter informações sobre como implantar artefatos num conjunto de servidores, consulte Comunicação para implantar em servidores de destino.
• As imagens hospedadas não estão em conformidade com os benchmarks de proteção do CIS. Para usar imagens endurecidas pelo CIS, é necessário criar agentes auto-hospedados ou agentes de conjunto de escala ou pools de DevOps geridos.

Capacidades e limitações

Agentes hospedados pela Microsoft:

• Tenha o software acima mencionado. Você também pode adicionar software durante sua compilação ou lançamento usando tarefas do instalador de ferramentas.
  • Você recebe um agente recém-imagiado para cada trabalho no seu pipeline.
• Forneça 10 GB de armazenamento para suas saídas de origem e compilação.
• Forneça um nível gratuito:
  • Projeto público: 10 trabalhos paralelos gratuitos hospedados pela Microsoft que podem ser executados por até 360 minutos (6 horas) de cada vez, sem limite de tempo total por mês. Contacte-nos para aumentar os seus limites de nível gratuito.
  • Projeto privado: um trabalho paralelo gratuito que pode ser executado por até 60 minutos de cada vez, até que você tenha usado 1.800 minutos (30 horas) por mês. Você pode pagar por capacidade adicional para cada trabalho paralelo. Os trabalhos paralelos pagos removem o limite de tempo mensal e permitem que você execute cada trabalho por até 360 minutos (6 horas). Compre trabalhos paralelos hospedados pela Microsoft.
  • Quando cria uma nova organização no Azure DevOps, não recebe automaticamente esses créditos gratuitos. Para solicitar a subvenção gratuita para projetos públicos ou privados, apresente um pedido.
• Executar em máquinas virtuais de uso geral do Microsoft Azure Standard_DS2_v2.
• Executar como administrador no Windows e como utilizador sudo sem senha no Linux.
• (Apenas Linux) Execute etapas em um cgroup que oferece 6 GB de memória física e 13 GB de memória total.
• Use imagens de VM que sejam atualizadas regularmente (de três em três semanas).

Os agentes hospedados pela Microsoft não oferecem:

• A capacidade de se conectar remotamente.
• A capacidade de depositar artefatos num compartilhamento de arquivos UNC.
• A capacidade de unir máquinas diretamente à sua rede corporativa.
• A capacidade de obter máquinas de construção maiores ou mais potentes.
• A capacidade de pré-instalar software personalizado. Você pode instalar software durante uma execução de pipeline, como através de tarefas de instalação de ferramentas ou em um script.
• Potenciais vantagens de desempenho que você pode obter usando agentes auto-hospedados que podem iniciar e executar compilações mais rapidamente. Mais informações
• A capacidade de executar construções XAML.
• A capacidade de reverter para uma versão anterior da imagem da VM. Você sempre usa a versão mais recente.

Se os agentes hospedados pela Microsoft não atenderem às suas necessidades, poderá implantar os seus próprios agentes autoalojados ou utilizar agentes de conjunto escaláveis ou Pools de DevOps Geridos.

FAQ

Como posso ver que software está incluído numa imagem?

Você pode ver o software instalado para cada agente hospedado escolhendo o link Software incluído na tabela Software .

Syncing repository: PathFilter (Git)
Prepending Path environment variable with directory containing 'git.exe'.
git version
git version 2.26.2.windows.1

Como a Microsoft escolhe o software e as versões para colocar na imagem?

Mais informações sobre as versões de software incluídas nas imagens podem ser encontradas em Diretrizes para o que está instalado.

Quando são atualizadas as imagens?

Normalmente, as imagens são atualizadas semanalmente. Você pode verificar os selos de status que estão no formato 20200113.x onde a primeira parte indica a data em que a imagem foi atualizada.

O que posso fazer se o software de que preciso for removido ou substituído por uma versão mais recente?

Você pode nos informar criando um problema no GitHub escolhendo os links de Software Incluído na tabela Usar um agente hospedado pela Microsoft.

Você também pode usar um agente auto-hospedado que inclua as versões exatas do software de que você precisa. Para obter mais informações, consulte Agentes autohospedados.

E se eu precisar de uma máquina maior com mais poder de processamento, memória ou espaço em disco?

Não podemos aumentar a memória, o poder de processamento ou o espaço em disco para agentes hospedados pela Microsoft, mas pode utilizar agentes autohospedados, agentes de conjuntos escaláveis ou Pools de DevOps Geridos, hospedados em máquinas com as especificações desejadas.

Não consigo selecionar um agente hospedado pela Microsoft nem agendar a minha compilação ou implantação. O que devo fazer?

Os agentes hospedados pela Microsoft só estão disponíveis no Azure Pipelines e não no Azure DevOps Server.

Por padrão, todos os colaboradores do projeto em uma organização têm acesso aos agentes hospedados pela Microsoft. No entanto, o administrador da sua organização pode limitar o acesso de agentes hospedados pela Microsoft para selecionar usuários ou projetos. Peça ao proprietário da sua organização de DevOps do Azure para lhe conceder permissão para utilizar um agente alojado pela Microsoft. Consulte segurança do pool de agentes.

Os meus pipelines executados em agentes alojados na Microsoft demoram mais tempo a concluir. Como os posso acelerar?

Se o pipeline se tornou recentemente mais lento, consulte a nossa página de estado para verificar se existem falhas. Podemos estar a ter problemas com o nosso serviço. Em alternativa, veja as alterações feitas no código ou pipeline da aplicação. O tamanho do seu repositório durante o check-out pode ter aumentado, pode estar a carregar artefactos maiores ou a executar mais testes.

Se estiver apenas a configurar um pipeline e estiver a comparar o desempenho dos agentes alojados na Microsoft com o computador local ou um agente autoalojado, anote as especificações do hardware que utilizamos para executar os trabalhos. Não nos é possível disponibilizar-lhe computadores maiores ou poderosos. Pode considerar usar agentes autogeridos, agentes de conjuntos de escalonamento ou pools DevOps geridos, se este desempenho não for aceitável.

Preciso de mais agentes. O que posso fazer?

Todas as organizações de DevOps do Azure recebem vários trabalhos paralelos gratuitos para projetos de código aberto e um trabalho paralelo gratuito e minutos limitados todos os meses para projetos privados. Se você precisar de minutos adicionais ou trabalhos paralelos para seu projeto de código aberto, entre em contato com o suporte. Se você precisar de minutos adicionais ou trabalhos paralelos para o seu projeto privado, então você pode comprar mais.

O meu pipeline é bem-sucedido no agente hospedado localmente, mas falha nos agentes hospedados pela Microsoft. O que devo fazer?

O teu agente auto-hospedado provavelmente tem todas as dependências certas instaladas, enquanto as mesmas dependências, ferramentas e software não estão instalados nos agentes alojados pela Microsoft. Primeiro, analise cuidadosamente a lista de software instalada em agentes hospedados pela Microsoft seguindo o link para Software incluído na tabela acima. Em seguida, compare aquilo com o software instalado no seu agente auto-hospedado. Em alguns casos, os agentes hospedados pela Microsoft podem ter as ferramentas necessárias (por exemplo, Visual Studio), mas todos os componentes opcionais necessários podem não ter sido instalados. Se você encontrar diferenças, então você tem duas opções:

• Você pode criar um novo problema no repositório, onde rastreamos solicitações de software adicional. Entrar em contato com o suporte não pode ajudá-lo a configurar um novo software em agentes hospedados pela Microsoft.

• Você pode usar agentes autohospedados ou agentes de conjunto escaláveis ou pools geridos de DevOps. Com estes agentes, você tem total controle das imagens usadas para executar os seus pipelines.

Minha compilação é bem-sucedida em minha máquina local, mas falha em agentes hospedados pela Microsoft. O que devo fazer?

A tua máquina local provavelmente tem todas as dependências certas instaladas, enquanto as mesmas dependências, ferramentas e software não estão instalados em agentes alojados pela Microsoft. Primeiro, analise cuidadosamente a lista de software instalada em agentes hospedados pela Microsoft seguindo o link para Software incluído na tabela acima. Em seguida, compare isso com o software instalado em sua máquina local. Em alguns casos, os agentes hospedados pela Microsoft podem ter as ferramentas necessárias (por exemplo, Visual Studio), mas todos os componentes opcionais necessários podem não ter sido instalados. Se você encontrar diferenças, então você tem duas opções:

• Você pode criar um novo problema no repositório, onde rastreamos solicitações de software adicional. Esta é a sua melhor aposta para instalar um novo software. Entrar em contato com o suporte não o ajudará a configurar um novo software em agentes hospedados pela Microsoft.

• Você pode usar agentes autohospedados ou agentes de conjunto escaláveis ou pools geridos de DevOps. Com estes agentes, você tem total controle das imagens usadas para executar os seus pipelines.

O meu fluxo de trabalho falha com o erro: "sem espaço disponível no dispositivo".

Os agentes alojados na Microsoft têm apenas 10 GB de espaço em disco disponível para executar a tarefa. Este espaço é consumido quando você atualiza o código-fonte, quando baixa pacotes, quando baixa imagens Docker ou quando produz ficheiros intermédios. Infelizmente, não podemos aumentar o espaço livre disponível nas imagens alojadas pela Microsoft. Você pode reestruturar o seu pipeline de forma a que ele possa caber neste espaço. Ou, pode considerar usar agentes auto-hospedados ou agentes de conjuntos dimensionáveis ou Grupos Geridos de DevOps .

A minha pipeline executada por agentes hospedados pela Microsoft requer acesso a servidores na nossa rede corporativa. Como obtemos uma lista de endereços IP para permitir a entrada no nosso firewall?

Consulte a seção Intervalos de IP do agente

Nosso pipeline executado em agentes hospedados pela Microsoft não consegue resolver o nome de um servidor em nossa rede corporativa. Como podemos corrigir isso?

Se se referir ao servidor pelo seu nome DNS, certifique-se de que o servidor está acessível publicamente na Internet através do seu nome DNS. Se você se referir ao seu servidor pelo endereço IP, certifique-se de que o endereço IP esteja acessível publicamente na Internet. Em ambos os casos, certifique-se de que qualquer firewall entre os agentes e sua rede corporativa tenha os intervalos de IP do agente permitidos.

Estou recebendo um erro de autorização de IP SAS de uma conta de Armazenamento do Azure

Se você receber um código de erro SAS, é mais provável porque os intervalos de endereços IP dos agentes hospedados pela Microsoft não são permitidos devido às suas regras de Armazenamento do Azure. Existem algumas soluções alternativas:

1. Gerencie as regras de rede IP para sua conta de Armazenamento do Azure e adicione os intervalos de endereços IP para seus agentes hospedados.
2. Em seu pipeline, use a CLI do Azure para atualizar o conjunto de regras de rede para sua conta de Armazenamento do Azure antes de acessar o armazenamento e, em seguida, restaure o conjunto de regras anterior.
3. Use agentes auto-hospedados ou agentes de conjunto escaláveis ou pools de DevOps geridos.

Como posso selecionar manualmente versões de ferramentas no agente macOS Alojado?

XCode

Se você usar a tarefa Xcode incluída no Azure Pipelines e no Azure DevOps Server, poderá selecionar uma versão do Xcode nas propriedades dessa tarefa. Caso contrário, para definir manualmente a versão do Xcode a ser usada no pool de agentes do macOS hospedado, antes xcodebuild da tarefa de compilação, execute esta linha de comando como parte da compilação, substituindo o número de versão do Xcode 13.2 conforme necessário:

/bin/bash -c "sudo xcode-select -s /Applications/Xcode_13.2.app/Contents/Developer"

As versões do Xcode no pool de agentes do Hosted macOS podem ser encontradas aqui.

Mono

Para selecionar manualmente uma versão do Mono para usar no pool de agentes do macOS hospedado, execute este script em cada tarefa da sua compilação antes da tarefa de compilação do Mono, especificando o link simbólico com a versão do Mono necessária:

SYMLINK=<symlink>
MONOPREFIX=/Library/Frameworks/Mono.framework/Versions/$SYMLINK
echo "##vso[task.setvariable variable=DYLD_FALLBACK_LIBRARY_PATH;]$MONOPREFIX/lib:/lib:/usr/lib:$DYLD_LIBRARY_FALLBACK_PATH"
echo "##vso[task.setvariable variable=PKG_CONFIG_PATH;]$MONOPREFIX/lib/pkgconfig:$MONOPREFIX/share/pkgconfig:$PKG_CONFIG_PATH"
echo "##vso[task.setvariable variable=PATH;]$MONOPREFIX/bin:$PATH"