Selbst-gehostete Runner hinzufügen

Voraussetzungen

Bevor du einen selbstgehosteten Runner hinzufügst, solltest du verstehen, was sie sind und wie sie funktionieren. Weitere Informationen findest du unter Selbstgehosteten Runnern.

Darüber hinaus müssen Sie die folgenden Anforderungen erfüllen:

• GitHub Actions muss für GitHub Enterprise Server aktiviert sein. Ein Website-Administrator kann GitHub Actions für Ihre Instanz aktivieren und konfigurieren. Weitere Informationen finden Sie unter Erste Schritte mit GitHub Actions für GitHub Enterprise Server.

• Du musst Zugriff auf den Computer haben, den du als selbst gehosteten Runner in deiner Umgebung verwendest.

• Die Verbindung zwischen selbstgehosteten Runnern und GitHub erfolgt über HTTP (Port 80) oder HTTPS (Port 443). Um die Konnektivität über HTTPS sicherzustellen, konfigurieren Sie TLS für GitHub Enterprise Server. Weitere Informationen finden Sie unter TLS konfigurieren.

Einen selbstgehosteten Runner zu einem Repository hinzufügen

Sie können selbstgehostete Runner einem einzelnen Repository hinzufügen. Um einem Benutzerrepository einen selbstgehosteten Runner hinzuzufügen, musst du der Repositorybesitzer sein. Für ein Organisations-Repository müssen Sie Organisationsbesitzer sein, Administratorzugriff auf das Repository haben oder über die Berechtigung "Organisationsläufer und Läufergruppen verwalten" verfügen.

Weitere Informationen zu benutzerdefinierten Organisationsrollen finden Sie unter Berechtigungen von benutzerdefinierten Organisationsrollen.

Weitere Informationen zum Hinzufügen eines selbstgehosteten Runners mit der REST-API findest du unter REST-API-Endpunkte für selbst gehostete Runner.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen 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 Neuer selbstgehosteter Runner.

5. Wähle das Betriebssystemimage und die Architektur deines selbstgehosteten Runnercomputers aus.

   

6. Du wirst Anweisungen sehen, wie Du die Läuferanwendung herunterlädst und sie auf Deiner selbst-gehosteten Läufermaschine installierst.

   Öffne eine Shell auf Deiner selbst-gehosteten Läufermaschine und führe jeden Shell-Befehl in der angezeigten Reihenfolge aus.

   Hinweis

   Wenn du unter Windows die selbstgehostete Runneranwendung als Dienst installieren möchtest, musst du eine Shell mit Administratorberechtigungen öffnen. Auch wird empfohlen, dass du C:\actions-runner als Verzeichnis für die selbstgehostete Runneranwendung verwendest, damit Windows-Systemkonten auf das Runnerverzeichnis zugreifen können.

   Die Anweisungen führen Dich durch die Vervollständigung dieser Aufgaben:

   • Herunterladen und Entpacken der selbstgehosteten Runner-Anwendung.
   • Ausführen des config Skripts zum Konfigurieren der selbst gehosteten Runner-Anwendung und Registrieren mit GitHub Actions. Das config-Skript benötigt die Ziel-URL und ein automatisch generiertes, zeitlich begrenztes Token, um die Anforderung zu authentifizieren. Das Token läuft nach einer Stunde ab.
     • Unter Windows fragt das config-Skript auch, ob du die selbstgehostete Runneranwendung als Dienst installieren möchtest. Für Linux und macOS kannst Du einen Dienst installieren, nachdem Du das Hinzufügen des Läufers beendet hast. Weitere Informationen finden Sie unter Selbstgehostete Runner-Anwendung als Dienst konfigurieren.
   • Ausführen der Anwendung des selbstgehosteten Runners, um den Computer mit GitHub Actions zu verbinden.

Überprüfung dass dein selbst-gehosteter Läufer erfolgreich hinzugefügt wurde

Nach Abschluss der Schritte zum Hinzufügen eines selbst gehosteten Runners werden der Runner und sein Status jetzt unter „Selbst-gehostete Runner“ aufgeführt.

Die selbst-gehostete Läuferanwendung muss aktiv sein, damit der Läufer Aufträge annehmen kann. Wenn die Runner-Anwendung mit GitHub verbunden und bereit ist, Aufträge zu empfangen, siehst du die folgende Meldung auf dem Terminal des Computers.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

Weitere Informationen finden Sie unter Überwachen und Beheben von Problemen mit selbstgehosteten Runnern.

Einen selbst-gehosteten Runner zu einer Organisation hinzufügen

Sie können selbst-gehostete Runner auf Organisationsebene hinzufügen, wo sie verwendet werden können, um Jobs für mehrere Repositories in einer Organisation zu verarbeiten. Um einer Organisation einen selbst gehosteten Läufer hinzuzufügen, müssen Sie ein Organisationsbesitzer sein oder über die Berechtigung "Organisationsläufer und Läufergruppen verwalten" verfügen. Weitere Informationen zum Hinzufügen eines selbstgehosteten Runners mit der REST-API findest du unter REST-API-Endpunkte für selbst gehostete Runner.

Weitere Informationen zu benutzerdefinierten Organisationsrollen finden Sie unter Berechtigungen von benutzerdefinierten Organisationsrollen.

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. Klicken Sie auf "Neuer Läufer".

5. Wähle das Betriebssystemimage und die Architektur deines selbstgehosteten Runnercomputers aus.

   

6. Du wirst Anweisungen sehen, wie Du die Läuferanwendung herunterlädst und sie auf Deiner selbst-gehosteten Läufermaschine installierst.

   Öffne eine Shell auf Deiner selbst-gehosteten Läufermaschine und führe jeden Shell-Befehl in der angezeigten Reihenfolge aus.

   Hinweis

   Wenn du unter Windows die selbstgehostete Runneranwendung als Dienst installieren möchtest, musst du eine Shell mit Administratorberechtigungen öffnen. Auch wird empfohlen, dass du C:\actions-runner als Verzeichnis für die selbstgehostete Runneranwendung verwendest, damit Windows-Systemkonten auf das Runnerverzeichnis zugreifen können.

   Die Anweisungen führen Dich durch die Vervollständigung dieser Aufgaben:

   • Herunterladen und Entpacken der selbstgehosteten Runner-Anwendung.
   • Ausführen des config Skripts zum Konfigurieren der selbst gehosteten Runner-Anwendung und Registrieren mit GitHub Actions. Das config-Skript benötigt die Ziel-URL und ein automatisch generiertes, zeitlich begrenztes Token, um die Anforderung zu authentifizieren. Das Token läuft nach einer Stunde ab.
     • Unter Windows fragt das config-Skript auch, ob du die selbstgehostete Runneranwendung als Dienst installieren möchtest. Für Linux und macOS kannst Du einen Dienst installieren, nachdem Du das Hinzufügen des Läufers beendet hast. Weitere Informationen finden Sie unter Selbstgehostete Runner-Anwendung als Dienst konfigurieren.
   • Ausführen der Anwendung des selbstgehosteten Runners, um den Computer mit GitHub Actions zu verbinden.

Überprüfung dass dein selbst-gehosteter Läufer erfolgreich hinzugefügt wurde

Nach Abschluss der Schritte zum Hinzufügen eines selbst gehosteten Runners werden der Runner und sein Status jetzt unter „Selbst-gehostete Runner“ aufgeführt.

Die selbst-gehostete Läuferanwendung muss aktiv sein, damit der Läufer Aufträge annehmen kann. Wenn die Runner-Anwendung mit GitHub verbunden und bereit ist, Aufträge zu empfangen, siehst du die folgende Meldung auf dem Terminal des Computers.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

Weitere Informationen finden Sie unter Überwachen und Beheben von Problemen mit selbstgehosteten Runnern.

Hinzufügen eines selbstgehosteten Runners zu einem Unternehmen

Sie einem Unternehmen selbstgehostete Runner hinzufügen, wo sie mehreren Organisationen zugewiesen werden können. Organisationsbesitzer können steuern, welche Repositorys es verwenden dürfen.

Neue Läufer werden der Standardgruppe zugewiesen. Sie können die Gruppe des Runners ändern, nachdem du den Läufer registriert hast. Weitere Informationen finden Sie unter Verwalten des Zugriffs auf selbstgehostete Runner mithilfe von Gruppen.

Um einem Unternehmen einen selbstgehosteten Runner hinzufügen zu können, musst du ein Unternehmensbesitzer sein. Informationen zum Hinzufügen eines selbst gehosteten Läufers mit der REST-API finden Sie in den Unternehmensendpunkten in der GitHub Actions REST-API.

1. Klicke in der oberen rechten Ecke von GitHub Enterprise Server auf dein Profilbild und dann auf Enterprise settings.

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

3. Klicke unter „ Policies“ auf Actions.

4. Klicke auf die Registerkarte Runner.

5. Klicke auf Neuer Runner. 1. Wähle das Betriebssystemimage und die Architektur deines selbstgehosteten Runnercomputers aus.

   

6. Du wirst Anweisungen sehen, wie Du die Läuferanwendung herunterlädst und sie auf Deiner selbst-gehosteten Läufermaschine installierst.

   Öffne eine Shell auf Deiner selbst-gehosteten Läufermaschine und führe jeden Shell-Befehl in der angezeigten Reihenfolge aus.

   Hinweis

   Wenn du unter Windows die selbstgehostete Runneranwendung als Dienst installieren möchtest, musst du eine Shell mit Administratorberechtigungen öffnen. Auch wird empfohlen, dass du C:\actions-runner als Verzeichnis für die selbstgehostete Runneranwendung verwendest, damit Windows-Systemkonten auf das Runnerverzeichnis zugreifen können.

   Die Anweisungen führen Dich durch die Vervollständigung dieser Aufgaben:

   • Herunterladen und Entpacken der selbstgehosteten Runner-Anwendung.
   • Ausführen des config Skripts zum Konfigurieren der selbst gehosteten Runner-Anwendung und Registrieren mit GitHub Actions. Das config-Skript benötigt die Ziel-URL und ein automatisch generiertes, zeitlich begrenztes Token, um die Anforderung zu authentifizieren. Das Token läuft nach einer Stunde ab.
     • Unter Windows fragt das config-Skript auch, ob du die selbstgehostete Runneranwendung als Dienst installieren möchtest. Für Linux und macOS kannst Du einen Dienst installieren, nachdem Du das Hinzufügen des Läufers beendet hast. Weitere Informationen finden Sie unter Selbstgehostete Runner-Anwendung als Dienst konfigurieren.
   • Ausführen der Anwendung des selbstgehosteten Runners, um den Computer mit GitHub Actions zu verbinden.

Überprüfung dass dein selbst-gehosteter Läufer erfolgreich hinzugefügt wurde

Nach Abschluss der Schritte zum Hinzufügen eines selbst gehosteten Runners werden der Runner und sein Status jetzt unter „Selbst-gehostete Runner“ aufgeführt.

Die selbst-gehostete Läuferanwendung muss aktiv sein, damit der Läufer Aufträge annehmen kann. Wenn die Runner-Anwendung mit GitHub verbunden und bereit ist, Aufträge zu empfangen, siehst du die folgende Meldung auf dem Terminal des Computers.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

Weitere Informationen finden Sie unter Überwachen und Beheben von Problemen mit selbstgehosteten Runnern.

Verfügbarmachen von Unternehmensrunnern für Repositorys

Standardmäßig sind Runner in der selbstgehosteten Runnergruppe „Default“ eines Unternehmens für alle Organisationen im Unternehmen verfügbar, dies gilt aber nicht für alle Repositorys in jeder Organisation.

Um eine selbstgehostete Runnergruppe auf Unternehmensebene für ein Organisationsrepository verfügbar zu machen, musst du möglicherweise die geerbten Einstellungen der Organisation für die Runnergruppe ändern, um den Runner für Repositorys in der Organisation verfügbar zu machen.

Weitere Informationen zum Ändern der Zugriffseinstellungen für Runnergruppen findest du unter Verwalten des Zugriffs auf selbstgehostete Runner mithilfe von Gruppen.

Nächste Schritte

Sie können eine Automatisierung einrichten, um die Anzahl der selbstgehosteten Runner zu skalieren. Weitere Informationen finden Sie unter Referenzen zu selbstgehosteten Runnern.