Verwenden von auf GitHub gehosteten Runnern

Verwenden eines GitHub-gehosteten Runners

Um einen von GitHub gehosteten Runner zu verwenden, erstellen Sie einen Job und verwenden Sie runs-on, um den Typ des Runners anzugeben, der den Job verarbeitet, z. B. ubuntu-latest, windows-latest oder macos-latest. Die vollständige Liste der Läufertypen finden Sie unter Gehostete Runnerreferenz auf GitHub. Wenn Sie repo: write Zugriff auf ein Repository haben, können Sie eine Liste der Runner anzeigen, die im Repository zur Verwendung in Workflows verfügbar sind. Weitere Informationen finden Sie unter Anzeigen verfügbarer Läufer für ein Repository.

Wenn der Job beginnt, stellt GitHub automatisch eine neue VM für diesen Job bereit. Alle Schritte eines Auftrags werden auf demselben Runner ausgeführt, damit die Aktionen in diesem Auftrag Informationen über das Dateisystem austauschen können. Sie können Workflows direkt auf der VM oder in einem Docker-Container ausführen. Wenn der Auftrag abgeschlossen ist, wird die VM automatisch außer Betrieb genommen.

Das folgende Diagramm zeigt, wie zwei Aufträge in einem Workflow auf zwei verschiedenen GitHubgehosteten Läufern ausgeführt werden.

Der folgende Beispielworkflow weist zwei Aufträge namens Run-npm-on-Ubuntu und Run-PSScriptAnalyzer-on-Windows auf. Wenn dieser Workflow ausgelöst wird, GitHub stellt sie einen neuen virtuellen Computer für jeden Auftrag bereit.

• Der Auftrag namens Run-npm-on-Ubuntu wird auf einer Linux-VM ausgeführt, da der runs-on:-Wert des Auftrags ubuntu-latest lautet.
• Der Auftrag namens Run-PSScriptAnalyzer-on-Windows wird auf einer Windows-VM ausgeführt, da der runs-on:-Wert des Auftrags windows-latest lautet.

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@v6
      - 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@v6
      - 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

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@v6
      - 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@v6
      - 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

Während der Auftrag ausgeführt wird, können die Protokolle und die Ausgabe in der GitHub Benutzeroberfläche angezeigt werden:

Die GitHub Actions Läufer-Anwendung ist Open Source. Du kannst im Runner-Repository mitwirken und Dateiprobleme einreichen.

Anzeigen verfügbarer Runner für ein Repository

Wenn Sie repo: write Zugriff auf ein Repository haben, können Sie sich eine Liste der Runner anzeigen lassen, die für das Repository verfügbar sind.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Actions.

   

3. Klicke in der linken Randleiste unter dem Abschnitt „Management“ auf Runners.

4. Überprüfen Sie die Liste der verfügbaren Runner, die von GitHub für das Repository gehostet werden.

5. Wenn Sie optional die Bezeichnung eines Runners kopieren möchten, um sie in einem Workflow zu verwenden, klicken Sie auf rechts neben dem Runner, und klicken Sie dann auf Bezeichnung kopieren.