Identification des exécuteurs disponibles pour un référentiel
Si 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.
-
Sur GitHub, accédez à la page principale du référentiel.
-
Sous le nom de votre référentiel, cliquez sur Actions.
-
Dans la barre latérale gauche, sous la section « Gestion », cliquez sur Exécuteurs.
-
Passez en revue la liste des exécuteurs disponibles pour le dépôt.
-
Si vous le souhaitez, pour copier l’étiquette d’un exécuteur pour l’utiliser dans un flux de travail, cliquez sur à droite de l’exécuteur, puis cliquez sur Copier l’étiquette.
Remarque
Les propriétaires d’entreprise et d’organisation et les utilisateurs disposant de l’autorisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs » peuvent créer de nouveaux exécuteurs à partir de 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.
Pour plus d’informations, consultez Gestion des exécuteurs de plus grande taille et Ajout d’exécuteurs auto-hébergés. Pour plus d’informations sur les rôles d’organisation personnalisés, consultez Autorisations des rôles d’organisation personnalisés.
Cibler des exécuteurs plus puissants dans un flux de workflow
Une fois que vous avez identifié les exécuteur plus grands que vous souhaitez utiliser, vous pouvez les cibler dans votre flux de travail avec des groupes d’exécuteurs, des étiquettes de flux de travail ou les deux. Utilisez des groupes d’exécuteurs pour router des travaux vers un ensemble d’exécuteurs, des étiquettes de flux de travail pour cibler des exécuteurs avec une étiquette spécifique, ou les deux lorsqu’un travail doit correspondre aux deux conditions.
Si un administrateur a désactivé les exécuteurs standard hébergés sur GitHub, vous pouvez uniquement utiliser des groupes d’exécuteurs.
Ciblage par groupe de runners
Référencez le nom du groupe d’exécuteurs dans votre workflow. Utilisez cette option lorsque vous souhaitez acheminer un travail vers n’importe quel exécuteur disponible dans un groupe spécifique.
Dans cet exemple, des runners ont été ajoutés à un groupe appelé build-runners. La clé runs-on envoie le travail à n’importe quel exécuteur disponible dans le groupe build-runners :
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: build-runners
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Dans cet exemple, des runners ont été ajoutés à un groupe appelé build-runners. La clé runs-on envoie le travail à n’importe quel exécuteur disponible dans le groupe build-runners :
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: build-runners
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Dans cet exemple, la runs-on clé envoie le travail à n’importe quel exécuteur disponible dans le macos-build-runners groupe :
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on:
group: macos-build-runners
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
Ciblage par étiquette de flux de travail
Référencez une étiquette de flux de travail dans votre flux de travail lorsque vous souhaitez router un travail vers des exécuteurs qui partagent une étiquette spécifique.
Exécuteur de plus grande taille reçoivent automatiquement une étiquette de flux de travail correspondant au nom de l'exécuteur.
Dans cet exemple, la clé runs-on envoie la tâche à n’importe quel exécuteur disponible ayant l’étiquette ubuntu-24.04-16core :
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Dans cet exemple, la clé runs-on envoie la tâche à n’importe quel exécuteur disponible ayant l’étiquette windows-2022-16core :
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
labels: windows-2022-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Pour macOS exécuteurs plus grands, vous pouvez utiliser soit les étiquettes de workflow définies dans GitHub, soit l’étiquette de workflow automatiquement attribuée d’après le nom exécuteur plus grand que vous avez défini lors de sa création. Pour obtenir la liste des étiquettes de flux de travail macOS disponibles, consultez Référence pour les runners de grande taille.
Dans cet exemple, la clé runs-on envoie la tâche à n’importe quel runner disponible auquel le libellé macos-26-xlarge a été attribué.
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on: macos-26-xlarge
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
Utilisation d’étiquettes et de groupes pour contrôler où les travaux sont exécutés
Utilisez à la fois les étiquettes et les groupes lorsqu’une tâche doit s’exécuter uniquement sur les exécuteurs d’un groupe spécifique qui possèdent également une étiquette spécifique. L’exécuteur doit répondre aux deux exigences pour pouvoir exécuter le travail.
Quand vous combinez des groupes et des étiquettes, l’exécuteur doit satisfaire aux deux exigences pour pouvoir exécuter le travail.
Dans cet exemple, la clé runs-on combine group et labels de sorte que le job soit acheminé vers n’importe quel runner disponible dans le groupe qui possède également une étiquette correspondante :
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Quand vous combinez des groupes et des étiquettes, l’exécuteur doit satisfaire aux deux exigences pour pouvoir exécuter le travail.
Dans cet exemple, la clé runs-on combine group et labels de sorte que le job soit acheminé vers n’importe quel runner disponible dans le groupe qui possède également une étiquette correspondante :
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Dans cet exemple, la clé runs-on combine group et labels de sorte que le job soit acheminé vers n’importe quel runner disponible dans le groupe qui possède également une étiquette correspondante :
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on:
group: macos-runners
labels: macos-26-xlarge
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
Lectures complémentaires
Pour plus d’informations sur la syntaxe de la runs-on clé, consultez Syntaxe de flux de travail pour GitHub Actions.
Pour obtenir des spécifications, des étiquettes, des limitations et des informations de dépannage, consultez Référence pour les runners de grande taille.