Verwenden von selbstgehosteten Runnern in einem Workflow

Github-gehostete Runner für Unternehmen

Anzeigen verfügbarer Runner für ein Repository

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Actions.

   

3. Klicken Sie oben in der Liste der Runner auf die Registerkarte Selbst gehostet.

4. Überprüfen Sie die Liste der verfügbaren selbst gehosteten Runner für das Repository. Diese Liste enthält sowohl selbst gehostete Runner als auch Runner-Skalierungssätze, die mit Actions Runner Controller erstellt wurden. Weitere Informationen finden Sie unter Actions Runner Controller (Steuerung für Aktionsläufer).

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.

Standard-Labels verwenden, um Aufträge weiterzuleiten

Ein selbstgehosteter Runner erhält automatisch bestimmte Labels, wenn er zu GitHub Actions hinzugefügt wird. Diese werden verwendet, um das Betriebssystem und die Hardwareplattform anzuzeigen:

•         `self-hosted`: Standardlabel, das auf selbst gehostete Runner angewendet wird.
  

•         `linux`, `windows` oder `macOS`: Wird je nach Betriebssystem angewendet.
  

•         `x64`, `ARM`oder `ARM64`: Wird je nach Hardwarearchitektur angewendet.
  

Du kannst die YAML deines Workflows verwenden, um Aufträge an eine Kombination dieser Bezeichnungen zu senden. In diesem Beispiel ist ein selbstgehosteter Runner, der allen drei Labels entspricht, geeignet, den Job auszuführen.

runs-on: [self-hosted, linux, ARM64]

•         `self-hosted` – Aufgabe auf einem selbstgehosteten Runner ausführen.
  

•         `linux` – Nur Linux-basierten Runner verwenden.
  

•         `ARM64` – Nur auf ARM64-Hardware basierenden Runner verwenden.
  

Wenn Du individuelle selbst gehostete Runner ohne die Standardbezeichnungen erstellen möchtest, übergib beim Erstellen des Runners das --no-default-labels-Flag. Actions Runner Controller unterstützt keine mehrfachen Labels.

Benutzerdefinierte Labels verwenden, um Jobs zu lenken

Sie können jederzeit benutzerdefinierte Labels erstellen und diesen Ihren selbstgehosteten Runnern zuordnen. Mit benutzerdefinierten Bezeichnungen kannst du Aufträge an bestimmte Typen von selbstgehosteten Runnern senden, basierend auf deren Bezeichnungen.

Wenn du z. B. einen Auftrag hast, der einen bestimmten Typ von Grafikhardware erfordert, kannst du eine benutzerdefinierte Bezeichnung mit dem Namen gpu erstellen und den Runnern zuordnen, auf denen diese Hardware installiert ist. Ein selbst-gehosteter Runner, der allen zugewiesenen Labels entspricht, ist dann berechtigt, den Job auszuführen.

Dieses Beispiel zeigt einen Job, der Standard- und benutzerdefinierte Labels kombiniert:

runs-on: [self-hosted, linux, x64, gpu]

•         `self-hosted` – Aufgabe auf einem selbstgehosteten Runner ausführen.
  

•         `linux` – Nur Linux-basierten Runner verwenden.
  

•         `x64` – Nur auf x64-Hardware basierenden Runner verwenden.
  

•         `gpu` – Diese benutzerdefinierte Bezeichnung wurde manuell selbstgehosteten Runnern zugewiesen, auf denen die GPU-Hardware installiert ist.
  

Diese Labels arbeiten kumulativ. Ein selbstgehosteter Runner muss also alle vier Labels aufweisen, um den Auftrag verarbeiten zu dürfen.

Verwenden von Gruppen zum Weiterleiten von Aufträgen

In diesem Beispiel wurden Ubuntu-Runner zu einer Gruppe namens ubuntu-runners hinzugefügt. Der runs-on-Schlüssel sendet den Auftrag an einen beliebigen verfügbaren Runner in der Gruppe ubuntu-runners:

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on: 
      group: ubuntu-runners
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Verwenden von Bezeichnungen und Gruppen zum Weiterleiten von Aufträgen

Wenn du Gruppen und Bezeichnungen kombinierst, muss der Runner beide Anforderungen erfüllen, um zum Ausführen des Auftrags berechtigt zu sein.

In diesem Beispiel wird eine Runnergruppe namens ubuntu-runners mit Ubuntu-Runnern aufgefüllt, denen zudem die Bezeichnung ubuntu-24.04-16core zugewiesen wurde. Der runs-on-Schlüssel kombiniert group und labels, sodass der Auftrag an einen beliebigen verfügbaren Runner innerhalb der Gruppe weitergeleitet wird, der auch eine übereinstimmende Bezeichnung aufweist:

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on:
      group: ubuntu-runners
      labels: ubuntu-24.04-16core
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v