förhandsversion av GitHub värdbaserade agenter (betala per användning)

Azure DevOps-tjänster

GitHub värdbaserade agenter tillhandahåller virtuella datorer med högre prestanda för Azure-pipelines med payg-fakturering (betala per användning). Till skillnad från Microsoft-värdbaserade agenter som använder en samtidighetsbaserad pool fakturerar GitHub värdbaserade agenter per minuts användning och erbjuder kraftfullare datorkonfigurationer. Avgifterna beror på operativsystemet och dimensionerna för den agent som används.

Förutsättningar

Om du vill aktivera GitHub värdbaserade agenter måste du ha följande förutsättningar:

Category Requirements
Permissions Du måste ha behörighet att konfigurera faktureringsinställningar i din Azure DevOps organisation. En fullständig lista över nödvändiga behörigheter finns i Hantera fakturering: Krav.
Subscription En Azure-prenumeration i samma Microsoft Entra ID som din Azure DevOps organisation.

Aktivera fakturering för GitHub värdbaserade agenter

GitHub värdbaserade agenter använder betala per användning-fakturering. Du debiteras per minuts pipelinekörningstid baserat på maskinstorlek. Prisinformation finns i Azure DevOps prissättning.

Note

GitHub värdbaserade agenter tillhandahåller inte en kostnadsfri nivå eller kostnadsfria minuter. All användning debiteras per minut. Den här faktureringsmodellen för att betala per användning är skild från den samtidighetsfakturering för parallelljobb som används för Microsoft-hostade agenter.

  1. Om faktureringen inte redan är aktiverad i din Azure DevOps organisation aktiverar du den först genom att följa anvisningarna i Set up billing for your organization.

  2. Aktivera betala per användning-fakturering i faktureringsinställningar. Ange Enable GitHub-hosted agents till On och välj Spara längst ned på sidan.

    Skärmbild som visar hur du aktiverar prissättning enligt förbrukning.

Använda en GitHub värdbaserad agent

När du aktiverar fakturering enligt förbrukning skapar Azure DevOps en ny GitHub-värdbaserad agentpool i din organisation. Den här poolen erbjuder extra bildetiketter som debiteras per minut.

Om du vill använda en GitHub värdbaserad agent i YAML-pipelinen konfigurerar du avsnittet pool med följande egenskaper:

pool:
  name: 'GitHub-hosted Agents'
  vmImage: 'macos-26-arm64'
steps:
- bash: |
    echo Hello from macOS Tahoe arm64
    uname -a
    sw_vers

Ytterligare exempel:

pool:
  name: 'GitHub-hosted Agents'
  vmImage: 'macos-26-arm64-xl'
steps:
- bash: |
    echo Hello from XL macOS Tahoe arm64
    uname -a
    hostinfo | grep memory
pool:
  name: 'GitHub-hosted Agents'
  vmImage: 'ubuntu-24.04-8-core'
steps:
- bash: |
    echo Hello from Ubuntu 24.04 8 core
    lsb_release -d
    echo "# cores: $(nproc)"
    free -h
- pwsh: |
    Write-Host "`$PSVersionTable.OS"
    $PSVersionTable.OS
    Write-Host "Number of logical processors: $([Environment]::ProcessorCount)"
    Get-Content /proc/meminfo | Select-String '^Mem(Total|Available):'
pool:
  name: 'GitHub-hosted Agents'
  vmImage: 'windows-2025-vs2026-16-core'
steps:
- pwsh: |
    Write-Host "(Get-ComputerInfo).WindowsProductName"
    Get-ComputerInfo | Select-Object WindowsProductName
    Write-Host "`$PSVersionTable.OS"
    $PSVersionTable.OS
    Write-Host "Number of logical processors: $([Environment]::ProcessorCount)"
    Write-Host "Installed memory (MB): $([Math]::Round((Get-ComputerInfo).CsTotalPhysicalMemory / 1MB))"

Agentbilder som hanteras av GitHub

GitHub värdbaserade agenter erbjuder högre prestandakonfigurationer jämfört med standardagenten Microsoft värdbaserad konfigurationer. Poolen GitHub värdbaserade agenter innehåller följande maskinvaruspecifikationer och avbildningar av virtuella datorer.

Important

Under den offentliga förhandsversionen är organisationer begränsade till åtta GitHub agenter per SKU. Om fler än åtta pipeline-jobb köar för varje maskinvaruspecifikation körs de första åtta jobben, och resterande jobb förblir i kö tills de första jobben har slutförts. Om du behöver fler än åtta agenter per maskinvaruspecifikation under den offentliga förhandsversionen skapar du ett supportärende.

GitHub värdbaserade agenter tillhandahåller avbildningar för följande macOS-versioner:

macOS-version Programvara som ingår
macOS 26 ARM 64 Link
macOS med Xcode 27 (offentlig förhandsversion) Link

Note

GitHub macOS-agenter körs alltid i USA oavsett var din Azure DevOps organisation finns.

Den här macOS-avbildningen kan köra pipelines med hjälp av följande maskinvaruspecifikationer:

Maskinvaruspecifikation vCPU RAM Lagring (SSD) Architecture
Standard 3 7 GB 14 GB arm64 (M1)
XLarge 5 (+ 8 GPU-maskinvaruacceleration) 14 GB 14 GB arm64 (M2)

Om du vill köra dina pipelines med hjälp av en GitHub värdbaserad agent anger du den avbildningsetikett som matchar önskat operativsystem och maskinvaruspecifikation från följande lista:

Operativsystem (OS) Maskinvaruspecifikation Bild YAML VM-avbildningsetikett
macOS 26 Standard macOS ARM64 macos-26-arm64
macOS 26 XLarge macOS ARM64 XL macos-26-arm64-xl
macOS med Xcode 27 Standard macOS ARM64 xcode-27
macOS med Xcode 27 XLarge macOS ARM64 XL xcode-27-xlarge

Xcode-baserad namngivningskonvention för macOS-avbildningar

Med lanseringen av macOS med Xcode 27-avbildningen (offentlig förhandsversion) introducerade Microsoft en ny namngivningskonvention för macOS-avbildningar. Varje nytt avbildningsnamn baseras på en större Xcode-version i stället för det underliggande operativsystemet. Varje avbildningsversion stöder en större Xcode-version.

Med den här namngivningsmodellen kan utvecklare rikta in sig på önskad Apple-verktygskedja. Den visar hur macOS CI-jobb ofta definieras, vilket är den Xcode-verktygskedja som krävs i stället för det underliggande operativsystemet. Operativsystemet kan ändras under avbildningens livslängd. Om du vill se programvaran som ingår i Xcode 27-avbildningen, inklusive versionen av macOS-operativsystemet, följer du den medföljande programvarulänken för avbildningen i föregående tabell.

Övervaka användning

Du kan övervaka din pipelineanvändning på två sätt: med hjälp av analysfliken i poolen eller med hjälp av Azure Cost Management.

Analysvy

I poolen GitHub-värdbaserade agenter väljer du fliken Analytics. Välj de agent-SKU:er och den användningsperiod som du vill visa. Det här urvalet visar ett diagram och listar toppprojekten som använder de valda agent-SKU:erna. Du kan borra dig ned till projekt- och sedan pipelinenivå för att visa jobb som använder agent-SKU:n.

Skärmbild som visar hur du använder analysfliken.

Azure Cost Management

Om du vill filtrera på förbrukningsbaserad användning av Pipelines väljer du:

  • Mätarkategori: Azure DevOps
  • Mätarunderkategori: Azure-pipelines
  • Måttenhet: 1/minut

Dessutom kan du filtrera på:

  • Tagg: _organizationname_
  • Tagg: _projectname_

Följande skärmbild visar en typisk kostnadsanalysvy i Azure Cost Management:

Skärmbild som visar hur du övervakar kostnaden för användningsbaserad betalning.

Nätverkande

GitHub-värdbaserade agenter har liknande nätverksfunktioner som Microsoft värdbaserade agenter.

GitHub värdbaserade agenter körs på samma infrastruktur som GitHub Actions större löpare. Nätverkstrafik mellan GitHub värdbaserade agenter och dina servrar går över det offentliga nätverket.

Important

Du kan inte använda privata anslutningar som ExpressRoute eller VPN för att ansluta GitHub agenter till företagets nätverk.

Security

GitHub värdbaserade agenter har samma säkerhetsfunktioner som Microsoft värdbaserade agenter.

Agenter som driftas av GitHub körs på isolerade virtuella maskiner som återställs med en ny avbild efter varje jobb. Varje agent är dedikerad till en enskild organisation och varje virtuell dator är endast värd för en enda agent.

  • Agenter har inte offentliga IP-adresser, så externa entiteter kan inte rikta in sig direkt på dem.
  • Varje jobb körs på en nyetablerade virtuell dator, så inga data sparas mellan jobben.
  • Värdbaserade bilder överensstämmer inte med CIS-härdningsmått. Om du vill använda CIS-härdade avbildningar bör du överväga lokalt installerade agenter eller Hanterade DevOps-pooler.

Funktioner och begränsningar

GitHub-värdbaserade agenter har liknande funktioner och begränsningar som Microsoft-värdbaserade agenter, till exempel nya virtuella datorer för varje jobb och automatiskt uppdaterade avbildningar med den senaste programvaran, med följande viktiga skillnader.

GitHub värdbaserade agenter:

  • Erbjud större datorer med fler virtuella processorer (vCPU:er), mer RAM och mer diskutrymme än vanliga Microsoft-värdbaserade agenter.
  • Fakturera per minut av användning utan kostnadsfri nivå.

Jämför alternativ för agentpool

Feature Microsofts värdbaserade agenter GitHub värdbaserade agenter (PAYG) Självhostade agenter
Fakturering Parallella jobb (samtidighetsbaserade) Per minut (betala efter användning) Din egen infrastruktur
Gratis nivå Ja (begränsat) No N/A
Datorstorlekar Standard Olika (större än Microsoft värdbaserade) Skräddarsydd
Underhåll Automatiskt Automatiskt Manuell
Anpassad programvara Installera under pipelinekörning Installera under pipelinekörning Preinstalled
Företagsnätverk Ingen direkt åtkomst Ingen direkt åtkomst Direktåtkomst

Se även