Verwalten größerer Runner

größerer Runner zu einem Unternehmen hinzufügen

Unternehmensinhaber können einem Unternehmen größerer Runners hinzufügen und sie Organisationen zuweisen. Wenn standardmäßig ein größerer Runner für ein Unternehmen erstellt wird, wird es einer Standard-Runnergruppe 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 Organisationsbesitzer*innen die Runnergruppe konfigurieren, um anzugeben, welche Repositorys Zugriff auf den Unternehmensrunner haben. Weitere Informationen finden Sie unter Repositorys den Zugriff auf größerer Runners erlauben.

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 zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.

2. Klicken Sie oben auf der Seite auf "Richtlinien".

3. Klicke unter „ Policies“ auf Actions.

4. Klicke auf die Registerkarte Runner.

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

6. 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-24.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.

     Wenn Sie ein benutzerdefiniertes Image erstellen, muss die Plattform, die Sie für Ihren Läufer auswählen, mit der Plattform des Images übereinstimmen, das Sie erstellen möchten. Die Plattform des Läufers kann eine der folgenden sein:

     • Linux x64
     • Linux ARM64
     • Windows x64

   • 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: Wähle bei Images, die von einem Partner verwaltet werden, ein Image aus. Beispiel: Basisimages für Windows 11-Desktop sowie GPU-optimierte Images und arm64-Images befinden sich auf dieser Registerkarte.
     • Benutzerdefiniert: Wählen Sie für Bilder, die von Ihrer Organisation oder Ihrem Unternehmen erstellt wurden, unter dieser Registerkarte ein Bild aus. Benutzerdefinierte Bilder werden erstellt, indem ein Workflow auf einem Image-Erstellungs-Runner ausgeführt wird, den Sie, Ihre Organisation oder Ihr Unternehmen eingerichtet haben. Weitere Informationen finden Sie unter Installieren von benutzerdefinierten Images.

   • 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. Sie können insgesamt bis zu zehn größerer Runners mit statischen IP-Adressen verwenden.

   Hinweis

   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 findest du unter Konfigurieren größerer Runner für die Standardeinrichtung.

7. Klicke auf Runner erstellen.

8. 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 finden Sie unter Steuern des Zugriffs auf größere Runner.

Hinzufügen eines Elements größerer Runner zu einer Organisation

Organisationsbesitzer und Benutzer mit der Berechtigung "Organisationsläufer und Läufergruppen verwalten" können einer Organisation einen größerer Runner hinzufügen und steuern, 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 findest du unter Gewähren des Zugriffs auf größere 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. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

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

   

3. Klicke in der linken Randleiste auf Actions und dann auf Runners.

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-24.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.

     Wenn Sie ein benutzerdefiniertes Image erstellen, muss die Plattform, die Sie für Ihren Läufer auswählen, mit der Plattform des Images übereinstimmen, das Sie erstellen möchten. Die Plattform des Läufers kann eine der folgenden sein:

     • Linux x64
     • Linux ARM64
     • Windows x64

   • 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: Wähle bei Images, die von einem Partner verwaltet werden, ein Image aus. Beispiel: Basisimages für Windows 11-Desktop sowie GPU-optimierte Images und arm64-Images befinden sich auf dieser Registerkarte.
     • Benutzerdefiniert: Wählen Sie für Bilder, die von Ihrer Organisation oder Ihrem Unternehmen erstellt wurden, unter dieser Registerkarte ein Bild aus. Benutzerdefinierte Bilder werden erstellt, indem ein Workflow auf einem Image-Erstellungs-Runner ausgeführt wird, den Sie, Ihre Organisation oder Ihr Unternehmen eingerichtet haben. Weitere Informationen finden Sie unter Installieren von benutzerdefinierten Images.

   • 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. Sie können insgesamt bis zu zehn größerer Runners mit statischen IP-Adressen verwenden.

   Hinweis

   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 findest du unter Konfigurieren größerer Runner für die Standardeinrichtung.

6. Klicke auf Runner erstellen.

7. Damit Repositories auf Ihre größerer Runners zugreifen können, fügen Sie sie der Liste der Repositories hinzu, die es verwenden können. Weitere Informationen finden Sie unter Repositorys den Zugriff auf größerer Runners erlauben.

Zulassen des Zugriffs auf größerer RunnerRepositorys

Repositorys erhalten Zugriff auf größerer Runners über Runner-Gruppen. Unternehmensadministratoren können auswählen, welchen Organisationen Zugriff auf Runnergruppen auf Unternehmensebene gewährt wird, und Organisationsbesitzer sowie Benutzer mit der Berechtigung „Organisations-Runner und Runnergruppen verwalten“ steuern den Zugriff auf Repository-Ebene auf alle größerer Runners.

Besitzer einer Organisation können Runnergruppen auf Unternehmensebene für die Repositories in ihrer Organisation verwenden und konfigurieren oder Runnergruppen auf Organisationsebene erstellen, um den Zugriff zu steuern. Benutzer mit den Gruppen "Organisationsläufer und Läufergruppen verwalten" können nur Läufergruppen auf Organisationsebene verwalten. Weitere Informationen finden Sie unter Berechtigungen von benutzerdefinierten Organisationsrollen.

• **Für Läufergruppen 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 Runner-Gruppen 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 Runners hat, können die größerer Runners zu Workflowdateien hinzugefügt werden. Weitere Informationen finden Sie 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 Actions und dann auf Runner groups.
4. Wähle eine Läufergruppe aus einer der Listen auf der Seite aus. Runnergruppen auf Organisationsebene werden oben auf der Seite aufgeführt, und Runnergruppen auf Unternehmensebene werden unter „Vom Unternehmen geteilt“ 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 den Zugriff gewähren möchten.

Wenn Sie verlangen möchten, dass Workflows nur über Runner-Gruppen auf Runner zugreifen, können Sie standardmäßig GitHub-gehostete Runner auf Organisations- oder Unternehmensebene deaktivieren. Siehe Deaktivieren oder Einschränken von GitHub Actions für Ihre Organisation und Erzwingen von Richtlinien für GitHub Actions in Ihrem Unternehmen.

Ändern des Namens eines größerer Runner

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

• Änderung des Namens eines Organisationsläufers
• Änderung des Namens eines Enterprise-Runners

Ändern des Namens eines Organisationsrunners

1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

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

   

3. Klicke in der linken Randleiste auf Actions und dann auf Runners.

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. Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
2. Klicken Sie oben auf der Seite auf "Richtlinien".
3. Klicke unter „ Policies“ auf Actions.
4. Klicke auf die Registerkarte Runner.
5. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
6. Gib im Textfeld unter „Name“ einen neuen Namen für den Runner ein.
7. Klicke auf Speichern.

Die Größe eines größerer Runner ändern

Sie können die Größe Ihrer größerer RunnerDateien bearbeiten.

• Ändern der Größe eines Organisationsrunners
• Ändern der Größe eines Unternehmensrunners

Ändern der Größe eines Organisationsrunners

1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

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

   

3. Klicke in der linken Randleiste auf Actions und dann auf Runners.

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

5. Wähle in der Liste der verfügbaren Optionen unter „Size“ eine neue Größe für den Runner aus. Welche Größen verfügbar sind, hängt von dem auf dem Runner installierten Image ab.

6. Klicken Sie auf Speichern.

Ändern der Größe eines Unternehmensrunners

1. Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
2. Klicken Sie oben auf der Seite auf "Richtlinien".
3. Klicke unter „ Policies“ auf Actions.
4. Klicke auf die Registerkarte Runner.
5. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
6. Wähle in der Liste der verfügbaren Optionen unter „Size“ eine neue Größe für den Runner aus. Welche Größen verfügbar sind, hängt von dem auf dem Runner installierten Image ab.
7. Klicken Sie auf Speichern.

Das Bild eines größerer Runner ändern

Sie können das Bild Ihrer größerer RunnerBilder bearbeiten, wenn Sie ein GitHubeigenes Bild verwenden. Eine Liste unserer verwalteten Bilder finden Sie im GitHub Actions Repository "Runner Images ".

• Ändern des Images eines Organisationsleiters
• Ändern des Images eines Unternehmensrunners

Ändern des Images eines Organisationsrunners

1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

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

   

3. Klicke in der linken Randleiste auf Actions und dann auf Runners.

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

5. Wähle in der Liste der verfügbaren Optionen unter „Image“ ein neues Image für den Runner aus. Die verfügbaren Images sind auf GitHub-eigene Images beschränkt.

6. Klicken Sie auf Speichern.

Ändern des Images eines Unternehmensrunners

1. Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
2. Klicken Sie oben auf der Seite auf "Richtlinien".
3. Klicke unter „ Policies“ auf Actions.
4. Klicke auf die Registerkarte Runner.
5. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
6. Wähle in der Liste der verfügbaren Optionen unter „Image“ ein neues Image für den Runner aus. Die verfügbaren Images sind auf GitHub-eigene Images beschränkt.
7. Klicken Sie auf Speichern.

Automatische Skalierung für größerer Runners konfigurieren

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.

• Automatische Skalierung für einen Runner der Organisation konfigurieren
• Konfigurieren der automatischen Skalierung für einen Unternehmensrunner

Konfigurieren der automatischen Skalierung für einen Organisationsrunner

1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

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

   

3. Klicke in der linken Randleiste auf Actions und dann auf Runners.

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

5. Geben Sie im Abschnitt "Kapazität" unter "Maximale Parallelität" die maximale Anzahl von Aufträgen ein, die gleichzeitig ausgeführt werden sollen.

6. Klicken Sie auf Speichern.

Konfigurieren der automatischen Skalierung für einen Unternehmens-Runner

1. Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
2. Klicken Sie oben auf der Seite auf "Richtlinien".
3. Klicke unter „ Policies“ auf Actions.
4. Klicke auf die Registerkarte Runner.
5. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
6. Geben Sie im Abschnitt "Kapazität" unter "Maximale Parallelität" die maximale Anzahl von Aufträgen ein, die gleichzeitig ausgeführt werden sollen.
7. Klicken Sie auf Speichern.

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

Sie können statische IP-Adressen für größerer Runners aktivieren. In diesem Fall werden den größerer Runners statischen IP-Adressbereichen zugewiesen. Alle IP-Adressen im zugewiesenen Bereich können verwendet werden. Standardmäßig können Sie bis zu 10 verschiedene größerer Runners mit IP-Bereichen für Ihr Konto konfigurieren. 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 Load Balancer, der eine hohe Wiederverwendung 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.

• Erstellung statischer IP-Adressen für Runner in Organisationen
• Erstellen statischer IP-Adressen für Unternehmensrunner

Erstellen statischer IP-Adressen für Organisationsrunner

1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

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

   

3. Klicke in der linken Randleiste auf Actions und dann auf Runners.

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. Klicken Sie auf Speichern.

Erstellen statischer IP-Adressen für Enterprise Runner

1. Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
2. Klicken Sie oben auf der Seite auf "Richtlinien".
3. Klicke unter „ Policies“ auf Actions.
4. Klicke auf die Registerkarte Runner.
5. Wähle in der Liste der Runner den Runner aus, den du bearbeiten möchtest.
6. Um dem Runner statische IP-Adressen zuzuweisen, muss unter „Netzwerk“ Eindeutige und statische öffentliche IP-Adressbereiche für diesen Runner zuweisen aktiviert werden.
7. Klicken Sie auf Speichern.