Skip to main content

Verwenden von Bezeichnungen mit selbstgehosteten Runnern

Mit Labels kannst du deine selbst-gehosteten Runner nach ihren Eigenschaften organisieren.

Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.

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.

Ein selbstgehosteter Runner kann entweder in deinen Repository-, Organisations- oder Unternehmenseinstellungen auf deine GitHub Enterprise Server-Instanz 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.

  • Unternehmen: Du musst ein GitHub Enterprise-Websiteadministrator sein.

Einen benutzerdefinierten Label erstellen

Du kannst benutzerdefinierte Bezeichnungen für Runner auf Repository-, Organisations- und Unternehmensebene erstellen.

Erstellen einer benutzerdefinierten Bezeichnung für einen Repository-Runner

  1. Navigiere zur Hauptseite des Repositorys, in der deine selbstgehostete Runnergruppe registriert ist.
  2. Klicke auf -Einstellungen.
  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
  4. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.
  5. Klicke im Abschnitt „Bezeichnungen“ auf .
  6. 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

  1. Navigiere zur Hauptseite der Organisation, in der deine selbstgehostete Runnergruppe registriert ist.
  2. Klicke auf -Einstellungen.
  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
  4. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.
  5. Klicke im Abschnitt „Bezeichnungen“ auf .
  6. 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 Unternehmensrunner

  1. Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des Dropdownmenüs, das angezeigt wird, wenn Sie auf GitHub Enterprise Server auf das Profilfoto klicken. Die Option „Unternehmenseinstellungen“ ist dunkelorange hervorgehoben.

  2. Wähle auf der Randleiste des Unternehmenskontos die Option Richtlinien aus.

  3. Klicke unter „ Richtlinien“ auf Actions.

  4. Klicke auf die Registerkarte Runner.

  5. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.

  6. Klicke im Abschnitt „Bezeichnungen“ auf .

  7. 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-, Organisations- und Unternehmensebene zuweisen.

Zuweisen einer Bezeichnung für einen Repository-Runner

  1. Navigiere zur Hauptseite des Repositorys, in der deine selbstgehostete Runnergruppe registriert ist.
  2. Klicke auf -Einstellungen.
  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
  4. Klicke im Abschnitt „Bezeichnungen“ auf .
  5. 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

  1. Navigiere zur Hauptseite der Organisation, in der deine selbstgehostete Runnergruppe registriert ist.
  2. Klicke auf -Einstellungen.
  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
  4. Klicke im Abschnitt „Bezeichnungen“ auf .
  5. 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 Unternehmensrunner

  1. Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des Dropdownmenüs, das angezeigt wird, wenn Sie auf GitHub Enterprise Server auf das Profilfoto klicken. Die Option „Unternehmenseinstellungen“ ist dunkelorange hervorgehoben.

  2. Wähle auf der Randleiste des Unternehmenskontos die Option Richtlinien aus.

  3. Klicke unter „ Richtlinien“ auf Actions.

  4. Klicke auf die Registerkarte Runner.

  5. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.

  6. Klicke im Abschnitt „Bezeichnungen“ auf .

  7. 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-, Organisations- und Unternehmensebene entfernen.

Entfernen einer benutzerdefinierten Bezeichnung für einen Repository-Runner

  1. Navigiere zur Hauptseite des Repositorys, in der deine selbstgehostete Runnergruppe registriert ist.
  2. Klicke auf -Einstellungen.
  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
  4. Klicke im Abschnitt „Bezeichnungen“ auf .
  5. 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

  1. Navigiere zur Hauptseite der Organisation, in der deine selbstgehostete Runnergruppe registriert ist.
  2. Klicke auf -Einstellungen.
  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.
  4. Klicke im Abschnitt „Bezeichnungen“ auf .
  5. 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 Unternehmensrunner

  1. Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des Dropdownmenüs, das angezeigt wird, wenn Sie auf GitHub Enterprise Server auf das Profilfoto klicken. Die Option „Unternehmenseinstellungen“ ist dunkelorange hervorgehoben.

  2. Wähle auf der Randleiste des Unternehmenskontos die Option Richtlinien aus.

  3. Klicke unter „ Richtlinien“ auf Actions.

  4. Klicke auf die Registerkarte Runner.

  5. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.

  6. Klicke im Abschnitt „Bezeichnungen“ auf .

  7. 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 im Artikel unter Selbstgehostete Runner zur REST-API.

  • Um einem selbstgehosteten Runner während der Erstkonfiguration programmgesteuert Bezeichnungen zuzuweisen, kannst du mit dem Parameter labels Bezeichnungsnamen an das Skript config ü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 oder linux 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.