Hinweis
Auf GitHub Enterprise Server gehostete Runner werden aktuell nicht auf GitHub unterstützt.
Informationen GitHub Actions zu GitHub Enterprise Server
In diesem Artikel wird erläutert, wie Website-Administratoren GitHub Enterprise Server für die Verwendung von GitHub Actions konfigurieren können.
GitHub Actions ist standardmäßig für GitHub Enterprise Server nicht aktiviert. Sie müssen ermitteln, ob Ihre Instanz über ausreichende CPU- und Arbeitsspeicherressourcen verfügt, um GitHub Actions die Last zu verarbeiten, ohne leistungseinbußen zu verursachen, und möglicherweise diese Ressourcen zu erhöhen. Du musst auch entscheiden, welchen Speicheranbieter du für den Blobspeicher verwendest, der zum Speichern von Artefakten und Caches benötigt wird, die von Workflowausführungen generiert werden. Anschließend aktivieren Sie GitHub Actions für Ihr Unternehmen, verwalten Zugriffsberechtigungen und fügen selbstgehostete Runner hinzu, um Workflows auszuführen.
Bevor Sie beginnen, sollten Sie einen Plan für die Einführung GitHub Actions in Ihr Unternehmen erstellen. Weitere Informationen finden Sie unter Einführung GitHub Actions in Ihr Unternehmen.
Wenn Sie Ihr Unternehmen von GitHub Actions einem anderen Anbieter migrieren, gibt es zusätzliche Überlegungen. Weitere Informationen finden Sie unter Migrieren Ihres Unternehmens zu GitHub Actions.
Überprüfen der Hardwareanforderungen
Die Ihre GitHub Enterprise Server-Instance zur Verfügung stehenden CPU- und Arbeitsspeicherressourcen bestimmen die Anzahl der Runner, die ohne Leistungseinbußen konfiguriert werden können. GitHub empfiehlt mindestens 8 vCPU und 64 GB Arbeitsspeicher zum Ausführen von GitHub Actions.
Die maximale Anzahl der Runner, die ohne Leistungsverlust verknüpft werden können, hängt von Faktoren wie der Auftragsdauer, der Artefaktnutzung, der Anzahl der Repositorys, für die GitHub Actions ausgeführt wird, sowie davon ab, wie viele andere Vorgänge deine Instanz ausführt, die nicht mit GitHub Actions in Zusammenhang steht. Interne Tests bei GitHub zeigten Leistungsziele für GitHub Enterprise Server in einer Reihe von CPU- und Speicherkonfigurationen.
| vCPUs | Arbeitsspeicher | Maximale verbundene Runner |
|---|---|---|
| 8 | 64 GB | 740 Läufer |
| 32 | 160 GB | 2700 Läufer |
| 96 | 384 GB | 7000 Läufer |
Die GitHub maximale Anzahl verbundener Runner wurde bei Verwendung mehrerer Repositories, einer Jobdauer von ungefähr 10 Minuten und einem Artefakt-Upload von 10 MB gemessen. Je nach den Gesamtaktivitätsniveaus deiner Instanz werden gegebenenfalls verschiedene Leistungen erreicht.
Hinweis
- Ab GitHub Enterprise Server 3.6 dokumentiert GitHub verbundene Runner statt gleichzeitiger Aufträge. Verknüpfte Runner stellen die maximale Anzahl an Runnern dar, die verknüpft werden können und wahrscheinlich verwendet werden. Wenn du mehr Runner verknüpfst als wahrscheinlich verwendet werden, kann die Leistung beeinträchtigt werden.
GitHub Enterprise Server Ab 3.5 verwendet interne Tests CPUs der 3. Generation, GitHubum eine typische Kundenkonfiguration besser widerzuspiegeln. Diese Änderung der CPU stellt einen kleinen Teil der Änderungen an Leistungszielen in dieser Version von GitHub Enterprise Serverdar.
Wenn Sie planen, GitHub Actions für die Benutzer einer vorhandenen Instanz zu aktivieren, überprüfen Sie die Aktivitätsniveaus der Benutzer und Automatisierungen auf der Instanz und stellen Sie sicher, dass Sie für Ihre Benutzer ausreichende CPU- und Arbeitsspeicherressourcen bereitgestellt haben. Weitere Informationen zur Überwachung der Kapazität und Leistung finden Sie GitHub Enterprise Serverunter Überwachen Ihrer Instanz.
Weitere Informationen zu den Mindesthardwareanforderungen für Ihre GitHub Enterprise Server-Instance finden Sie in den Hinweisen zur Hardware der Plattform Ihrer Instanz.
Weitere Informationen zum Anpassen von Ressourcen für eine vorhandene Instanz findest du unter Speicherkapazität erhöhen und CPU- und Arbeitsspeicherressourcen erhöhen.
Optional können Sie den Ressourcenverbrauch auf Ihre GitHub Enterprise Server-Instance einschränken, indem Sie eine Ratenbegrenzung für GitHub Actions konfigurieren. Weitere Informationen finden Sie unter Configuring rate limits (Konfigurieren von Ratenbegrenzungen).
Anforderungen für externen Speicher
Um GitHub Actions auf GitHub Enterprise Server zu aktivieren, benötigen Sie Zugriff auf externen Blobspeicher.
GitHub Actions verwendet externen Blobspeicher, um durch Workflowausführungen generierte Daten zu speichern. Gespeicherte Daten umfassen Workflowprotokolle, Caches und von Benutzer*innen hochgeladene Buildartefakte. Die erforderliche Speichermenge hängt davon ab, wie Sie GitHub Actions verwenden. Es wird nur eine einzige externe Speicherkonfiguration unterstützt, und du kannst nicht mehrere Speicheranbieter gleichzeitig verwenden.
Alle anderen GitHub Actions Daten, z. B. die Workflowdateien in der Dateistruktur eines Repositorys, werden auf dem Datenspeichervolume gespeichert für Ihre GitHub Enterprise Server-Instance.
GitHub Actions unterstützt diese Speicheranbieter:
- Azure Blob-Speicher
- Amazon S3
- Google Cloud Storage
- S3-kompatibler MinIO-Cluster
Hinweis
Dies sind die einzigen Speicheranbieter, die GitHub unterstützt und bei denen GitHub Hilfe leisten kann.
Es gibt andere S3-API-kompatible Speicherprodukte, für die sich GitHub-Partner selbst validiert haben, wenn sie mit GitHub Actions auf GitHub Enterprise Server arbeiten. Weitere Informationen findest du im Repository für GHES-Speicherpartner.
Für Speicherprodukte, die über das GitHub-Technologiepartnerschaftprogramm validiert wurden, ist der Speicheranbieter für den Support und die Dokumentation für die Verwendung des Speicherprodukts mit GitHub Actions verantwortlich.
Überlegungen zum Netzwerken
Wenn GitHub Actions für dein Unternehmen aktiviert ist, werden nur HTTP-Proxys unterstützt. SOCKS5- und HTTPS-Proxys werden nicht unterstützt. Weitere Informationen zur Verwendung eines Proxys mit GitHub Enterprise Server finden Sie in Konfigurieren eines ausgehenden Webproxyservers.
Aktivierung von GitHub Actions bei Ihrem Speicheranbieter
Führen Sie eines der folgenden Verfahren aus, um GitHub Actions mit Ihrem ausgewählten Speicheranbieter zu aktivieren:
- Aktivieren von GitHub Actions mit Azure Blob-Speicher
- Enabling GitHub Actions mit Amazon S3 Storage
- Enabling GitHub Actions mit Google Cloud Storage
- Enabling GitHub Actions mit MinIO-Speicher
Verwalten von Zugriffsberechtigungen für GitHub Actions in Ihrem Unternehmen
Sie können Richtlinien verwenden, um den Zugriff auf GitHub Actions zu verwalten. Weitere Informationen finden Sie unter Erzwingen von Richtlinien für GitHub Actions in Ihrem Unternehmen.
Selbst-gehostete Runner hinzufügen
Hinweis
Auf GitHub Enterprise Server gehostete Runner werden aktuell nicht auf GitHub unterstützt.
Um GitHub Actions-Workflows auszuführen, müssen Sie selbstgehostete Runner hinzufügen. Du kannst selbstgehostete Runner auf Unternehmens-, Organisations- oder Repositoryebene hinzufügen. Weitere Informationen finden Sie unter Selbst-gehostete Runner hinzufügen.
Verwalten, welche Aktionen in Ihrem Unternehmen verwendet werden können
Du kannst steuern, welche Aktionen die Benutzer in deinem Unternehmen verwenden dürfen. Dies umfasst die Einrichtung GitHub Connect für den automatischen Zugriff auf Aktionen von GitHub.comoder das manuelle Synchronisieren von Aktionen von GitHub.com.
Weitere Informationen finden Sie unter Informationen zum Verwenden von Aktionen in deinem Unternehmen.
Allgemeine Sicherheitshärtung für GitHub Actions
Weitere Informationen zu Sicherheitspraktiken GitHub Actionsfinden Sie unter Referenz zur sicheren Verwendung.
Reservierte Namen
Wenn Sie für Ihr Unternehmen aktivieren GitHub Actions , werden zwei Organisationen erstellt: github und actions. Wenn dein Unternehmen bereits den Organisationsnamen github verwendet, wird stattdessen github-org (oder github-github-org, falls github-org auch verwendet wird) verwendet. Wenn dein Unternehmen bereits den Organisationsnamen actions verwendet, wird stattdessen github-actions (oder github-actions-org, falls github-actions auch verwendet wird) verwendet. Sobald Aktionen aktiviert sind, kannst du diese Namen nicht mehr verwenden.