Einstellung der GitHub Actions für ein Repository verwalten

Informationen zu den GitHub Actions-Berechtigungen für Ihr Repository

Standardmäßig ist GitHub Actions in allen Repositorys und in allen Organisationen aktiviert. Du kannst GitHub Actions deaktivieren oder auf Aktionen und wiederverwendbare Workflows in deiner Organisation beschränken. Weitere Informationen GitHub Actionsfinden Sie unter Schreiben von Workflows.

Sie können GitHub Actions für Ihr Repository aktivieren. Wenn Sie GitHub Actions aktivieren, können Workflows Aktionen und wiederverwendbare Workflows in Ihrem Repository und anderen öffentlichen Repositorys ausführen. Sie können GitHub Actions für Ihr Repository vollständig deaktivieren. Wenn Du GitHub Actions deaktivierst, werden keine Workflows in Deinem Repository ausgeführt.

Alternativ können Sie GitHub Actions in Ihrem Repository aktivieren, aber die Aktionen und wiederverwendbaren Workflows einschränken, die in einem Workflow ausgeführt werden können.

Verwalten von GitHub Actions Berechtigungen für Ihr Repository

Sie können GitHub Actions für ein Repository deaktivieren oder eine Richtlinie festlegen, die konfiguriert, welche Aktionen und wiederverwendbaren Workflows im Repository verwendet werden können.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Wähle unter „Actions permissions" (Berechtigungen für Aktionen) eine Option aus.

   Wenn du OWNER zulassen und NICHT-OWNER, Aktionen und wiederverwendbare Workflows auswählen auswählst, werden Aktionen und wiederverwendbare Workflows innerhalb deiner Organisation zugelassen, und es stehen zusätzliche Optionen zur Verfügung, um andere spezifische Aktionen und wiederverwendbare Workflows zuzulassen. Weitere Informationen findest du unter Zulassen der Ausführung ausgewählter Aktionen und wiederverwendbarer Workflows.

   Wenn du Aktionen und wiederverwendbare Workflows nur in deiner Organisation zulässt, blockiert die Richtlinie jeglichen Zugriff auf Aktionen, die von GitHub erstellt wurden. Auf die Aktion actions/checkout könnte also beispielsweise nicht zugegriffen werden.

   Wenn du Require actions to be pinned to a full-length commit SHA festlegst, müssen alle Aktionen an einen vollständigen Commit-SHA angeheftet werden, damit diese verwendet werden können. Das schließt Aktionen deiner Organisation und durch GitHub erstellte Aktionen ein. Auf wiederverwendbare Workflows kann weiterhin nach Tag verwiesen werden. Weitere Informationen findest du unter Referenz zur sicheren Verwendung.

5. Klicken Sie auf Speichern.

Zulassen der Ausführung von ausgewählten Aktionen und wiederverwendbaren Workflows

Wenn Sie auswählen OWNER zulassen und NICHT-OWNER, Aktionen und wiederverwendbare Workflows auswählen, sind lokale Aktionen und wiederverwendbare Workflows zulässig, und es gibt zusätzliche Optionen zum Zulassen anderer spezifischer Aktionen und wiederverwendbarer Workflows:

• Aktionen zulassen, die von GitHub erstellt wurden: Sie können zulassen, dass alle von GitHub erstellten Aktionen von Workflows verwendet werden. Die von GitHub erstellten Aktionen befinden sich in den Organisationen actions und github. Weitere Informationen findest du unter den actions und github Organisationen.

• Marketplace-Aktionen von verifizierten Erstellern zulassen: Sie können zulassen, dass alle GitHub Marketplace Aktionen, die von bestätigten Erstellern erstellt wurden, von Workflows verwendet werden. Wenn GitHub den Ersteller der Aktion als Partnerorganisation überprüft hat, wird das Signal neben der Aktion in GitHub Marketplaceangezeigt.

• Bestimmte Aktionen und wiederverwendbare Workflows zulassen oder blockieren: Sie können Workflows auf die Verwendung von Aktionen und wiederverwendbaren Workflows in bestimmten Organisationen und Repositorys beschränken. Angegebene Aktionen können nicht auf mehr als 1000 festgelegt werden.

  Um den Zugriff auf bestimmte Tags einzuschränken oder SHAs einer Aktion oder eines wiederverwendbaren Workflows zu übernehmen, verwenden Sie dieselbe Syntax, die im Workflow zum Auswählen der Aktion oder des wiederverwendbaren Workflows verwendet wird.

  • Für eine Aktion ist die Syntax OWNER/REPOSITORY@TAG-OR-SHA. Verwende beispielsweise actions/javascript-action@v1.0.1 zum Auswählen eines Tags oder actions/javascript-action@a824008085750b8e136effc585c3cd6082bd575f zum Auswählen eines SHA-Werts. Weitere Informationen finden Sie unter Verwenden von vordefinierten Bausteinen im Workflow.
  • Für einen wiederverwendbaren Workflow ist die Syntax OWNER/REPOSITORY/PATH/FILENAME@TAG-OR-SHA. Beispiel: octo-org/another-repo/.github/workflows/workflow.yml@v1. Weitere Informationen finden Sie unter Wiederverwenden von Workflows.

  Du kannst das Platzhalterzeichen * verwenden, um Muster abzugleichen. Um beispielsweise alle Aktionen und wiederverwendbaren Workflows in Organisationen zuzulassen, deren Name mit space-org beginnt, können Sie space-org*/* angeben. Um alle Aktionen und wiederverwendbaren Workflows in Repositorys zuzulassen, die mit octocat beginnen, können Sie verwenden */octocat**@*. Weitere Informationen zur Verwendung des * Platzhalters findest du unter Workflowsyntax für GitHub Actions.

  Verwende ,, um Muster zu trennen. Um beispielsweise alle Aktionen und wiederverwendbaren Workflows aus den octocat und octokit Organisationen zuzulassen, können Sie angeben octocat/*, octokit/*.

  Verwenden Sie das ! Präfix, um Muster zu blockieren. Um beispielsweise alle Aktionen und wiederverwendbaren Workflows aus der Organisation space-org zuzulassen, aber eine bestimmte Aktion wie space-org/action zu blockieren, können Sie space-org/*, !space-org/action@* angeben. Standardmäßig sind nur Aktionen und wiederverwendbare Workflows zulässig, die in der Liste angegeben sind. Um alle Aktionen und wiederverwendbaren Workflows zuzulassen und gleichzeitig bestimmte Aktionen zu blockieren, können Sie angeben *, !space-org/action@*.

In diesem Verfahren wird veranschaulicht, wie Sie der Liste bestimmte Aktionen und wiederverwendbare Workflows hinzufügen.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Wählen Sie OWNER zulassen und NICHT-OWNER, Aktionen und wiederverwendbare Workflows auswählen unter "Berechtigungen für Aktionen" Ihre erforderlichen Aktionen aus, und fügen Sie sie der Liste hinzu.

5. Klicken Sie auf Speichern.

Steuern von Änderungen von Forks zu Workflows in öffentlichen Repositorys

Jeder kann ein öffentliches Repository forken und dann einen Pull Request einreichen, der Änderungen an den GitHub Actions Workflows des Repositorys vorschlägt. Workflows von Forks haben zwar keinen Zugriff auf vertrauliche Daten wie Geheimnisse, können aber für die Verwalter störend sein, wenn sie zu missbräuchlichen Zwecken geändert werden.

Um dies zu verhindern, werden Workflows für Pull Requests in öffentlichen Repositorys von einigen externen Beitragenden nicht automatisch ausgeführt und müssen möglicherweise zunächst genehmigt werden. Je nach der Einstellung „Genehmigung für die Ausführung von Fork-Pull-Request-Workflows von Mitwirkenden“ werden Workflows für Pull Requests für öffentliche Repositorys nicht automatisch ausgeführt und müssen möglicherweise genehmigt werden, wenn Folgendes zutrifft:

• Der Pull Request wurde von einem Benutzer erstellt, der gemäß der ausgewählten Richtlinie eine Genehmigung benötigt.
• Das Pull Request-Ereignis wurde von einem Benutzer ausgelöst, der gemäß der ausgewählten Richtlinie eine Genehmigung benötigt.

Standardmäßig ist bei allen erstmaligen Mitwirkenden eine Genehmigung zum Ausführen von Workflows erforderlich.

Durch pull_request_target-Ereignisse ausgelöste Workflows werden im Kontext des Basis-Branchs ausgeführt. Da der Basis-Branch als vertrauenswürdig gilt, werden durch diese Ereignisse ausgelöste Workflows immer ausgeführt, unabhängig von den Genehmigungseinstellungen. Weitere Informationen zum pull_request_target-Ereignis findest du unter Ereignisse zum Auslösen von Workflows.

Du kannst dieses Verhalten für ein Repository mithilfe des nachstehenden Verfahrens konfigurieren. Durch Ändern dieser Einstellung wird die auf Organisations- oder Unternehmensebene festgelegte Konfiguration außer Kraft gesetzt.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Wähle unter Genehmigung für die Ausführung von Fork-Pull-Request-Workflows von Mitwirkenden, welche Teilmenge von Benutzern eine Genehmigung braucht, bevor Workflows für deren Pull Requests ausgeführt werden. Sowohl der Autor des Pull Requests als auch der Akteur des Pull Request-Ereignisses, das den Workflow auslöst, werden überprüft, um festzustellen, ob eine Genehmigung erforderlich ist. Wenn eine Genehmigung erforderlich ist, muss ein Benutzer mit Schreibzugriff auf das Repository den auszuführenden Pull Request-Workflow genehmigen. Weitere Informationen findest du unter Genehmigen von Workflowausführungen über Forks.

   Warnung

   Wenn nur für erstmalig Mitwirkende eine Genehmigung erforderlich ist (die ersten beiden Einstellungen), benötigt ein Benutzer, der bereits Commits oder Pull Requests in das Repository gemergt hat, keine Genehmigung. Ein böswilliger Benutzer kann diese Anforderung erfüllen, indem er einen einfachen Tippfehler oder eine andere harmlose Änderung in einem selbst verfassten Pull Request oder in einem Pull Request eines anderen Benutzers von einem Maintainer akzeptieren lässt.

   • Genehmigung für Mitwirkende erforderlich, die bei GitHub neu sind. Nur Nutzer, die sowohl neu auf GitHub sind als auch deren Commit oder Pull Request noch nie in dieses Repository übernommen wurde, benötigen eine Genehmigung, um Workflows auszuführen.
   • Genehmigung für erstmalige Mitwirkende erforderlich. Nur Nutzer, deren Commit oder Pull Request noch nie in dieses Repository gemergt wurde, benötigen eine Genehmigung, um Workflows auszuführen.
   • Genehmigung für alle externen Mitwirkenden anfordern Alle Benutzer, die nicht Mitglied oder Besitzer dieses Repositorys und nicht Mitglied der Organisation sind, benötigen eine Genehmigung zum Ausführen von Workflows.

5. Klicke auf Speichern, um die Einstellung zu übernehmen.

Weitere Informationen zum Genehmigen von Workflowausführungen, für die diese Richtlinie gilt, findest du unter Genehmigen von Workflowausführungen über Forks.

Aktivieren von Workflows für Forks privater Repositories

Wenn du für deine privaten Repositorys Forks verwendest, kannst du Richtlinien konfigurieren, die steuern, wie Benutzer Workflows für pull_request-Ereignisse ausführen können. Du kannst diese Richtlinieneinstellungen für Organisationen oder Repositorys konfigurieren. Dies ist jedoch nur für private Repositorys verfügbar.

Wenn eine Richtlinie für ein Unternehmen oderOrganisation deaktiviert ist, kann sie nicht für ein Repository aktiviert werden.

• Ausführen von Workflows aus Fork-Pull Requests: Ermöglicht Benutzern das Ausführen von Workflows aus Fork-Pull Requests mit einem GITHUB_TOKEN mit ausschließlicher Leseberechtigung und ohne Zugriff auf geheime Schlüssel.
• Senden von Schreibtoken an Workflows aus Pull Requests: Ermöglicht Pull Requests aus Forks die Verwendung eines GITHUB_TOKEN mit Schreibberechtigung.
• Senden von Geheimnissen an Workflows aus Pull Requests: Stellt dem Pull Request alle Geheimnisse zur Verfügung.
• Genehmigung für Fork-Pull Request-Workflows erforderlich: Workflows, die ohne Schreibberechtigung für Pull Requests von Projektmitarbeiter*innen ausgeführt werden, müssen von einer Person mit Schreibberechtigung genehmigt werden, bevor sie ausgeführt werden können.

Konfigurieren der Forkrichtlinie für ein privates Repository

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Wähle unter Pull Request-Workflows forken deine Optionen aus.

5. Klicke auf Speichern, um die Einstellung zu übernehmen.

Festlegen der Berechtigungen von GITHUB_TOKEN für dein Repository

Du kannst die Standardberechtigungen festlegen, die dem GITHUB_TOKEN erteilt werden. Weitere Informationen zum GITHUB_TOKEN findest du unter Verwenden von GITHUB_TOKEN für die Authentifizierung in Workflows. Du kannst eine eingeschränkte Gruppe von Berechtigungen als Standard festlegen oder freizügige Einstellungen vornehmen.

Die Standardberechtigungen können auch in den Organisationseinstellungen konfiguriert werden. Wenn dein Repository zu einer Organisation gehört und ein restriktiverer Standardwert in den Organisationseinstellungen ausgewählt wurde, wird dieselbe Option in deinen Repositoryeinstellungen ausgewählt, und die zulässige Option wird deaktiviert.

Jeder mit Schreibzugriff auf ein Repository kann die dem GITHUB_TOKEN erteilten Berechtigungen ändern und Zugriff nach Bedarf hinzufügen oder entfernen, indem er den permissions-Schlüssel in der Workflowdatei bearbeitet. Weitere Informationen findest du unter permissions.

Konfigurieren der GITHUB_TOKEN-Standardberechtigungen

Wenn du ein neues Repository in deinem persönlichen Konto erstellst, hat GITHUB_TOKEN standardmäßig nur Lesezugriff auf die Bereiche contents und packages. Wenn du ein neues Repository in einer Organisation erstellst, wird die Einstellung von den Organisationseinstellungen übernommen.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Wähle unter „Workflow permissions“ aus, ob GITHUB_TOKEN Lese- und Schreibzugriff für alle Berechtigungen (permissive Einstellung) oder nur Lesezugriff für die contents- und packages-Berechtigungen (eingeschränkte Einstellung) haben soll.

5. Klicke auf Save (Speichern), um die Einstellungen zu übernehmen.

GitHub Actions daran hindern, Pull Requests zu erstellen oder zu genehmigen

Du kannst zulassen oder verhindern, dass GitHub Actions-Workflows Pull Requests erstellen oder genehmigen.

Wenn Du ein neues Repository in Deinem persönlichen Konto erstellst, dürfen Workflows standardmäßig keine Pullanforderungen erstellen oder genehmigen. Wenn du ein neues Repository in einer Organisation erstellst, wird die Einstellung von den Organisationseinstellungen übernommen.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Verwenden Sie unter "Workflowberechtigungen" die Allow-GitHub Actions zum Erstellen und Genehmigen von Pullanforderungen, um zu konfigurieren, ob GITHUB_TOKEN Pullanforderungen erstellen und genehmigen kann.

5. Klicke auf Save (Speichern), um die Einstellungen zu übernehmen.

Zulassen des Zugriffs auf Komponenten in einem privaten Repository

Aktionen und wiederverwendbare Workflows in Ihren privaten Repositorien können mit anderen privaten Repositorien , die demselben Benutzer oder derselben Organisation gehören, geteilt werden. Informationen zu privaten Repositorys findest du unter Informationen zu Repositorys.

Du kannst die folgenden Schritte ausführen, um zu konfigurieren, ob von außerhalb des Repositorys auf Aktionen und wiederverwendbare Workflows in einem privaten Repository zugegriffen werden kann. Weitere Informationen finden Sie unter Freigeben von Aktionen und Workflows in deinem privaten Repository und Teilen von Aktionen und Workflows in Ihrer Organisation. Alternativ kannst du die REST-API verwenden, um die Zugriffsebene festzulegen oder Details dazu abzurufen. Weitere Informationen findest du unter REST-API-Endpunkte für GitHub Actions Berechtigungen und REST-API-Endpunkte für GitHub Actions Berechtigungen.

Verwalten des Zugriffs für ein privates Repository

1. Navigieren Sie auf GitHub zur Hauptseite des privaten Repositorys.

2. Klicken Sie unter Ihrem Repositorynamen auf "Einstellungen".

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Wähle unter Access (Zugriff) eine der Zugriffseinstellungen aus:

   • Not accessible (Nicht zugänglich): Workflows in anderen Repositorys können nicht auf dieses Repository zugreifen.
   • Zugänglich über Repositorys, die der/dem Benutzer*in „BENUTZERNAME“ gehören – Workflows in anderen Repositorys, die demselben Benutzer oder derselben Benutzerin gehören, können auf die Aktionen und wiederverwendbare Workflows in diesem Repository zugreifen. Der Zugriff ist nur von privaten Repositorys aus zulässig.

5. Klicke auf Save (Speichern), um die Einstellungen zu übernehmen.

Verwalten des Zugriffs für ein privates Repository in einer Organisation

1. Navigieren Sie auf GitHub zur Hauptseite des privaten Repositorys.

2. Klicken Sie unter Ihrem Repositorynamen auf "Einstellungen".

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Wähle unter Access (Zugriff) eine der Zugriffseinstellungen aus:

   • Not accessible (Nicht zugänglich): Workflows in anderen Repositorys können nicht auf dieses Repository zugreifen.
   • Zugriff über Repositorys in der Organisation „NAME DER ORGANISATION“ – Workflows in anderen Repositorys, die Teil der Organisation „NAME DER ORGANISATION“ sind, können auf die Aktionen und wiederverwendbaren Workflows in diesem Repository zugreifen. Der Zugriff ist nur von privaten Repositorys aus zulässig.

5. Klicke auf Save (Speichern), um die Einstellungen zu übernehmen.

Konfigurieren von Cacheeinstellungen für Ihr Repository

Sie können Die Cacheaufbewahrungs- und Größeneinstellungen für Ihr Repository konfigurieren. Diese Funktion ist optional verfügbar und steht Nutzern mit hinterlegter Zahlungsmethode sowie den Tarifen GitHub Pro, GitHub Team oder GitHub Enterprise Cloud zur Verfügung.

Wenn Ihr Repository im Besitz einer Organisation ist, die Cacheeinstellungen konfiguriert hat, können Sie Grenzwerte bis zu dem von der Organisation festgelegten Höchstwert konfigurieren. Wenn Ihr Repository im Besitz des Benutzers ist, können Sie bis zu den globalen Höchstwerte konfigurieren.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Konfigurieren Sie im Abschnitt "Cacheeinstellungen" die folgenden Einstellungen:

   • Cacheaufbewahrung: Die Anzahl der Tage, mit der Caches vor dem automatischen Löschen aufbewahrt werden sollen. Der Standardwert ist 7 Tage. Sie können bis zu 90 Tage für öffentliche Repositorys oder 365 Tage für private und interne Repositorys (oder bis zum von Ihrer Organisation festgelegten Grenzwert) konfigurieren.
   • Grenzwert für die Cachegröße: Die maximale Gesamtgröße aller Caches in Ihrem Repository. Der Standardwert ist 10 GB. Sie können bis zu 10.000 GB pro Repository (oder bis zum von Ihrer Organisation festgelegten Grenzwert) konfigurieren. Wenn dieser Grenzwert überschritten wird, werden ältere Caches entfernt, um Platz für neue Caches zu schaffen.

5. Klicke auf Save (Speichern), um die Einstellungen zu übernehmen.

Weitere Informationen zur Cacheräumung finden Sie unter Referenz zum Zwischenspeichern von Abhängigkeiten.

Konfigurieren des Aufbewahrungszeitraums für GitHub Actions Artefakte und Protokolle in Ihrem Repository

Sie können den Aufbewahrungszeitraum für GitHub Actions Artefakte und Protokolle in Ihrem Repository konfigurieren.

Standardmäßig werden die von Workflows generierten Artefakte und Protokolldateien 90 Tage lang aufbewahrt und dann automatisch gelöscht. Du kannst den Aufbewahrungszeitraum abhängig von der Art des Repositorys anpassen:

• Öffentliche Repositorys: Der Aufbewahrungszeitraum kann auf einen beliebigen Wert zwischen einem Tag und 90 Tagen festgelegt werden.
• Private Repositorys: Der Aufbewahrungszeitraum kann auf einen beliebigen Wert zwischen einem Tag und 400 Tagen festgelegt werden.

Der angepasste Aufbewahrungszeitraum gilt nur für neue Artefakte und Protokolldateien. Er gilt nicht rückwirkend für bereits vorhandene Objekte. Bei verwalteten Repositorys und Organisationen darf der maximale Aufbewahrungszeitraum den von der verwaltenden Organisation oder vom verwaltenden Unternehmen festgelegten Grenzwert nicht übersteigen.

Du kannst auch einen benutzerdefinierten Aufbewahrungszeitraum für ein bestimmtes Artefakt definieren, das von einem Workflow erstellt wurde. Weitere Informationen finden Sie unter Entfernen von Workflowartefakten.

Festlegen des Aufbewahrungszeitraums für Artefakte und Protokoll für ein Repository

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke in der linken Randleiste auf Actions und dann auf General.

4. Gib unter Artifact and log retention einen neuen Wert ein.

5. Klicke auf Speichern, um die Änderungen zu übernehmen.