Erste Schritte mit selbstgehosteten Runnern für Ihr Unternehmen

Sie können eine Runner-Maschine für Ihr Unternehmen konfigurieren, damit Ihre Entwickler mit GitHub Actions mit der Automatisierung von Arbeitsabläufen beginnen können.

Wer kann dieses Feature verwenden?

Enterprise owners and users with permissions can configure policies for GitHub Actions and add self-hosted runners to the enterprise.

In diesem Artikel

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 Actionsdiesem Können Entwickler einzelne Aufgaben schreiben und kombinieren, die als Aktionen bezeichnet werden, um benutzerdefinierte Workflows zu erstellen.

Sie können Ihre eigene Runner-Maschine hosten, um Jobs auszuführen, und diese Maschine wird als selbstgehosteter Runner bezeichnet. Ihr Runnercomputer stellt über die GitHub-Anwendung des selbstgehosteten Runners eine Verbindung mit GitHub Actions her. Alle Runner können unter Linux, Windows oder macOS ausgeführt werden. Weitere Informationen finden Sie unter Selbstgehosteten Runnern.

Alternativ können Sie auch Runner-Computer verwenden, die von GitHub gehostet werden. GitHub-gehostete Runner sind nicht Gegenstand dieses Leitfadens. Weitere Informationen finden Sie unter Von GitHub gehostete Runner.

In diesem Leitfaden erfahren Sie, wie Sie einen zentralen Verwaltungsansatz für selbst gehostete Runner für GitHub Actions in Ihrem Unternehmen umsetzen. Für diesen Leitfaden wirst du die folgenden Aufgaben ausführen:

  1. Konfigurieren einer eingeschränkten Richtlinie zum Einschränken der Aktionen und wiederverwendbaren Workflows , die innerhalb Ihres 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 können Sie Actions Runner Controller (ARC) verwenden, um selbstgehostete Runner automatisch zu erstellen und zu skalieren. Weitere Informationen finden Sie unter Actions Runner Controller (Steuerung für Aktionsläufer).

Außerdem finden Sie weitere Informationen dazu, wie Sie Ihre selbstgehosteten Runner überwachen und absichern, und wie Sie die Software auf Ihren Runner-Computern anpassen.

Nachdem Sie den Leitfaden abgeschlossen haben, können Mitglieder Ihres Unternehmens Workflow-Aufträge von GitHub Actions auf einem selbstgehosteten Runner-Computer ausführen.

Voraussetzungen

1. Konfigurieren Sie Richtlinien für GitHub Actions

Aktivieren Sie zuerst GitHub Actions für alle Organisationen und konfigurieren Sie eine Richtlinie, die die Aktionen und wiederverwendbaren Workflows einschränkt, die innerhalb Ihres Unternehmens ausgeführt werden können. Optional können Organisationsbesitzer*innen diese Richtlinien für jede Organisation weiter einschränken.

  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. Wähle unter „Richtlinien“ die Option Für alle Organisationen aktivieren aus.
  5. Um lokale Aktionen und wiederverwendbare Workflows sowie von erstellte Aktionen zu aktivieren, wählen Sie GitHub und dann GitHub.
  6. Klicken Sie auf Speichern.

Sie können zusätzliche Richtlinien konfigurieren, um die für Enterprise-Mitglieder 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 führt Sie durch die Installation der erforderlichen Software auf der Läufermaschine. Nachdem Sie den Läufer bereitgestellt haben, können Sie die Konnektivität zwischen dem Läufercomputer und Ihrem Unternehmen überprüfen.

Hinzufügen des selbstgehosteten Runners

  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 Neuer Runner und dann auf Neuer selbstgehosteter Runner. 1. Wähle das Betriebssystemimage und die Architektur deines selbstgehosteten Runnercomputers aus.

    Screenshot zur Auswahl des Betriebssystems und der Architektur. Diese Optionen sind dunkelorange umrandet.

  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 „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. Sie verwenden die Gruppe, um festzulegen, welche Organisationen Jobs von GitHub Actions auf dem Runner ausführen können.

GitHub fügt alle neuen Läufer zu einer Gruppe hinzu. Runner können sich jeweils in nur einer Gruppe befinden. Standardmäßig fügt GitHub neue Runner zur Gruppe „Default“ hinzu.

  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 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. Klicken Sie rechts neben der Dropdownliste mit der Zugriffsrichtlinie für die Organisation 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. Klicken Sie auf Runner-Gruppen .

  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.

Sie haben jetzt einen selbstgehosteten Runner eingerichtet, der Aufträge von GitHub Actions innerhalb der von Ihnen angegebenen Organisationen ausführen kann.

4. Einschränken des Zugriffs auf den selbstgehosteten Runner

Optional können Organisationsbesitzer und Benutzer mit der Berechtigung "Organisationsläufer und Läufergruppen verwalten" die Zugriffsrichtlinie der von Ihnen erstellten Läufergruppe 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 finden Sie unter Berechtigungen von benutzerdefinierten Organisationsrollen.

5. Automatisches Skalieren deines selbstgehosteten Runners

Optional können Sie Actions Runner Controller (ARC) verwenden, um selbstgehostete 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

Weiterführende Lektüre