Erste Schritte mit selbstgehosteten Runnern für Ihr Unternehmen

Informationen zu selbstgehosteten Runnern für GitHub Actions

GitHub Actions ermöglicht Benutzern in Ihrem Unternehmen eine verbesserte Produktivität durch Automatisieren jeder Phase des Softwareentwicklungsworkflows. Weitere Informationen finden Sie unter Über GitHub Actions für Unternehmen.

Mit GitHub Actions können Entwickler einzelne Tasks schreiben und kombinieren, sogenannte Aktionen, um benutzerdefinierte Workflows zu erstellen. Um GitHub Actions für Ihre GitHub Enterprise Server-Instance zu aktivieren, musst du mindestens einen Computer für die Ausführung von Aufträgen hosten. Dieser Computer wird als selbstgehosteter Runner bezeichnet. Ihr Runnercomputer stellt über die GitHub Actions-Anwendung des selbstgehosteten Runners eine Verbindung mit GitHub her. selbstgehosteten Runner können Linux, Windows oder macOS ausführen. Weitere Informationen finden Sie unter Selbstgehosteten Runnern.

In diesem Leitfaden erfährst du, wie du einen zentralisierten Verwaltungsansatz für selbstgehostete Runner für GitHub Actions in deinem Unternehmen umsetzt. Für diesen Leitfaden wirst du die folgenden Aufgaben ausführen:

1. Konfigurieren einer eingeschränkte Richtlinie, um die Aktionen, die innerhalb deines Unternehmens ausgeführt werden können
2. Bereitstellen eines selbstgehosteten Runners für dein Unternehmen
3. Erstellen einer Gruppe zum Verwalten des Zugriffs auf die für dein Unternehmen verfügbaren Runner
4. Optionales weiteres Einschränken der Repositorys, die den Runner verwenden können
5. Optional: Um selbst gehostete Runner automatisch zu erstellen und zu skalieren, verwenden Sie Actions Runner Controller (ARC). Weitere Informationen finden Sie unter Actions Runner Controller (Steuerung für Aktionsläufer).

Darüber hinaus findest du hier weitere Informationen zum Überwachen und Sichern deiner selbstgehosteten Runner, zum Zugreifen auf Aktionen aus GitHub.com sowie zum Anpassen der Software auf deinen Runnercomputern.

Nachdem du den Leitfaden durchgearbeitet hast, Benutzer von Ihre GitHub Enterprise Server-Instance Workflowaufträge aus GitHub Actions auf einem selbstgehosteten Runnercomputer ausführen.

Voraussetzungen

• GitHub Actions muss für GitHub Enterprise Server aktiviert sein. Ein Websiteadministrator kann GitHub Actions für deine 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 verläuft ü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 findest du unter TLS konfigurieren.

• Dein Unternehmen muss über mindestens eine Organisation verfügen. Weitere Informationen findest du unter Informationen zu Organisationen und Eine neue Organisation von Grund auf erstellen.

1. Konfigurieren von Richtlinien für GitHub Actions

Aktivieren Sie zunächst GitHub Actions für alle Organisationen und konfigurieren Sie eine Richtlinie, um die Aktionen einzuschränken, die auf Ihre GitHub Enterprise Server-Instance ausgeführt werden können. Optional können Organisationsbesitzer*innen diese Richtlinien für jede Organisation weiter einschränken.

1. Klicke in der oberen rechten Ecke von GitHub Enterprise Server auf dein Profilbild und dann auf Enterprise settings.
2. Klicke links auf der Seite auf der Randleiste des Enterprise-Kontos auf Policies.
3. Klicke unter „ Policies“ auf Actions.
4. Wähle unter „Richtlinien“ die Option Für alle Organisationen aktivieren aus.
5. Wähle Ausgewählte Aktionen zulassen und dann Von GitHub erstellte Aktionen zulassen aus, um lokale Aktionen sowie Aktionen zuzulassen, die von GitHub erstellt wurden.
6. Klicken Sie auf Speichern.

Du kannst zusätzliche Richtlinien konfigurieren, um die für Benutzer von Ihre GitHub Enterprise Server-Instance verfügbaren Aktionen einzuschränken. Weitere Informationen finden Sie unter Erzwingen von Richtlinien für GitHub Actions in Ihrem Unternehmen.

2. Bereitstellen des selbstgehosteten Runners für dein Unternehmen

Füge deinem Unternehmen als Nächstes einen selbstgehosteten Runner hinzu. GitHub leitet dich durch die Installation der erforderlichen Software auf dem Runnercomputer. Nachdem du den Runner bereitgestellt hast, kannst du die Konnektivität zwischen dem Runnercomputer und Ihre GitHub Enterprise Server-Instance überprüfen.

Hinzufügen des selbstgehosteten Runners

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

2. Klicke links auf der Seite auf der Randleiste des Enterprise-Kontos auf Policies.

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 Extrahieren der selbst-gehosteten Läuferanwendung.
   • Ausführen des config-Skripts zum Konfigurieren der selbstgehosteten Runneranwendung und die Registrierung 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 selbst-gehosteten Läuferanwendung zum Verbinden der Maschine mit GitHub Actions.

Ü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

3. Verwalten des Zugriffs auf den selbstgehosteten Runner mithilfe einer Gruppe

Du kannst eine Runnergruppe erstellen, um den Zugriff auf den Runner zu verwalten, den du deinem Unternehmen hinzugefügt hast. Mithilfe der Gruppe kannst du auswählen, welche Organisationen Aufträge aus GitHub Actions auf dem Runner ausführen können.

GitHub fügt alle neuen Runner einer Gruppe hinzu. Runner können sich jeweils in nur einer Gruppe befinden. Standardmäßig fügt GitHub alle neuen Runner einer Gruppe „Standard“ hinzu.

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

2. Klicke links auf der Seite auf der Randleiste des Enterprise-Kontos auf Policies.

3. Klicke unter „ Policies“ auf Actions.

4. Klicke auf die Registerkarte Runnergruppen.

5. Klicke auf Neue Runner-Gruppe.

6. Gib unter „Gruppenname" einen Namen für deine Runner-Gruppe ein.

7. Um eine Richtlinie für den Organisationszugriff auszuwählen, musst du unter Organisationszugriff das Dropdownmenü „Organisation“ öffnen und auf Ausgewählte Organisationen klicken.

8. Klicke rechts neben dem Dropdownmenü mit der Organisationszugriffsrichtlinie auf .

9. Wähle die Organisationen aus, denen du Zugriff auf die Runnergruppe gewähren möchtest.

10. Um öffentlichen Repositorys in den ausgewählten Organisationen optional die Verwendung von Runnern in der Gruppe zu erlauben, wähle Öffentliche Repositorys zulassen aus.

    Warnung

    Es wird empfohlen, nur selbstgehostete Runner mit privaten Repositorys zu verwenden. Der Grund hierfür liegt darin, dass Forks deines öffentlichen Repositorys möglicherweise gefährlichen Code auf deinem selbstgehosteten Runnercomputer ausführen können, indem sie einen Pull Request erstellen, der den Code in einem Workflow ausführt.

    Weitere Informationen finden Sie unter Referenz zur sicheren Verwendung.

11. Klicke auf Gruppe erstellen, um die Gruppe zu erstellen und die Richtlinie anzuwenden.

12. Klicke auf die Registerkarte „Runners“.

13. Klicke in der Liste der Runner auf den Runner, den du im vorherigen Abschnitt bereitgestellt hast.

14. Klicken Sie auf Bearbeiten.

15. Klicke auf Runner groups .

16. Klicke in der Liste der Runnergruppen auf den Namen der zuvor erstellten Gruppe.

17. Klicke auf Speichern, um den Runner in die Gruppe zu verschieben.

Du hast jetzt einen selbstgehosteten Runner bereitgestellt, der Aufträge aus GitHub Actions in den von dir angegebenen Organisationen ausführen kann.

4. Einschränken des Zugriffs auf den selbstgehosteten Runner

Optional können Organisationsbesitzerinnen und Benutzerinnen mit der Berechtigung „Organisationsrunner und Runnergruppen verwalten“ die Zugriffsrichtlinie der von Ihnen erstellten Runnergruppe weiter einschränken. Beispielsweise kann eine Organisationsbesitzerin nur bestimmten Repositorys in der Organisation erlauben, die Runnergruppe zu verwenden.

Weitere Informationen finden Sie unter Verwalten des Zugriffs auf selbstgehostete Runner mithilfe von Gruppen.

Weitere Informationen zu benutzerdefinierten Organisationsrollen findest du unter Berechtigungen von benutzerdefinierten Organisationsrollen.

5. Automatisches Skalieren deines selbstgehosteten Runners

Optional können Sie Actions Runner Controller (ARC) verwenden, um selbst gehostete Runner automatisch zu skalieren. Actions Runner Controller (ARC) ist ein Kubernetes-Operator, der selbstgehostete Runner für GitHub Actions orchestriert und skaliert. Weitere Informationen findest du in der Kubernetes-Dokumentation unter Operator-Muster.

Mit ARC kannst du Runner-Skalierungsgruppen erstellen, die basierend auf der Anzahl von Workflows, die in deinem Repository, deiner Organisation oder deinem Unternehmen ausgeführt werden, automatisch skaliert werden. Da kontrollierte Runner kurzlebig sein und auf Containern basieren können, können neue Runnerinstanzen schnell und sauber hoch- oder herunterskaliert werden. Weitere Informationen zur automatischen Skalierung findest du unter Referenzen zu selbstgehosteten Runnern.

Nächste Schritte

• Du kannst selbstgehostete Runner überwachen und häufige Fehler beheben. Weitere Informationen finden Sie unter Überwachen und Beheben von Problemen mit selbstgehosteten Runnern.

• GitHub empfiehlt, die Sicherheitshinweise für selbstgehostete Runnercomputer zu lesen. Weitere Informationen finden Sie unter Referenz zur sicheren Verwendung.

• Sie können manuell Repositories auf GitHub.com synchronisieren, die Aktionen enthalten, die mit Ihrem Unternehmen auf GitHub Enterprise Server synchronisiert werden. Stattdessen kannst du Mitgliedern deines Unternehmens mithilfe von GitHub Connect den automatischen Zugriff auf Aktionen aus GitHub.com erlauben. Weitere Informationen findest du unter folgenden Themen.

  •       [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom) 
    

  •       [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect) 
    

• Du kannst die auf deinen selbstgehosteten Runnercomputern verfügbare Software anpassen oder deine Runner so konfigurieren, dass für Kunden, die GitHub.com verwenden, Software verfügbar ist, die von GitHub gehosteten Runnern ähnelt. Die Software, die den Runnercomputern für GitHub Actions zugrunde liegt, ist Open Source. Weitere Informationen findest du in den Repositorys actions/runner und actions/runner-images.

Weiterführende Lektüre

•         [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service)
  

•         [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow)