Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Serviços do Azure DevOps
Os agentes hospedados no GitHub oferecem máquinas virtuais de alto desempenho para o Azure Pipelines com cobrança conforme o uso (PAYG). Ao contrário dos agentes hospedados pela Microsoft, que usam um pool baseado em concorrência, os agentes hospedados pelo GitHub são cobrados por minuto de uso e oferecem configurações de máquina mais robustas. Os custos dependem do sistema operacional e do tamanho do agente utilizado.
Important
Esse recurso está sendo implantado e pode não estar disponível em todas as regiões ainda. Para verificar se ele foi implantado em sua região, verifique a página de cobrança Azure DevOps para obter a configuração GitHub-hosted agents.
Este recurso está atualmente em versão prévia. Ele pode mudar antes da disponibilidade geral.
Prerequisites
Para habilitar os agentes hospedados pelo GitHub, você deve ter os seguintes pré-requisitos:
| Categoria | Requisitos |
|---|---|
| Permissions | Você deve ter permissão para definir as configurações de cobrança em sua organização Azure DevOps. Para obter uma lista completa das permissões necessárias, consulte Gerenciar cobrança: pré-requisitos. |
| Subscription | Uma assinatura Azure dentro do mesmo Microsoft Entra ID da sua organização Azure DevOps. |
Habilitar a cobrança dos agentes hospedados no GitHub
Os agentes hospedados no GitHub usam cobrança conforme o uso. A cobrança é feita por minuto de tempo de execução do pipeline, com base no tamanho da máquina. Para obter informações sobre preços, consulte Azure DevOps preços.
Note
Os agentes hospedados no GitHub não oferecem plano gratuito nem minutos gratuitos. Todo o uso é cobrado por minuto. Esse modelo de cobrança conforme o uso é separado da cobrança por simultaneidade de trabalhos paralelos usada para agentes hospedados pela Microsoft.
Se a cobrança ainda não estiver habilitada em sua organização de Azure DevOps, habilite-a primeiro seguindo as instruções em Ative a cobrança para sua organização.
Ative a cobrança com pagamento conforme o uso em Configurações de cobrança. Defina Enable GitHub-hosted agents para On e selecione Save na parte inferior da página.
Use um agente hospedado no GitHub
Quando você ativa a cobrança conforme o uso, o Azure DevOps cria um novo pool de GitHub-hosted agents na sua organização. Esse pool oferece rótulos de imagem extras que cobram por minuto.
Para usar um agente hospedado GitHub em seu pipeline YAML, configure a seção pool com as seguintes propriedades:
-
name:'GitHub-hosted Agents' -
vmImage: o rótulo de imagem da VM que você deseja usar. Para obter rótulos de imagem disponíveis, consulte GitHub-hosted agent images.
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64'
steps:
- bash: |
echo Hello from macOS Tahoe arm64
uname -a
sw_vers
Exemplos adicionais:
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64-xl'
steps:
- bash: |
echo Hello from XL macOS Tahoe arm64
uname -a
hostinfo | grep memory
Imagens de agente hospedadas no GitHub
Os agentes hospedados no GitHub oferecem configurações de maior desempenho em comparação com as configurações do agente padrão hospedado pela Microsoft configurações. O pool GitHub-hosted agents oferece as seguintes especificações de hardware e imagens de máquina virtual.
Os agentes hospedados pelo GitHub fornecem imagens para as seguintes versões do macOS:
| Versão do macOS | Software incluído |
|---|---|
| macOS 26 ARM 64 | Link |
Essa imagem do macOS pode executar pipelines usando as seguintes especificações de hardware:
| Especificação de hardware | vCPU | RAM | Armazenamento (SSD) | Architecture |
|---|---|---|---|---|
| Standard | 3 | 7 GB | 14 GB | arm64 (M1) |
| XLarge | 5 (+ 8 aceleração de hardware GPU) | 14 GB | 14 GB | arm64 (M2) |
Para executar seus pipelines usando um agente hospedado GitHub, especifique o rótulo de imagem que corresponde ao sistema operacional desejado e à especificação de hardware da seguinte lista:
| OS (sistema operacional) | Especificação de hardware | Imagem | Rótulo da imagem de VM do YAML |
|---|---|---|---|
| macOS 26 | Standard | macOS 26 ARM64 | macos-26-arm64 |
| macOS 26 | XLarge | macOS 26 ARM64 XL | macos-26-arm64-xl |
Important
Durante a prévia pública, as organizações estão limitadas a oito agentes hospedados no GitHub do tipo Standard e oito do tipo XLarge. Se mais de oito trabalhos de pipeline entrarem na fila para uma mesma especificação de hardware, os oito primeiros serão executados, e os demais permanecerão na fila até que os trabalhos iniciais sejam concluídos. Se você precisar de mais de oito agentes por especificação de hardware durante a visualização pública, crie um caso de suporte.
Monitoramento do uso
Você pode monitorar o uso do pipeline de duas maneiras: usando a guia análise no pool ou usando Gerenciamento de Custos do Azure.
Exibição de análise
No pool GitHub-hosted Agents, selecione a guia Analytics. Selecione as SKUs dos agentes e o período de uso que deseja exibir. Essa seleção renderiza um grafo e lista os principais projetos que usam as SKUs de agente selecionadas. Você pode detalhar até o nível do projeto e, em seguida, do pipeline para exibir trabalhos que usam o SKU do agente.
Gerenciamento de Custos do Azure
Para filtrar por uso de Pipelines com pagamento conforme o uso, selecione:
- Categoria do medidor: Azure DevOps
- Subcategoria do medidor: Azure Pipelines
- Unidade de medida: 1/minuto
Além disso, você pode filtrar:
- Medidor
- Tag:
_organizationname_
Rede
Os agentes hospedados no GitHub têm recursos de rede semelhantes aos agentes hospedados pela Microsoft.
Os agentes hospedados no GitHub são executados na mesma infraestrutura dos runners maiores do GitHub Actions. O tráfego de rede entre os agentes hospedados pelo GitHub e seus servidores trafega pela rede pública.
Important
Você não pode usar conexões privadas, como ExpressRoute ou VPN para conectar agentes hospedados GitHub à sua rede corporativa.
Segurança
Agentes hospedados pelo GitHub têm os mesmos recursos de segurança que os agentes hospedados pela Microsoft.
GitHub agentes hospedados são executados em máquinas virtuais isoladas que são reimageadas após cada trabalho. Cada agente é dedicado a uma única organização e cada VM hospeda apenas um único agente.
- Os agentes não têm endereços IP públicos, portanto, entidades externas não podem direcioná-los diretamente.
- Cada trabalho é executado em uma VM provisionada recentemente, portanto, nenhum dado persiste entre trabalhos.
- As imagens hospedadas não estão em conformidade com os parâmetros de comparação de proteção de CIS. Para usar imagens reforçadas pelo CIS, considere agentes auto-hospedados ou Pools de DevOps Gerenciados.
Funcionalidades e limitações
Os agentes hospedados no GitHub têm capacidades e limitações semelhantes às dos agentes hospedados pela Microsoft, como máquinas virtuais novas para cada tarefa e imagens atualizadas automaticamente com o software mais recente, com as seguintes diferenças principais.
Agentes hospedados pelo GitHub:
- Ofereça tamanhos de máquina maiores com mais vCPUs, RAM e espaço em disco do que os agentes hospedados em Microsoft padrão.
- Cobrança por minuto de uso sem camada gratuita.
Comparar opções do pool de agentes
| Feature | Agentes hospedados pela Microsoft | Agentes hospedados no GitHub (PAYG) | Agentes auto-hospedados |
|---|---|---|---|
| Faturamento | Tarefas paralelas (com base em concorrência) | Por minuto (pagamento conforme o uso) | Sua própria infraestrutura |
| Plano gratuito | Sim (limitado) | No | N/A |
| Tamanhos de máquina | Standard (2 vCPU, 7 GB RAM) | Vários (maiores do que os hospedados pela Microsoft) | Personalizado |
| Manutenção | Automatic | Automatic | Manual |
| Software personalizado | Instalar durante a execução do pipeline | Instalar durante a execução do pipeline | Pré-instalado |
| Rede corporativa | Sem acesso direto | Sem acesso direto | Acesso direto |