Versão preliminar de agentes hospedados no GitHub (pagamento conforme a utilização)

Serviços de DevOps do Azure

Agentes alojados no GitHub fornecem máquinas virtuais de maior desempenho para Azure Pipelines com faturação pay-as-you-go (PAYG). Ao contrário dos agentes alojados pela Microsoft, que utilizam um conjunto baseado em concorrência, os agentes alojados pelo GitHub são cobrados por minuto de utilização e oferecem configurações de máquina mais potentes. As cargas dependem do sistema operativo e das dimensões do agente utilizado.

Importante

Esta funcionalidade está a ser implementada e pode ainda não estar disponível em todas as regiões. Para verificar se está disponibilizado na sua região, consulte a sua página de faturação do Azure DevOps para a definição agentes alojados no GitHub.

Esta funcionalidade está atualmente em pré-visualização. Pode mudar antes da disponibilidade geral.

Pré-requisitos

Para ativar agentes alojados no GitHub, deve ter os seguintes pré-requisitos:

Category Requisitos
Permissions Deve ter permissão para configurar as definições de faturação na sua organização Azure DevOps. Para uma lista completa das permissões necessárias, consulte Gerenciar faturação: Pré-requisitos.
Subscription Uma subscrição Azure que partilha o mesmo Microsoft Entra ID da sua organização Azure DevOps.

Ativar a faturação de agentes alojados no GitHub

Os agentes hospedados no GitHub utilizam faturação conforme a utilização. É cobrado por minuto de tempo de execução do pipeline com base no tamanho da máquina. Para informações sobre preços, consulte Azure DevOps preços.

Observação

Os agentes alojados no GitHub não fornecem um nível gratuito nem minutos gratuitos. Todo o consumo é faturado por minuto. Este modelo de faturação consoante a utilização é distinto da faturação da simultaneidade de trabalhos paralelos utilizada para agentes alojados pela Microsoft.

  1. Se a faturação ainda não estiver ativada na sua organização Azure DevOps, ative-a primeiro seguindo as instruções em Configurar faturação para a sua organização.

  2. Ative a faturação pay-as-you-go nas definições de faturação. Defina Ative os agentes alojados GitHub em On e selecione Save no final da página.

    Captura de ecrã que mostra como ativar preços pay-as-you-go.

Use um agente hospedado no GitHub

Quando ativa a faturação pay-as-you-go, o Azure DevOps cria um novo pool de GitHub-hosted agents na sua organização. Esta piscina oferece etiquetas de imagem extra que cobram por minuto.

Para usar um agente GitHub alojado no seu pipeline YAML, configure a secção pool com as seguintes propriedades:

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 agentes alojadas no GitHub

Os agentes alojados no GitHub oferecem configurações de desempenho mais elevado em comparação com as configurações do agente alojado pela Microsoft configurações. O conjunto de agentes alojados no GitHub inclui as seguintes especificações de hardware e imagens de máquinas virtuais.

Os agentes alojados no GitHub fornecem imagens para as seguintes versões do macOS:

Versão para macOS Software incluído
macOS 26 ARM 64 Link

Esta 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 da GPU) 14 GB 14 GB arm64 (M2)

Para executar os seus pipelines usando um agente hospedado no GitHub, especifique a etiqueta da imagem que corresponde à especificação do sistema operativo e hardware desejada a partir da seguinte lista:

Sistema operacional (SO) Especificação de hardware Imagem Rótulo de imagem YAML VM
macOS 26 Standard macOS 26 ARM64 macos-26-arm64
macOS 26 XLarge macOS 26 ARM64 XL macos-26-arm64-xl

Importante

Durante a versão de pré-visualização pública, as organizações estão limitadas a oito agentes Standard alojados no GitHub e oito agentes XLarge alojados no GitHub. Se mais de oito trabalhos de pipeline estiverem em fila por especificação de hardware, os primeiros oito trabalhos são executados e os restantes ficam em fila até os trabalhos iniciais serem concluídos. Se precisar de mais de oito agentes por especificação de hardware durante a pré-visualização pública, crie um caso de suporte.

Monitorização da utilização

Pode monitorizar a utilização do seu pipeline de duas formas: usando o separador de análises no pool ou usando o Gestão de Custos do Azure.

Vista de análise

No conjunto de Agentes alojados no GitHub, selecione o separador Analytics. Selecione os SKUs dos agentes e o período de utilização que pretende ver apresentados. Esta seleção gera um gráfico e lista os principais projetos que utilizam os SKUs de agente selecionados. Pode descer até ao nível do projeto e, depois, ao nível do pipeline para mostrar as tarefas que usam o SKU do agente.

Captura de ecrã que mostra como usar o separador de análises.

Gestão de Custos do Azure

Para filtrar o uso de Pipelines pay-as-you-go, selecione:

  • Categoria de medidores: Azure DevOps
  • Subcategoria do contador: Azure Pipelines
  • Unidade de Medida: 1/Minuto

Além disso, pode filtrar em:

  • Meter
  • Etiqueta: _organizationname_

Captura de ecrã que mostra como monitorizar o custo consoante a utilização.

Rede

Os agentes alojados no GitHub têm capacidades de rede semelhantes às dos agentes alojados pela Microsoft.

Os agentes alojados pelo GitHub são executados na mesma infraestrutura que os executores de maior dimensão do GitHub Actions. O tráfego de rede entre agentes alojados no GitHub e os teus servidores passa pela rede pública.

Importante

Não pode usar ligações privadas como ExpressRoute ou VPN para ligar agentes alojados GitHub à sua rede corporativa.

Segurança

Os agentes alojados no GitHub têm as mesmas funcionalidades de segurança que os agentes alojados pela Microsoft.

Agentes alojados no GitHub correm em máquinas virtuais isoladas que são reimaginadas após cada trabalho. Cada agente é dedicado a uma única organização e cada VM hospeda apenas um único agente.

Capacidades e limitações

Os agentes GitHub alojados têm semelhantes aos agentes Microsoft alojados, como máquinas virtuais novas para cada trabalho e imagens atualizadas automaticamente com o software mais recente, com as seguintes diferenças-chave.

Agentes alojados no GitHub:

  • Oferecem máquinas de tamanhos maiores, com mais vCPUs, RAM e espaço em disco do que os agentes padrão hospedados pela Microsoft.
  • Fature por cada minuto de utilização, sem escalão gratuito.

Compare as opções do grupo de agentes

Feature Agentes alojados pela Microsoft Agentes alojados no GitHub (PAYG) Agentes autogeridos
Faturação Empregos paralelos (baseados em concorrência) Por minuto (pagamento conforme o uso) A sua própria infraestrutura
Plano gratuito Sim (limitado) No N/A
Tamanhos das máquinas Standard (2 vCPU, 7 GB RAM) Vários (maiores do que os alojados pela Microsoft) Personalizado
Manutenção Automatic Automatic Manual
Software personalizado Instalar durante a execução do pipeline Instalar durante a execução do pipeline Preinstalled
Rede corporativa Sem acesso direto Sem acesso direto Acesso direto

Ver também