Verwenden von auf GitHub gehosteten Runnern

Verwenden eines von GitHub gehosteten Runners

Um einen von GitHub gehosteten Runner zu verwenden, müssen Sie einen Auftrag erstellen und mithilfe von runs-on den Typ von Runner angeben, der den Auftrag verarbeiten wird, z. B. ubuntu-latest, windows-latest oder macos-latest. Die vollständige Liste der Runnertypen findest du unter Gehostete Runnerreferenz auf GitHub. Wenn du repo: write-Zugriff auf ein Repository hast, kannst du eine Liste der Runner anzeigen, die in Workflows im Repository verwendet werden können. Weitere Informationen findest du unter Anzeigen verfügbarer Runner für ein Repository.

Wenn der Auftrag beginnt, stellt GitHub automatisch eine neue VM für diesen Auftrag 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 veranschaulicht, wie zwei Aufträge in einem Workflow auf zwei unterschiedlichen von GitHub gehosteten Runnern 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, stellt GitHub eine neue VM 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@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

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

Während der Auftrag ausgeführt wird, können Protokolle und Ausgabe in der Benutzeroberfläche von GitHub 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 Namen deines Repositorys auf Aktionen.

   

3. Klicke auf der linken Randleiste unter dem Abschnitt „Verwaltung“ auf Runner.

4. Überprüfen Sie die Liste der verfügbaren GitHub-gehosteten Runner für das Repository.

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.