Weitere Informationen zur Verwendung von Bezeichnungen zum Weiterleiten von Aufträgen an bestimmte Typen von selbstgehosteten Runnern findest du unter Verwenden von selbstgehosteten Runnern in einem Workflow. Du kannst Aufträge auch an Runner in einer bestimmten Gruppe weiterleiten. Weitere Informationen findest du unter Auswählen des Runners für einen Auftrag.
Ein selbstgehosteter Runner kann entweder in den Repository-, Organisations- oder Enterprise-Kontoeinstellungen auf GitHub gefunden werden. Um einen selbst-gehosteten Läufer zu verwalten, musst Du über die folgenden Berechtigungen verfügen, abhängig davon, wo der selbst-gehostete Läufer hinzugefügt wurde:
- Benutzer-Repository: Du musst der Repositorybesitzer sein.
- Organisation: Du musst ein Organisationsbesitzer sein.
- Organisationsrepository: Du musst du ein Organisationsbesitzer sein oder über Administratorzugriff auf das Repository verfügen.
Note
Action Runner Controller unterstützt keine mehrfachen Bezeichnungen. Weitere Informationen findest du in unserer Dokumentation zu Action Runner Controller.
Einen benutzerdefinierten Label erstellen
Du kannst benutzerdefinierte Bezeichnungen für Runner auf Repository- und Organisationsebene erstellen.
- Erstellen einer benutzerdefinierten Bezeichnung für einen Repository-Runner
- Erstellen einer benutzerdefinierten Bezeichnung für einen Organisationsrunner
Hinweis: Bei Bezeichnungen wird die Groß-/Kleinschreibung nicht beachtet.
Erstellen einer benutzerdefinierten Bezeichnung für einen Repository-Runner
- Navigiere zur Hauptseite des Repositorys, in der deine selbstgehostete Runnergruppe registriert ist.
- Klicke auf -Einstellungen.
- Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
- Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.
- Klicke im Abschnitt „Bezeichnungen“ auf .
- Gib im Feld „Bezeichnung suchen oder erstellen“ den Namen deiner neuen Bezeichnung ein, und klicke auf Neue Bezeichnung erstellen. Das benutzerdefinierte Label wird erstellt und dem selbst-gehosteten Runner zugewiesen. Benutzerdefinierte Labels können von selbst-gehosteten Runnern entfernt werden, aber sie können derzeit nicht manuell gelöscht werden. Alle unbenutzten Kennzeichnungen, die keinem Läufer zugewiesen sind, werden innerhalb von 24 Stunden automatisch gelöscht.
Erstellen einer benutzerdefinierten Bezeichnung für einen Organisationsrunner
- Navigiere zur Hauptseite der Organisation, in der deine selbstgehostete Runnergruppe registriert ist.
- Klicke auf -Einstellungen.
- Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
- Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.
- Klicke im Abschnitt „Bezeichnungen“ auf .
- Gib im Feld „Bezeichnung suchen oder erstellen“ den Namen deiner neuen Bezeichnung ein, und klicke auf Neue Bezeichnung erstellen. Das benutzerdefinierte Label wird erstellt und dem selbst-gehosteten Runner zugewiesen. Benutzerdefinierte Labels können von selbst-gehosteten Runnern entfernt werden, aber sie können derzeit nicht manuell gelöscht werden. Alle unbenutzten Kennzeichnungen, die keinem Läufer zugewiesen sind, werden innerhalb von 24 Stunden automatisch gelöscht.
Ein Label einem selbst-gehosteten Runner zuweisen
Du kannst selbstgehosteten Runnern Bezeichnungen auf Repository- und Organisationsebene zuweisen.
- Zuweisen einer Bezeichnung für einen Repository-Runner
- Zuweisen einer Bezeichnung für einen Organisationsrunner
Zuweisen einer Bezeichnung für einen Repository-Runner
- Navigiere zur Hauptseite des Repositorys, in der deine selbstgehostete Runnergruppe registriert ist.
- Klicke auf -Einstellungen.
- Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
- Klicke im Abschnitt „Bezeichnungen“ auf .
- Wenn du deinem selbstgehosteten Runner eine Bezeichnung zuweisen möchtest, klickst du im Feld „Bezeichnung suchen oder erstellen“ auf die Bezeichnung.
Zuweisen einer Bezeichnung für einen Organisationsrunner
- Navigiere zur Hauptseite der Organisation, in der deine selbstgehostete Runnergruppe registriert ist.
- Klicke auf -Einstellungen.
- Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
- Klicke im Abschnitt „Bezeichnungen“ auf .
- Wenn du deinem selbstgehosteten Runner eine Bezeichnung zuweisen möchtest, klickst du im Feld „Bezeichnung suchen oder erstellen“ auf die Bezeichnung.
Ein benutzerdefiniertes Labels von einem selbst-gehosteten Runner entfernen
Du kannst benutzerdefinierte Bezeichnungen für selbstgehostete Runner auf Repository- und Organisationsebene entfernen.
- Entfernen einer benutzerdefinierten Bezeichnung für einen Repository-Runner
- Entfernen einer benutzerdefinierten Bezeichnung für einen Organisationsrunner
Entfernen einer benutzerdefinierten Bezeichnung für einen Repository-Runner
- Navigiere zur Hauptseite des Repositorys, in der deine selbstgehostete Runnergruppe registriert ist.
- Klicke auf -Einstellungen.
- Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
- Klicke im Abschnitt „Bezeichnungen“ auf .
- Im Feld „Bezeichnung suchen oder erstellen“ werden zugewiesene Bezeichnungen mit dem Symbol markiert. Klicke auf eine markierte Bezeichnung, um die Zuweisung zu deinem selbstgehosteten Runner aufzuheben.
Entfernen einer benutzerdefinierten Bezeichnung für einen Organisationsrunner
- Navigiere zur Hauptseite der Organisation, in der deine selbstgehostete Runnergruppe registriert ist.
- Klicke auf -Einstellungen.
- Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
- Klicke im Abschnitt „Bezeichnungen“ auf .
- Im Feld „Bezeichnung suchen oder erstellen“ werden zugewiesene Bezeichnungen mit dem Symbol markiert. Klicke auf eine markierte Bezeichnung, um die Zuweisung zu deinem selbstgehosteten Runner aufzuheben.
Programmgesteuertes Zuweisen von Bezeichnungen
Du kannst einem selbstgehosteten Runner nach seiner Erstellung oder während seiner ersten Konfiguration programmgesteuert Bezeichnungen zuweisen.
-
Um einem vorhandenen selbstgehosteten Runner programmgesteuert Bezeichnungen zuzuweisen, musst du die REST-API verwenden. Weitere Informationen findest du unter REST-API-Endpunkte für selbst gehostete Runner.
-
Um einem selbstgehosteten Runner während der Erstkonfiguration programmgesteuert Bezeichnungen zuzuweisen, kannst du mit dem Parameter
labels
Bezeichnungsnamen an das Skriptconfig
übergeben.Hinweis: Du kannst das Skript
config
nicht verwenden, um einem vorhandenen selbstgehosteten Runner Bezeichnungen zuzuweisen.Mit diesem Befehl wird zum Beispiel eine Bezeichnung namens
gpu
zugewiesen, wenn du einen neuen selbstgehosteten Runner konfigurierst:./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu
Das Label wird erstellt, wenn es noch nicht existiert. Mit diesem Ansatz kannst du den Runnern auch die Standardbezeichnungen wie z. B.
x64
oderlinux
zuweisen. Wenn Standardblabels mit dem Konfigurationsskript zugewiesen werden, akzeptiert GitHub Actions diese als gegeben und überprüft nicht, ob der Runner dieses Betriebssystem oder diese Architektur tatsächlich verwendet.Du kannst mehrere Labels durch Kommas getrennt angeben. Zum Beispiel:
./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux
Hinweis: Wenn Du einen vorhandenen Runner ersetzt, musst Du alle benutzerdefinierten Bezeichnungen neu zuweisen.