Skip to main content

Erste Schritte mit Actions für Enterprise Server

Hier erfährst du mehr über das erstmalige Aktivieren und Konfigurieren von Actions für Enterprise Server.

Wer kann dieses Feature verwenden?

Site administrators can enable Actions and configure enterprise settings.

Hinweis

Auf gehostete Runner werden aktuell nicht auf Enterprise Server unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der public roadmap.

Informationen zu Actions für Enterprise Server

In diesem Artikel wird erläutert, wie Websiteadministratoren Enterprise Server für die Verwendung von Actions konfigurieren.

Actions ist standardmäßig für Enterprise Server nicht aktiviert. Du musst ermitteln, ob deine Instanz über ausreichende CPU-Ressourcen und Arbeitsspeicherressourcen verfügt, damit die Last von Actions verarbeitet werden kann, ohne dass Leistungsverluste verursacht werden. Gegebenenfalls müssen diese Ressourcen erhöht werden. 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 aktivierst du Actions für dein Unternehmen, du verwaltest Zugriffsberechtigungen und fügst selbstgehostete Runner zum Ausführen von Workflows hinzu.

Bevor Du beginnst, solltest Du einen Plan für die Einführung von Actions in Dein Unternehmen erstellen. Weitere Informationen finden Sie unter Einführen von Actions in deinem Unternehmen.

Wenn du dein Unternehmen von einem anderen Anbieter zu Actions migrierst, gibt es zusätzliche Überlegungen. Weitere Informationen finden Sie unter Migrieren deines Unternehmens zu Actions.

Überprüfen der Hardwareanforderungen

Die CPU- und Arbeitsspeicherressourcen, die für Ihre Enterprise Server-Instance verfügbar sind, bestimmen die Anzahl der Runner, die gleichzeitig ohne Leistungsverlust konfiguriert werden können. empfiehlt mindestens 8 vCPU und 64 GB Arbeitsspeicher zum Ausführen von 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 Actions ausgeführt wird, sowie davon ab, wie viele andere Vorgänge deine Instanz ausführt, die nicht mit Actions in Zusammenhang steht. Interne Tests bei ergaben Leistungsziele für Enterprise Server in verschiedenen CPU- und Arbeitsspeicherkonfigurationen.

vCPUsArbeitsspeicherMaximale verbundene Runner
864 GB740 Runner
32160 GB2700 Runner
96384 GB7000 Runner

Die maximale Anzahl verknüpfter Runner wurde von mithilfe mehrerer Repositorys, einer Auftragsdauer von ca. zehn Minuten und Uploads von 10 MB großen Artefakten gemessen. Je nach den Gesamtaktivitätsniveaus deiner Instanz werden gegebenenfalls verschiedene Leistungen erreicht.

Hinweis

  • Ab Enterprise Server 3.6 dokumentiert verknüpfte Runner im Gegensatz zu parallelen Aufträgen. 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.
  • Ab Enterprise Server 3.5 werden bei internen Tests von CPUs der dritten Generation verwendet, um eine typische Kundenkonfiguration besser widerzuspiegeln. Diese CPU-bezogene Änderung stellt einen kleinen Teil der Änderungen an den Leistungszielen in dieser Version von Enterprise Server dar.

Wenn du Actions für die Benutzer einer vorhandenen Instanz aktivieren möchtest, überprüfe die Aktivitätsniveaus für Benutzer und Automatisierungen in der Instanz, und vergewissere dich, dass du angemessene CPU- und Arbeitsspeicherressourcen für die Benutzer bereitgestellt hast. Weitere Informationen zum Überwachen der Kapazität und Leistung von Enterprise Server findest du unter Überwachen Ihrer Instanz.

Weitere Informationen zu den Mindesthardwareanforderungen für Ihre Enterprise Server-Instance findest du in den Hardwareüberlegungen für die Plattform deiner 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 kannst du den Ressourcenverbrauch für Ihre Enterprise Server-Instance einschränken, indem du eine Ratenbegrenzung für Actions konfigurierst. Weitere Informationen finden Sie unter Configuring rate limits (Konfigurieren von Ratenbegrenzungen).

Anforderungen für externen Speicher

Zum Aktivieren von Actions für Enterprise Server benötigst du Zugriff auf externen Blobspeicher.

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 Speichergröße hängt von der Verwendung von Actions ab. Es wird nur eine einzige externe Speicherkonfiguration unterstützt, und du kannst nicht mehrere Speicheranbieter gleichzeitig verwenden.

Alle anderen Actions-Daten, z. B. die Workflowdateien in der Dateistruktur eines Repositorys, werden auf dem Datenspeichervolume für Ihre Enterprise Server-Instance gespeichert.

Actions bietet Unterstützung für diese Speicheranbieter:

  • Azure Blob Storage
  • Amazon S3
  • Google Cloud Storage
  • S3-kompatibler MinIO-Cluster

Hinweis

Dies sind die einzigen Speicheranbieter, für die Unterstützung und weitere Hilfe anbieten kann.

Es gibt andere S3-API-kompatible Speicherprodukte, für die sich -Partner selbst validiert haben, wenn sie mit Actions auf Enterprise Server arbeiten. Weitere Informationen findest du im Repository für GHES-Speicherpartner.

Für Speicherprodukte, die über das -Technologiepartnerschaftprogramm validiert wurden, ist der Speicheranbieter für den Support und die Dokumentation für die Verwendung des Speicherprodukts mit Actions verantwortlich.

Überlegungen zum Netzwerkbetrieb

Wenn Actions für dein Unternehmen aktiviert ist, werden nur HTTP-Proxys unterstützt. SOCKS5- und HTTPS-Proxys werden nicht unterstützt. Weitere Informationen zum Verwenden eines Proxyservers mit Enterprise Server findest du unter Konfigurieren eines ausgehenden Webproxyservers.

Aktivieren von Actions mit deinem Speicheranbieter

Führe eines der folgenden Verfahren aus, um Actions mit deinem ausgewählten Speicheranbieter zu aktivieren:

Verwalten von Zugriffsberechtigungen für Actions in deinem Unternehmen

Du kannst Richtlinien verwenden, um den Zugriff auf Actions zu verwalten. Weitere Informationen finden Sie unter Erzwingen von Richtlinien für Actions in deinem Unternehmen.

Selbst-gehostete Runner hinzufügen

Hinweis

Auf gehostete Runner werden aktuell nicht auf Enterprise Server unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der public roadmap.

Zum Ausführen von Actions-Workflows musst du 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 der in deinem Unternehmen verwendbaren Aktionen

Du kannst steuern, welche Aktionen die Benutzer in deinem Unternehmen verwenden dürfen. Dazu gehören das Einrichten von Connect für den automatischen Zugriff auf Aktionen von .com, oder das manuelle Synchronisieren von Aktionen von .com.

Weitere Informationen finden Sie unter Informationen zum Verwenden von Aktionen in deinem Unternehmen.

Allgemeine Sicherheitshärtung für Actions

Weitere Informationen zu Sicherheitsmethoden für Actions findest du unter Sicherheitshärtung für Actions.

Reservierte Namen

Wenn du Actions für dein Unternehmen aktivierst, werden zwei Organisationen erstellt: und actions. Wenn dein Unternehmen bereits den Organisationsnamen verwendet, wird stattdessen -org (oder --org, falls -org auch verwendet wird) verwendet. Wenn dein Unternehmen bereits den Organisationsnamen actions verwendet, wird stattdessen -actions (oder -actions-org, falls -actions auch verwendet wird) verwendet. Sobald Aktionen aktiviert sind, kannst du diese Namen nicht mehr verwenden.