Skip to main content

Selbst-gehostete Runner hinzufügen

Sie können einem Repository, einer Organisation oder einem Unternehmen einen selbstgehosteten Runner hinzufügen.

Sie können einem Repository, einer Organisation oder einem Unternehmen einen selbstgehosteten Runner hinzufügen.

Wenn du ein Organisations- oder Unternehmensadministrator bist, möchtest du möglicherweise deine selbstgehosteten Runner auf Organisations- oder Unternehmensebene hinzufügen. Mit diesem Ansatz machst du den Runner für mehrere Repositorys in deiner Organisation oder deinem Unternehmen verfügbar und kannst deine Runner an einem zentralen Ort verwalten.

Informationen zu unterstützten Betriebssystemen für selbstgehostete Runner oder zur Verwendung von selbstgehosteten Runnern mit einem Proxyserver finden Sie unter Informationen zu selbstgehosteten Runnern.

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 Informationen zu selbstgehosteten Runnern.

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

Sie können kurzlebige Runner, die vor der Bereinigung der Registrierung einen einzelnen Auftrag ausführen, mithilfe der Registrierung von Just-In-Time-Runnern registrieren. Weitere Informationen finden Sie unter Sicherheitshärtung für GitHub Actions.

Voraussetzungen

Einen selbst-gehosteten Runner zu einem Repository hinzufügen

Sie können selbst-gehostete Runner zu einem einzigen Repository hinzufügen. Um einem Benutzerrepository einen selbstgehosteten Runner hinzuzufügen, musst du der Repositorybesitzer sein. Für ein Organisationsrepository musst du der Besitzer der Organisation sein oder über Administratorzugriff auf das Repository verfügen. Weitere Informationen zum Hinzufügen eines selbstgehosteten Runners mit der REST-API finden Sie unter Aktionen.

Hinweis: Unternehmens- und Organisationsbesitzer*innen können die Erstellung selbstgehosteter Runner auf Repositoryebene deaktivieren. Weitere Informationen findest du unter Erzwingen von Richtlinien für GitHub Actions in deinem Unternehmen und unter GitHub Actions für deine Organisation Deaktivieren oder Einschränken.

  1. Navigiere auf GitHub.com zur Hauptseite des Repositorys.

  2. Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

  4. Klicke auf Neuer selbstgehosteter Runner.

  5. 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 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.
      • 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 findest du unter Die Anwendung für selbst-gehostete Runner 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 „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 Enterprise Cloud 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 Behandeln 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 einen selbst-gehosteten Runner zu einer Organisation hinzuzufügen, musst du Organisationsinhaber sein. Weitere Informationen zum Hinzufügen eines selbstgehosteten Runners mit der REST-API finden Sie unter Aktionen.

  1. Navigiere auf GitHub.com 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.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

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

  5. 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.
      • 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 findest du unter Die Anwendung für selbst-gehostete Runner 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 „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 Enterprise Cloud 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 Behandeln von Problemen mit selbstgehosteten Runnern.

Hinweis: Aus Sicherheitsgründen können öffentliche Repositorys standardmäßig keine Runner in einer Runnergruppe verwenden, aber du kannst dies in den Einstellungen der Runnergruppe außer Kraft setzen. Weitere Informationen findest du unter Verwalten des Zugriffs auf selbstgehostete Runner mithilfe von Gruppen.

Hinzufügen eines selbstgehosteten Runners zu einem Unternehmen

Sie können einem Unternehmen selbstgehostete Runner hinzufügen. Von dort können sie dann mehreren Organisationen zugewiesen werden. Anschließend können die Organisationsbesitzer steuern, von welchen Repositorys die Runner verwenden werden können.

Neue Runner 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. Weitere Informationen zum Hinzufügen eines selbstgehosteten Runners mit der REST-API finden Sie unter den Unternehmensendpunkten in der GitHub Actions-REST-API.

  1. Klicke in der oberen rechten Ecke von GitHub.com auf dein Profilfoto und dann auf Deine Unternehmen.

  2. Klicke in der Liste der Unternehmen auf das Unternehmen, das du anzeigen möchtest.

  3. Wähle auf der Randleiste des Unternehmenskontos die Option Richtlinien aus.

  4. Klicke unter „ Richtlinien“ auf Actions.

  5. Klicke auf die Registerkarte Runner.

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

  7. 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.
      • 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 findest du unter Die Anwendung für selbst-gehostete Runner 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 „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 Enterprise Cloud 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 Behandeln von Problemen mit selbstgehosteten Runnern.

Hinweis: Aus Sicherheitsgründen können öffentliche Repositorys standardmäßig keine Runner in einer Runnergruppe verwenden, aber du kannst dies in den Einstellungen der Runnergruppe außer Kraft setzen. Weitere Informationen findest du unter Verwalten des Zugriffs auf selbstgehostete Runner mithilfe von Gruppen.

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 finden Sie unter Verwalten des Zugriffs auf selbstgehostete Runner mithilfe von Gruppen.

Weiterführende Themen