Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services
les agents hébergés GitHub offrent des machines virtuelles plus performantes pour les Azure Pipelines avec facturation pay-as-you-go (PAYG). Contrairement aux agents hébergés par Microsoft qui utilisent un pool basé sur l’accès concurrentiel, les agents hébergés par GitHub facturent par minute d’utilisation et offrent des configurations d’ordinateur plus puissantes. Les frais dépendent du système d’exploitation et des dimensions de l’agent utilisé.
Important
Cette fonctionnalité est déployée et n’est peut-être pas encore disponible dans toutes les régions. Pour vérifier s'il est déployé dans votre région, vérifiez votre page de facturation Azure DevOps pour connaître le paramètre des agents hébergés par GitHub.
Actuellement, cette fonctionnalité est uniquement disponible en tant que version préliminaire. Il peut changer avant la disponibilité générale.
Prerequisites
Pour activer les agents hébergés GitHub, vous devez disposer des conditions préalables suivantes :
| Catégorie | Exigences |
|---|---|
| Permissions | Vous devez avoir l’autorisation de configurer les paramètres de facturation dans votre organisation Azure DevOps. Pour obtenir la liste complète des autorisations requises, consultez Gérer la facturation : Conditions préalables. |
| Subscription | Un abonnement Azure avec le même identificateur Microsoft Entra que votre organisation Azure DevOps. |
Activer la facturation des agents hébergés GitHub
Les agents hébergés par GitHub utilisent une facturation à l’utilisation. La facturation s’effectue par minute d’exécution du pipeline, en fonction de la taille de la machine. Pour plus d’informations sur la tarification, consultez Azure DevOps tarification.
Note
GitHub agents hébergés ne fournissent pas de niveau gratuit ni de minutes gratuites. Toutes les utilisations sont facturées par minute. Ce modèle de facturation à l’usage est distinct de la facturation de l’exécution concurrente des travaux parallèles utilisée pour les agents hébergés par Microsoft.
Si la facturation n'est pas déjà activée dans votre organisation Azure DevOps, activez-la d'abord en suivant les instructions de Set up billing for your organization.
Activez la facturation à l’utilisation dans les paramètres de facturation. Réglez Activer les agents hébergés par GitHub sur Activé, puis sélectionnez Enregistrer en bas de la page.
Utiliser un agent hébergé par GitHub
Lorsque vous activez la facturation à l’utilisation, Azure DevOps crée un nouveau pool d’agents hébergés par GitHub dans votre organisation. Ce pool offre des étiquettes d’images supplémentaires qui facturent par minute.
Pour utiliser un agent hébergé GitHub dans votre pipeline YAML, configurez la section pool avec les propriétés suivantes :
-
name:'GitHub-hosted Agents' -
vmImage: étiquette d’image de machine virtuelle que vous souhaitez utiliser. Pour connaître les étiquettes d’image disponibles, consultez les images d’agent hébergées par GitHub.
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64'
steps:
- bash: |
echo Hello from macOS Tahoe arm64
uname -a
sw_vers
Exemples supplémentaires :
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64-xl'
steps:
- bash: |
echo Hello from XL macOS Tahoe arm64
uname -a
hostinfo | grep memory
images d’agent hébergées par GitHub
Les agents hébergés par GitHub offrent des configurations plus performantes que les configurations d’agent standard hébergées par Microsoft. Le pool d’agents hébergés par GitHub propose les spécifications matérielles et les images de machines virtuelles suivantes.
les agents hébergés GitHub fournissent des images pour les versions macOS suivantes :
| Version de macOS | Logiciels inclus |
|---|---|
| macOS 26 ARM 64 | Lien |
Cette image macOS peut exécuter des pipelines à l’aide des spécifications matérielles suivantes :
| Spécification matérielle | Processeurs virtuels | RAM | Stockage (SSD) | Architecture |
|---|---|---|---|---|
| Norme | 3 | 7 Go | 14 Go | arm64 (M1) |
| XLarge | 5 (+ 8 accélération matérielle GPU) | 14 Go | 14 Go | arm64 (M2) |
Pour exécuter vos pipelines à l’aide d’un agent hébergé par GitHub, spécifiez l’étiquette d’image qui correspond à votre système d’exploitation souhaité et à la spécification matérielle dans la liste suivante :
| Système d’exploitation (OS) | Spécification matérielle | Image | Étiquette d’image de machine virtuelle YAML |
|---|---|---|---|
| macOS 26 | Norme | macOS 26 ARM64 | macos-26-arm64 |
| macOS 26 | XLarge | macOS 26 ARM64 XL | macos-26-arm64-xl |
Important
Pendant la préversion publique, les organisations sont limitées à huit Standard et huit agents hébergés par XLarge GitHub. Si plus de huit tâches de pipeline sont mises en file d’attente pour chaque spécification matérielle, les huit premières s’exécutent et les autres restent en file d’attente jusqu’à ce que les tâches initiales soient terminées. Si vous avez besoin de plus de huit agents par spécification matérielle pendant la préversion publique, créez un cas de support.
Surveillance de l’utilisation
Vous pouvez surveiller l’utilisation de votre pipeline de deux manières : à l’aide de l’onglet Analytique du pool ou à l’aide de Gestion des coûts Azure.
Vue Analyses
Dans le pool Agents hébergés sur GitHub, sélectionnez l’onglet Analytique. Sélectionnez les SKU des agents et la période d’utilisation que vous souhaitez afficher. Cette sélection affiche un graphique et répertorie les principaux projets qui utilisent les références SKU d’agent sélectionnées. Vous pouvez descendre jusqu’au niveau du projet, puis du pipeline, pour afficher les tâches qui utilisent le SKU de l’agent.
Gestion des coûts Azure
Pour filtrer l’utilisation de Pipelines avec facturation à l’utilisation, sélectionnez :
- Catégorie de compteur : Azure DevOps
- Sous-catégorie de compteur : Azure Pipelines
- Unité de mesure : 1/minute
En outre, vous pouvez filtrer sur :
- Compteur
- Étiquette:
_organizationname_
Networking
Les agents hébergés GitHub ont des fonctionnalités networking similaires comme des agents hébergés par Microsoft.
Les agents hébergés par GitHub s’exécutent sur la même infrastructure que les runners plus grands de GitHub Actions. Le trafic réseau entre les agents hébergés par GitHub et vos serveurs passe par le réseau public.
Important
Vous ne pouvez pas utiliser de connexions privées telles que ExpressRoute ou VPN pour connecter des agents hébergés GitHub à votre réseau d'entreprise.
Security
Les agents hébergés GitHub ont les mêmes fonctionnalités security que les agents hébergés par Microsoft.
Les agents hébergés par GitHub fonctionnent sur des machines virtuelles isolées qui sont recréées à partir d’une image après chaque tâche. Chaque agent est dédié à une seule organisation, et chaque machine virtuelle héberge uniquement un seul agent.
- Les agents n’ont pas d’adresses IP publiques. Par conséquent, les entités externes ne peuvent pas les cibler directement.
- Chaque travail s’exécute sur une machine virtuelle fraîchement provisionnée, de sorte qu’aucune donnée ne persiste entre les travaux.
- Les images hébergées ne sont pas conformes aux référentiels de durcissement CIS. Pour utiliser des images renforcées CIS, envisagez d’utiliser des agents auto-hébergés ou des pools DevOps managés.
Capacités et limitations
les agents hébergés GitHub ont des capabilities et limitations similaires comme des agents hébergés par Microsoft, tels que de nouvelles machines virtuelles pour chaque travail et des images mises à jour automatiquement avec le logiciel le plus récent, avec les principales différences suivantes.
agents hébergés par GitHub :
- Proposez des tailles d’ordinateur plus grandes avec plus de processeurs virtuels, de RAM et d’espace disque que les agents hébergés par des Microsoft standard.
- Facturation par minute d’utilisation sans niveau gratuit.
Comparer les options de pool d’agents
| Fonctionnalité | Agents hébergés par Microsoft | agents hébergés sur GitHub (PAYG) | Agents auto-hébergés |
|---|---|---|---|
| Facturation | Tâches parallèles (en fonction de la concurrence) | Par minute (paiement à l’utilisation) | Votre propre infrastructure |
| Niveau Gratuit | Oui, limitée | Non | N/A |
| Tailles de machine | Standard (2 processeurs virtuels, 7 Go de RAM) | Divers (plus grands que ceux hébergés par Microsoft) | Personnalisée |
| Entretien | Automatique | Automatique | Manuel |
| Logiciel personnalisé | Installer pendant l’exécution du pipeline | Installer pendant l’exécution du pipeline | Préinstallé |
| Réseau d’entreprise | Aucun accès direct | Aucun accès direct | Accès direct |