{"meta":{"title":"Utilisation des exécuteurs hébergés par GitHub","intro":"Vous pouvez affecter un travail à exécuter sur une machine virtuelle hébergée par GitHub.","product":"GitHub Actions","breadcrumbs":[{"href":"/fr/actions","title":"GitHub Actions"},{"href":"/fr/actions/how-tos","title":"Guides pratiques"},{"href":"/fr/actions/how-tos/manage-runners","title":"Gérer les exécuteurs"},{"href":"/fr/actions/how-tos/manage-runners/github-hosted-runners","title":"Exécuteurs hébergés par GitHub"},{"href":"/fr/actions/how-tos/manage-runners/github-hosted-runners/use-github-hosted-runners","title":"Utiliser des runners hébergés par GitHub"}],"documentType":"article"},"body":"# Utilisation des exécuteurs hébergés par GitHub\n\nVous pouvez affecter un travail à exécuter sur une machine virtuelle hébergée par GitHub.\n\n## Utilisation d’un exécuteur GitHubhébergé\n\nPour utiliser un exécuteur hébergé par GitHub, créez une tâche et utilisez `runs-on` pour spécifier le type d’exécuteur qui traitera la tâche, tels que `ubuntu-latest`, `windows-latest` ou `macos-latest`. Pour obtenir la liste complète des types de runners, consultez [Référence des exécuteurs hébergés par GitHub](/fr/actions/reference/runners/github-hosted-runners#supported-runners-and-hardware-resources). Si vous disposez d’un accès `repo: write` à un dépôt, vous pouvez afficher la liste des runners disponibles pour les workflows de ce dépôt. Pour plus d’informations, consultez [Affichage des runners disponibles pour un dépôt](#viewing-available-runners-for-a-repository).\n\nLorsque le travail commence, GitHub provisionne automatiquement une nouvelle machine virtuelle pour ce travail. Toutes les étapes du travail s'exécutent sur la machine virtuelle. Ainsi, elles peuvent partager des informations à l'aide du système de fichiers de l'exécuteur. Vous pouvez exécuter des workflows directement sur la machine virtuelle ou dans un conteneur Docker. À la fin du travail, la machine virtuelle est automatiquement désactivée.\n\nLe diagramme suivant montre comment deux travaux d’un flux de travail sont exécutés sur deux exécuteurs hébergés différents GitHub.\n\n![Diagramme d'un workflow qui se compose de deux travaux. Un travail s'exécute sur Ubuntu et l'autre sur Windows.](/assets/images/help/actions/overview-github-hosted-runner.png)\n\nL'exemple de workflow suivant comporte deux travaux, nommés `Run-npm-on-Ubuntu` et `Run-PSScriptAnalyzer-on-Windows`. Lorsque ce flux de travail est déclenché, GitHub provisionne une nouvelle machine virtuelle pour chaque travail.\n\n* Le travail nommé `Run-npm-on-Ubuntu` s'exécute sur une machine virtuelle Linux, car le `runs-on:` du travail spécifie `ubuntu-latest`.\n* Le travail nommé `Run-PSScriptAnalyzer-on-Windows` s'exécute sur une machine virtuelle Windows, car le `runs-on:` du travail spécifie `windows-latest`.\n\n```yaml copy\nname: Run commands on different operating systems\non:\n  push:\n    branches: [ main ]\n  pull_request:\n    branches: [ main ]\n\njobs:\n  Run-npm-on-Ubuntu:\n    name: Run npm on Ubuntu\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm help\n\n  Run-PSScriptAnalyzer-on-Windows:\n    name: Run PSScriptAnalyzer on Windows\n    runs-on: windows-latest\n    steps:\n      - uses: actions/checkout@v6\n      - name: Install PSScriptAnalyzer module\n        shell: pwsh\n        run: |\n          Set-PSRepository PSGallery -InstallationPolicy Trusted\n          Install-Module PSScriptAnalyzer -ErrorAction Stop\n      - name: Get list of rules\n        shell: pwsh\n        run: |\n          Get-ScriptAnalyzerRule\n```\n\nPendant l’exécution du travail, les journaux et la sortie sont visibles dans l’interface utilisateur de GitHub :\n\n![Capture d'écran d'une exécution de workflow. Les étapes du travail « Exécuter PSScriptAnalyzer sur Windows » s'affichent.](/assets/images/help/repository/actions-runner-output.png)\n\nL’exécuteur GitHub Actions est une application open source. Vous pouvez signaler et contribuer à résoudre des problèmes dans le référentiel de l’[exécuteur](https://github.com/actions/runner).\n\n## Visualisation des exécuteurs disponibles pour un dépôt\n\nSi vous avez un accès `repo: write` à un référentiel, vous pouvez visualiser une liste des exécuteurs disponibles pour le référentiel.\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n2. Sous le nom de votre référentiel, cliquez sur **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-play\" aria-label=\"play\" role=\"img\"><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z\"></path></svg> Actions**.\n\n   ![Capture d’écran des onglets du référentiel « github/docs ». L’onglet « Actions » est mis en surbrillance avec un encadré orange.](/assets/images/help/repository/actions-tab-global-nav-update.png)\n3. Dans la barre latérale gauche, sous la section « Gestion », cliquez sur **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-server\" aria-label=\"server\" role=\"img\"><path d=\"M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v4c0 .372-.116.717-.314 1 .198.283.314.628.314 1v4a1.75 1.75 0 0 1-1.75 1.75H1.75A1.75 1.75 0 0 1 0 12.75v-4c0-.358.109-.707.314-1a1.739 1.739 0 0 1-.314-1v-4C0 1.784.784 1 1.75 1ZM1.5 2.75v4c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-4a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Zm.25 5.75a.25.25 0 0 0-.25.25v4c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-4a.25.25 0 0 0-.25-.25ZM7 4.75A.75.75 0 0 1 7.75 4h4.5a.75.75 0 0 1 0 1.5h-4.5A.75.75 0 0 1 7 4.75ZM7.75 10h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM3 4.75A.75.75 0 0 1 3.75 4h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 3 4.75ZM3.75 10h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1 0-1.5Z\"></path></svg> Exécuteurs**.\n4. Passez en revue la liste des exécuteurs hébergés par GitHub disponibles pour le référentiel.\n5. Si vous le souhaitez, pour copier l’étiquette d’un exécuteur pour l’utiliser dans un flux de travail, cliquez sur <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-kebab-horizontal\" aria-label=\"More options\" role=\"img\"><path d=\"M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path></svg> à droite de l’exécuteur, puis cliquez sur **Copier l’étiquette**.\n\n> \\[!NOTE]\n> Les propriétaires d’entreprise ou d’organisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs » peuvent créer des exécuteurs depuis cette page. Pour créer un exécuteur, cliquez sur **Nouvel exécuteur** en haut à droite de la liste des exécuteurs pour en ajouter au référentiel.\n>\n> Pour plus d’informations, consultez [Gestion des exécuteurs de plus grande taille](/fr/actions/how-tos/manage-runners/larger-runners/manage-larger-runners) et [Ajout d’exécuteurs auto-hébergés](/fr/actions/how-tos/manage-runners/self-hosted-runners/add-runners)."}