Aktivieren des automatischen Zugriffs auf GitHub.com Aktionen mithilfe von GitHub Connect

Damit GitHub Actions in Ihrem Unternehmen Aktionen aus GitHub.com verwenden kann, können Sie Ihre Unternehmensinstanz mit GitHub Enterprise Cloud verbinden.

Wer kann dieses Feature verwenden?

Enterprise owners can enable access to public GitHub.com actions.

In diesem Artikel

Hinweis

Auf GitHub Enterprise Server gehostete Runner werden aktuell nicht auf GitHub unterstützt.

Informationen zu automatischem Zugriff auf GitHub.com Aktionen

Standardmäßig können GitHub Actions Workflows auf GitHub Enterprise Server nicht direkt Aktionen von GitHub.com oder GitHub Marketplace verwenden. Um öffentliche Aktionen aus GitHub.com in Ihrer Unternehmensinstanz verfügbar zu machen, können Sie GitHub Connect verwenden, um GitHub Enterprise Server in GitHub Enterprise Cloud zu integrieren.

Um Aktionen von GitHub.com, , sowohl GitHub Enterprise Server als auch zu verwenden, müssen Ihre selbstgehosteten Runner ausgehende Verbindungen mit GitHub.com herstellen können. Es sind keine eingehenden Verbindungen von GitHub.com erforderlich. Weitere Informationen finden Sie unter Referenzen zu selbstgehosteten Runnern.

Wenn du über eine strenge Kontrolle darüber verfügen möchtest, welche öffentlichen Aktionen in deinem Unternehmen zulässig sind, kannst du alternativ dazu mit dem actions-sync-Tool Aktionen manuell in deine Unternehmensinstanz herunterladen und synchronisieren. Weitere Informationen finden Sie unter Manuelles Synchronisieren von Aktionen aus GitHub.com.

Informationen zur Auflösung von Aktionen mithilfe von GitHub Connect

Wenn ein Workflow eine Aktion verwendet, indem auf das Repository verwiesen wird, in dem die Aktion gespeichert ist, versucht GitHub Actions zuerst, das Repository auf Ihre GitHub Enterprise Server-Instance zu finden. Wenn das Repository auf Ihre GitHub Enterprise Server-Instance nicht vorhanden ist und du den automatischen Zugriff auf GitHub.com aktiviert hast, versucht GitHub Actions das Repository auf GitHub.com zu finden.

Wenn ein Benutzer bereits eine Organisation und ein Repository in Ihrem Unternehmen erstellt hat, das mit einem Organisations- und Repositorynamen GitHub.comübereinstimmt, wird das Repository in Ihrem Unternehmen anstelle des GitHub.com Repositorys verwendet. Weitere Informationen finden Sie unter Automatische Außerbetriebnahme von Namespaces für Aktionen, auf die über GitHub.com zugegriffen wird.

Aktivieren des automatischen Zugriffs auf öffentliche GitHub.com Aktionen

Bevor Sie den Zugriff auf öffentliche Aktionen über GitHub.com für Ihr Unternehmen aktivieren, müssen Sie:

  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 GitHub Connect.
  3. Verwenden Sie unter "Benutzer können Aktionen aus GitHub.com in Workflowausführungen verwenden", das Dropdownmenü, und wählen Sie Enabled aus.
  4. Nachdem Sie GitHub Connect aktiviert haben, können Sie Richtlinien verwenden, um einzuschränken, welche öffentlichen Aktionen in Repositorien in Ihrem Unternehmen verwendet werden können. Weitere Informationen finden Sie unter Erzwingen von Richtlinien für GitHub Actions in Ihrem Unternehmen.

Automatische Außerbetriebnahme von Namespaces von Aktionen, auf die über GitHub.com zugegriffen wird

Wenn Sie GitHub Connect aktivieren, bemerken Benutzer bei vorhandenen Workflows keine Verhaltensänderung, da GitHub Actions für jede Aktion zunächst Ihre GitHub Enterprise Server-Instance durchsucht, bevor auf GitHub.com zurückgegriffen wird. Dadurch wird sichergestellt, dass alle benutzerdefinierten Versionen von Aktionen, die Ihr Unternehmen erstellt hat, gegenüber ihren Gegenstücken auf GitHub.com bevorzugt verwendet werden.

Wenn eine Aktion auf GitHub.com zum ersten Mal verwendet wird, wird der damit verbundene Namespace in deinem Unternehmen deaktiviert, damit in Workflows die gewünschten Aktionen verwendet werden und Missbrauch vorgebeugt wird. So wird verhindert, dass Benutzer in deinem Unternehmen eine Organisation und ein Repository erstellen, die bzw. das mit dem Namespace der Aktion auf GitHub.com übereinstimmen.

Nachdem Sie eine Aktion aus GitHub.com verwendet haben, müssen Sie, wenn Sie in Ihre GitHub Enterprise Server-Instance eine Aktion mit demselben Namen erstellen möchten, zunächst den Namespace für diese Organisation und dieses Repository verfügbar machen.

  1. Klicke in einem Verwaltungskonto für GitHub Enterprise Server in der rechten oberen Ecke einer beliebigen Seite auf .

  2. Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.

  3. Klicke in der linken Randleiste unter Site admin (Websiteadministrator) auf Retired Namespaces (Deaktivierte Namespaces).

  4. Rechts neben dem Namespace, den Sie in Ihre GitHub Enterprise Server-Instance verwenden möchten, klicken Sie auf Unretire.

  5. Wechsle zur relevanten Organisation und erstelle ein neues Repository.

    Tipp

    Wenn du die Deaktivierung eines Namespace aufhebst, erstellst du das neue Repository mit diesem Namen immer so schnell wie möglich. Wenn ein Workflow die zugehörige Aktion für GitHub.com aufruft, bevor Sie das lokale Repository erstellen, wird der Namespace erneut stillgelegt. Bei Aktionen, die in häufig ausgeführten Workflows verwendet werden, kann es passieren, dass ein Namespace wieder deaktiviert wird, noch bevor du Zeit zum Erstellen des lokalen Repositorys hast. In diesem Fall kannst du die relevanten Workflows vorübergehend deaktivieren, bis du das neue Repository erstellt hast.