Skip to main content

Verwalten größerer Runner

Sie können größerer Runner für Ihre Organisation oder Ihr Unternehmen konfigurieren.

Wer kann dieses Feature verwenden?

Größerer Runner sind nur für Organisationen und Unternehmen verfügbar, die GitHub Team- oder GitHub Enterprise Cloud-Tarife nutzen.

Enterprise or organization owners can manage larger runners. Users with the "Manage organization runners and runner groups" permission can manage larger runners at the organization level.

Note

  • Die Informationen und Anweisungen in diesem Artikel gelten nur für größerer Runners mit Linux- und Windows-Betriebssystemen.

Hinzufügen eines größerer Runners zu einem Unternehmen

Unternehmensbesitzerinnen können einem Unternehmen größerer Runner hinzufügen und sie Organisationen zuweisen. Wenn ein größerer Runner für ein Unternehmen erstellt wird, wird er standardmäßig einer Standardrunnergruppe hinzugefügt, auf die alle Organisationen im Unternehmen Zugriff haben. Während allen Organisationen Zugriff auf den Runner gewährt wird, wird den Repositorys in den einzelnen Organisationen kein Zugriff gewährt. Für jede Organisation müssen Organisationsbesitzerinnen die Runnergruppe konfigurieren, um anzugeben, welche Repositorys Zugriff auf den Unternehmensrunner haben. Weitere Informationen finden Sie unter Gewähren des Zugriffs auf größerer Runner für Repositorys.

Du kannst ein Betriebssystem und eine Hardwarekonfiguration aus der Liste der verfügbaren Optionen auswählen. Wenn neue Instanzen dieses Runners über die automatische Skalierung bereitgestellt werden, verwenden sie dasselbe Betriebssystem und dieselbe Hardwarekonfiguration, die du hier festgelegt hast.

Neue Runner werden automatisch der Standardgruppe zugewiesen. Alternativ kannst du beim Erstellen der Runner auswählen, welcher Gruppe die Runner beitreten sollen. Außerdem kannst du die Gruppenmitgliedschaft der Runner ändern, nachdem du die Runner registriert hast. Weitere Informationen finden Sie unter Steuern des Zugriffs auf größere Runner.

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.

  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.

  3. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Richtlinien

  4. Klicke unter „ Richtlinien“ auf Actions.

  5. Klicke auf die Registerkarte Runner.

  6. Klicke auf New Runner und dann auf New GitHub-hosted runner.

  7. Fülle die erforderlichen Angaben aus, um deinen neuen Runner zu konfigurieren:

    • Name: Gib einen Namen für deinen neuen Runner ein. Zur leichteren Identifizierung sollten hier die Hardware und die Betriebskonfiguration angegeben werden, z. B. ubuntu-20.04-16core.

    • Plattform: Wählen Sie aus den verfügbaren Optionen eine Plattform aus. Nachdem Sie eine Plattform ausgewählt haben, können Sie ein Bild auswählen.

    • Bild: Wählen Sie ein Bild aus den verfügbaren Optionen aus. Sobald Sie ein Bild ausgewählt haben, können Sie eine Größe auswählen.

      • GitHub-Eigentum: Für Bilder, die von GitHub verwaltet werden, wählen Sie unter dieser Registerkarte ein Bild aus.
      • Partner: Für Bilder, die von einem Partner verwaltet werden, wählen Sie unter dieser Registerkarte ein Bild aus. Windows 11-Desktop und GPU-optimierte Bilder befinden sich in dieser Registerkarte.
    • Größe: Wählen Sie in der Dropdownliste der verfügbaren Optionen eine Hardwarekonfiguration aus. Die verfügbaren Größen hängen von dem Bild ab, das Sie in einem vorherigen Schritt ausgewählt haben. Wählen Sie für GPU-Runner unter der Registerkarte GPU-basiert eine Größe aus.

    • Maximale Parallelität: Wählen Sie die maximale Anzahl von Aufträgen aus, die zu einem Zeitpunkt aktiv sein können.

    • Runnergruppe: Wähle die Gruppe aus, der dein Runner angehören soll. Diese Gruppe hostet mehrere Instanzen deines Runners, die je nach Bedarf hoch- und herunterskaliert werden können.

    • Netzwerk: Wählen Sie aus, ob den Instanzen von größerer Runner statische IP-Adressbereiche zugewiesen werden sollen. Es können insgesamt bis zu zehn größerer Runner mit statischen IP-Adressen verwendet werden.

    Note

    Die Namen von größere Runner können ihre Funktionalität diktieren. Wenn Sie z. B. einen größerer Runner für die code scanning-Standardeinrichtung verwenden möchten, muss der Runner mit code-scanning benannt werden. Weitere Informationen zu code scanning mit größere Runner finden Sie unter „Konfigurieren größerer Runner für die Standardeinrichtung“.

  8. Klicke auf Runner erstellen.

  9. Um Organisationen den Zugriff auf die größerer Runner zu ermöglichen, müssen die Organisationen angegeben werden, die die Runnergruppe verwenden können, der der Runner zugewiesen ist. Weitere Informationen findest du unter Steuern des Zugriffs auf größere Runner.

Hinzufügen eines größerer Runners zu einer Organisation

Organisationsbesitzerinnen und Benutzerinnen mit der Berechtigung „Organisationsrunner und Runnergruppen verwalten“ können einen größerer Runner zu einer Organisationskontrolle hinzufügen, welche Repositorys sie verwenden können. Wenn Sie einen neuen Runner für eine Organisation erstellen, haben standardmäßig alle Repositorys in der Organisation Zugriff auf den Runner. Um zu begrenzen, welche Repositorys den Runner verwenden können, weise ihn einer Runnergruppe mit Zugriff auf bestimmte Repositorys zu. Weitere Informationen finden Sie unter „Gewähren des Zugriffs auf eine Gruppe von größeren Runnern für Repositorys“.

Du kannst ein Betriebssystem und eine Hardwarekonfiguration aus der Liste der verfügbaren Optionen auswählen. Wenn neue Instanzen dieses Runners über die automatische Skalierung bereitgestellt werden, verwenden sie dasselbe Betriebssystem und dieselbe Hardwarekonfiguration, die du hier festgelegt hast.

Neue Runner werden automatisch der Standardgruppe zugewiesen. Alternativ kannst du beim Erstellen der Runner auswählen, welcher Gruppe die Runner beitreten sollen. Außerdem kannst du die Gruppenmitgliedschaft der Runner ändern, nachdem du die Runner registriert hast. Weitere Informationen finden Sie unter Steuern des Zugriffs auf größere Runner.

  1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

  2. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

  4. Klicke auf New Runner und dann auf New GitHub-hosted runner.

  5. Fülle die erforderlichen Angaben aus, um deinen neuen Runner zu konfigurieren:

    • Name: Gib einen Namen für deinen neuen Runner ein. Zur leichteren Identifizierung sollten hier die Hardware und die Betriebskonfiguration angegeben werden, z. B. ubuntu-20.04-16core.

    • Plattform: Wählen Sie aus den verfügbaren Optionen eine Plattform aus. Nachdem Sie eine Plattform ausgewählt haben, können Sie ein Bild auswählen.

    • Bild: Wählen Sie ein Bild aus den verfügbaren Optionen aus. Sobald Sie ein Bild ausgewählt haben, können Sie eine Größe auswählen.

      • GitHub-Eigentum: Für Bilder, die von GitHub verwaltet werden, wählen Sie unter dieser Registerkarte ein Bild aus.
      • Partner: Für Bilder, die von einem Partner verwaltet werden, wählen Sie unter dieser Registerkarte ein Bild aus. Windows 11-Desktop und GPU-optimierte Bilder befinden sich in dieser Registerkarte.
    • Größe: Wählen Sie in der Dropdownliste der verfügbaren Optionen eine Hardwarekonfiguration aus. Die verfügbaren Größen hängen von dem Bild ab, das Sie in einem vorherigen Schritt ausgewählt haben. Wählen Sie für GPU-Runner unter der Registerkarte GPU-basiert eine Größe aus.

    • Maximale Parallelität: Wählen Sie die maximale Anzahl von Aufträgen aus, die zu einem Zeitpunkt aktiv sein können.

    • Runnergruppe: Wähle die Gruppe aus, der dein Runner angehören soll. Diese Gruppe hostet mehrere Instanzen deines Runners, die je nach Bedarf hoch- und herunterskaliert werden können.

    • Netzwerk: Wählen Sie aus, ob den Instanzen von größerer Runner statische IP-Adressbereiche zugewiesen werden sollen. Es können insgesamt bis zu zehn größerer Runner mit statischen IP-Adressen verwendet werden.

    Note

    Die Namen von größere Runner können ihre Funktionalität diktieren. Wenn Sie z. B. einen größerer Runner für die code scanning-Standardeinrichtung verwenden möchten, muss der Runner mit code-scanning benannt werden. Weitere Informationen zu code scanning mit größere Runner finden Sie unter „Konfigurieren größerer Runner für die Standardeinrichtung“.

  6. Klicke auf Runner erstellen.

  7. Um einem Repository den Zugriff auf Ihre größerer Runner zu ermöglichen, füge es der Liste der Repositorys hinzu, die die Runner verwenden können. Weitere Informationen finden Sie unter Gewähren des Zugriffs auf größerer Runner für Repositorys.

Gewähren des Zugriffs auf größerer Runner für Repositorys

Repositorys wird über Runnergruppen Zugriff auf größerer Runner gewährt. Enterprisefachkräfte in der IT-Verwaltung können auswählen, welchen Organisationen Zugriff auf Runnergruppen auf Unternehmensebene gewährt wird, und Organisationsbesitzerinnen und Benutzerinnen mit der Berechtigung „Organisationsrunner und Runnergruppen verwalten“ steuern den Zugriff auf Repositoryebene auf alle größerer Runners.

Organisationsbesitzerinnen können Runnergruppen auf Unternehmensebene für die Repositorys in ihrer Organisation verwenden und konfigurieren, oder sie können Runnergruppen auf Organisationsebene erstellen, um den Zugriff zu steuern. Benutzerinnen mit „Organisationsrunner und Runnergruppen verwalten“ können nur Runnergruppen auf Organisationsebene verwalten. Weitere Informationen findest du unter Informationen zu benutzerdefinierten Organisationsrollen.

  • Für Runnergruppen auf Unternehmensebene: Standardmäßig haben Repositorys in einer Organisation keinen Zugriff auf Runnergruppen auf Unternehmensebene. Um Repositorys Zugriff auf Unternehmensrunnergruppen zu gewähren, müssen Organisationseigentümer*innen jede Unternehmensrunnergruppe konfigurieren und auswählen, welche Repositorys Zugriff haben.
  • Für Runnergruppen auf Organisationsebene: Standardmäßig erhalten alle Repositorys in einer Organisation Zugriff auf Runnergruppen auf Organisationsebene. Um einzuschränken, welche Repositorys Zugriff haben, müssen Organisationsbesitzerinnen und Benutzerinnen mit der Berechtigung „Organisationsrunner und Runnergruppen verwalten“ Organisationsrunnergruppen konfigurieren und auswählen, welche Repositorys Zugriff haben.

Sobald ein Repository Zugriff auf größerer Runner hat, können die größerer Runner Workflowdateien hinzugefügt werden. Weitere Informationen findest du unter Ausführen von Aufträgen auf größeren Runnern.

  1. Navigiere zur Hauptseite der Organisation, in der sich deine Runnergruppen befinden.
  2. Klicke auf Settings.
  3. Klicke in der linken Randleiste auf Aktionen, und klicke dann auf Runnergruppen.
  4. Wähle eine Runnergruppe aus einer Liste auf der Seite aus. Runnergruppen auf Organisationsebene werden oben auf der Seite aufgeführt, und Runnergruppen auf Unternehmensebene werden unter „Vom Unternehmen freigegeben“ aufgeführt.
  5. Wähle auf der Runnergruppenseite unter „Repositoryzugriff“ die Option Alle Repositorys oder Ausgewählte Repositorys aus. Wenn Sie Zugriff auf bestimmte Repositorys gewähren möchten, klicken Sie auf , und wählen Sie dann die Repositorys aus der Liste aus, auf die Sie Zugriff gewähren möchten.

Warning

Wenn du einen festen IP-Adressbereich verwendest, empfiehlt es sich, nur größerer Runner mit privaten Repositorys zu verwenden. Forks deines Repositorys können potenziell gefährlichen Code in deinem größerer Runner ausführen, indem sie einen Pull Request erstellen, der den Code in einem Workflow ausführt. Weitere Informationen findest du unter „Steuern des Zugriffs auf größere Runner“.

Ändern des Namens eines größerer Runners

Note

Die Namen von größere Runner können ihre Funktionalität diktieren. Wenn Sie z. B. einen größerer Runner für die code scanning-Standardeinrichtung verwenden möchten, muss der Runner mit code-scanning benannt werden. Weitere Informationen zu code scanning mit größere Runner finden Sie unter „Konfigurieren größerer Runner für die Standardeinrichtung“.

Sie können den Namen Ihrer größerer Runner bearbeiten.

Ändern des Namens eines Organisationsrunners

  1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

  2. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

  4. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.

  5. Gib im Textfeld unter „Name“ einen neuen Namen für den Runner ein.

  6. Klicke auf Speichern.

Ändern des Namens eines Unternehmensrunners

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.
  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.
  3. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Richtlinien
  4. Klicke unter „ Richtlinien“ auf Actions.
  5. Klicke auf die Registerkarte Runner.
  6. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
  7. Gib im Textfeld unter „Name“ einen neuen Namen für den Runner ein.
  8. Klicke auf Speichern.

Konfigurieren der automatischen Skalierung für größerer Runner

Sie können die maximale Anzahl von Aufträgen steuern, die gleichzeitig für bestimmte Runnergruppen ausgeführt werden dürfen. Wenn Sie dieses Feld auf einen höheren Wert festlegen, können Sie verhindern, dass Workflows aufgrund von Parallelität blockiert werden.

Konfigurieren der automatischen Skalierung für einen Organisationsrunner

  1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

  2. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

  4. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.

  5. Gib im Abschnitt „Automatische Skalierung“ unter „Maximale Auftragsparallelität“ die maximale Anzahl der Aufträge ein, die gleichzeitig ausgeführt werden sollen.

  6. Klicke auf Speichern.

Konfigurieren der automatischen Skalierung für einen Unternehmensrunner

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.
  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.
  3. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Richtlinien
  4. Klicke unter „ Richtlinien“ auf Actions.
  5. Klicke auf die Registerkarte Runner.
  6. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
  7. Gib im Abschnitt „Automatische Skalierung“ unter „Maximale Auftragsparallelität“ die maximale Anzahl der Aufträge ein, die gleichzeitig ausgeführt werden sollen.
  8. Klicke auf Speichern.

Erstellen statischer IP-Adressen für größerer Runner

Note

Für die Verwendung statischer IP-Adressen muss deine Organisation GitHub Enterprise Cloud verwenden. Weitere Informationen zum kostenlosen Testen von GitHub Enterprise Cloud findest du unter Eine Testversion von GitHub Enterprise Cloud einrichten.

Sie können statische IP-Adressen für größerer Runner aktivieren. In diesem Fall werden den größerer Runnern statische IP-Adressbereiche zugewiesen. Alle IP-Adressen im zugewiesenen Bereich sind verwendbar und nicht in CIDR-Notation. Standardmäßig können bis zu 10 verschiedene größerer Runner mit IP-Bereichen für Ihr Konto konfiguriert werden. Wenn mehr als zehn größere Runner mit statischen IP-Adressbereichen verwendet werden sollen, wenden Sie sich bitte an uns über das GitHub-Support-Portal.

Die Anzahl der verfügbaren IP-Adressen in den zugewiesenen Bereichen beschränkt nicht die Anzahl gleichzeitiger Aufträge, die für die automatische Skalierung angegeben sind. Innerhalb eines Runnerpools gibt es einen Lastenausgleich, der eine hohe Wiederverwendungsmöglichkeit der IP-Adressen in den zugewiesenen Bereichen ermöglicht. Dadurch wird sichergestellt, dass Ihre Workflows in großer Zahl gleichzeitig ausgeführt werden können, während jedem Computer eine statische IP-Adresse zugewiesen wird.

Erstellen statischer IP-Adressen für Organisationsrunner

  1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

  2. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

  4. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.

  5. Um dem Runner statische IP-Adressen zuzuweisen, muss unter „Netzwerk“ Eindeutige und statische öffentliche IP-Adressbereiche für diesen Runner zuweisen aktiviert werden.

  6. Klicke auf Speichern.

Erstellen statischer IP-Adressen für Unternehmensrunner

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.
  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.
  3. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Richtlinien
  4. Klicke unter „ Richtlinien“ auf Actions.
  5. Klicke auf die Registerkarte Runner.
  6. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
  7. Um dem Runner statische IP-Adressen zuzuweisen, muss unter „Netzwerk“ Eindeutige und statische öffentliche IP-Adressbereiche für diesen Runner zuweisen aktiviert werden.
  8. Klicke auf Speichern.