Skip to main content

Utilisation des exécuteurs hébergés par GitHub

Vous pouvez assigner une tâche à exécuter sur une machine virtuelle hébergée par GitHub.

Utilisation d'un exécuteur hébergé par GitHub

Pour vous servir d'un exécuteur hébergé par GitHub, créez un travail et utilisez runs-on afin de spécifier le type d'exécuteur qui va traiter le travail, par exemple ubuntu-latest, windows-latest ou macos-latest. Pour obtenir la liste complète des types d'exécuteurs, consultez « Référence des exécuteurs hébergés par GitHub ». Si vous avez un accès repo: write à un référentiel, vous pouvez visualiser une liste des exécuteurs disponibles pour les utiliser dans les workflow dans le référentiel. Pour plus d'informations, consultez « Visualisation des exécuteurs disponibles pour un référentiel ».

Quand 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.

Le diagramme suivant illustre l'exécution de deux travaux d'un workflow sur deux exécuteurs différents hébergés par GitHub.

Diagramme d'un workflow qui se compose de deux travaux. Un travail s'exécute sur Ubuntu et l'autre sur Windows.

L'exemple de workflow suivant comporte deux travaux, nommés Run-npm-on-Ubuntu et Run-PSScriptAnalyzer-on-Windows. Quand ce workflow se déclenche, GitHub provisionne une nouvelle machine virtuelle pour chaque travail.

  • 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.
  • 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.
YAML
name: Run commands on different operating systems
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  Run-npm-on-Ubuntu:
    name: Run npm on Ubuntu
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm help

  Run-PSScriptAnalyzer-on-Windows:
    name: Run PSScriptAnalyzer on Windows
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install PSScriptAnalyzer module
        shell: pwsh
        run: |
          Set-PSRepository PSGallery -InstallationPolicy Trusted
          Install-Module PSScriptAnalyzer -ErrorAction Stop
      - name: Get list of rules
        shell: pwsh
        run: |
          Get-ScriptAnalyzerRule

Pendant l'exécution du travail, vous pouvez voir les journaux et la sortie dans l'IU de GitHub :

Capture d'écran d'une exécution de workflow. Les étapes du travail « Exécuter PSScriptAnalyzer sur Windows » s'affichent.

L’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.

Visualisation 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.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre dépôt, cliquez sur Actions.

    Capture d’écran des onglets du référentiel « github/docs ». L’onglet « Actions » est mis en surbrillance avec un encadré orange.

  3. Dans la barre latérale gauche, sous la section « Gestion », cliquez sur Exécuteurs.

  4. Passez en revue la liste des exécuteurs hébergés par GitHub disponibles pour le référentiel.

  5. 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 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.