Verwalten größerer Runner

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

Organisationsbesitzer*innen 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 findest du unter Gewähren des Zugriffs für Repositorys auf größere Runner.

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.

   

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.

   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 findest du unter Gewähren des Zugriffs für Repositorys auf größerer Runner.

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 Organisationsbesitzer*innen steuern den Zugriff auf Repositoryebene auf alle größerer Runners.

Organisationsbesitzer*innen 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.

• 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 Organisationsbesitzer*innen 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 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 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.

Ändern des Namens eines größerer 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. Gib im Textfeld unter „Name“ einen neuen Namen für den Runner ein.

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

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.

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

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.

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. Klicke auf Speichern.