Managing larger runners

Adding a größerer Runner to an enterprise

Enterprise owners can add größerer Runners to an enterprise and assign them to organizations. By default, when a größerer Runner is created for an enterprise, it is added to a default runner group that all organizations in the enterprise have access to. While all organizations are granted access to the runner, the repositories in each organization are not granted access. For each organization, an organization owner must configure the runner group to specify which repositories have access to the enterprise runner. For more information, see Allowing repositories to access größerer Runners.

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 Controlling access to larger runners.

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. Klicke oben auf der Seite auf Policies.

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

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

   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.

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 finden Sie unter Controlling access to larger runners.

Adding a größerer Runner to an organization

Organization owners and users with the "Manage organization runners and runner groups" permission can add a größerer Runner to an organization control which repositories can use it. When you create a new runner for an organization, by default, all repositories in the organization have access to the runner. To limit which repositories can use the runner, assign it to a runner group with access to specific repositories. For more information, see Allowing repositories to access larger runners.

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 Controlling access to larger runners.

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.

   

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

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

   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. To allow repositories to access your größerer Runners, add them to the list of repositories that can use it. For more information, see Allowing repositories to access größerer Runners.

Allowing repositories to access größerer Runners

Repositories are granted access to größerer Runners through runner groups. Enterprise administrators can choose which organizations are granted access to enterprise-level runner groups, and organization owners and users with the "Manage organization runners and runner groups" permission control repository-level access to all größerer Runners.

Organization owners can use and configure enterprise-level runner groups for the repositories in their organization, or they can create organization-level runner groups to control access. Users with the "Manage organization runners and runner groups" can only manage organization-level runner groups. For more information, see Informationen zu benutzerdefinierten Organisationsrollen.

• For enterprise-level runner groups: 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.
• For organization-level runner groups: 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.

Once a repository has access to größerer Runners, the größerer Runners can be added to workflow files. For more information, see Running jobs on larger runners.

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. Select a runner group from either list on the page. Organization-level runner groups are listed at the top of the page, and enterprise-level runner groups are listed under "Shared by the Enterprise."
5. On the runner group page, under "Repository access," select All repositories or Selected repositories. If you choose to grant access to specific repositories, click , then select the repositories you would like to grant access to from the list.

Changing the name of a größerer Runner

You can edit the name of your größerer Runners.

• Changing the name of an organization runner
• Changing the name of an enterprise runner

Changing the name of an organization 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.

   

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.

Changing the name of an enterprise 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. Klicke oben auf der Seite auf Policies.
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.

Changing the size of a größerer Runner

You can edit the size of your größerer Runners.

• Changing the size of an organization runner
• Changing the size of an enterprise runner

Changing the size of an organization 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.

   

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

Changing the size of an enterprise 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. Klicke oben auf der Seite auf Policies.
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. 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.
8. Klicken Sie auf Speichern.

Changing the image of a größerer Runner

You can edit the image of your größerer Runners if you are using a GitHub-owned image. For a list of our managed images see the GitHub Actions Runner Images repository.

• Changing the image of an organization runner
• Changing the image of an enterprise runner

Changing the image of an organization 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.

   

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

Changing the image of an enterprise 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. Klicke oben auf der Seite auf Policies.
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. 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.
8. Klicken Sie auf Speichern.

Configuring autoscaling for größerer Runners

You can control the maximum number of jobs allowed to run concurrently for specific runner sets. Setting this field to a higher value can help prevent workflows being blocked due to parallelism.

• Configuring autoscaling for an organization runner
• Configuring autoscaling for an enterprise runner

Configuring autoscaling for an organization 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.

   

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.

Configuring autoscaling for an enterprise 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. Klicke oben auf der Seite auf Policies.
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.

Creating static IP addresses for größerer Runners

You can enable static IP addresses for größerer Runners. When you do this, the größerer Runners are assigned static IP address ranges. All IP addresses in the range assigned are usable and not in CIDR notation. By default, you can configure up to 10 different größerer Runners with IP ranges for your account. 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.

The number of available IP addresses in the assigned ranges does not restrict number of concurrent jobs specified for autoscaling. Within a runner pool, there is a load balancer which allows for high reuse of the IP addresses in the assigned ranges. This ensures your workflows can run concurrently at scale while each machine is assigned a static IP address.

• Creating static IP addresses for organization runners
• Creating static IP addresses for enterprise runners

Creating static IP addresses for organization runners

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.

   

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

Creating static IP addresses for enterprise runners

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. Klicke oben auf der Seite auf Policies.
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. Klicken Sie auf Speichern.