

Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Gating eines Workflow-Laufs
<a name="workflows-gates"></a>

Ein *Gate* ist eine Workflow-Komponente, mit der Sie verhindern können, dass ein Workflow-Lauf fortgesetzt wird, sofern nicht bestimmte Bedingungen erfüllt sind. Ein Beispiel für ein Gate ist das **Genehmigungstor**, bei dem Benutzer eine Genehmigung in der CodeCatalyst Konsole einreichen müssen, bevor die Workflow-Ausführung fortgesetzt werden kann.

Sie können Gates zwischen Aktionssequenzen in einem Workflow oder vor der ersten Aktion (die unmittelbar nach dem Herunterladen der **Quelldatei** ausgeführt wird) hinzufügen. Sie können Gates auch nach der letzten Aktion hinzufügen, falls Sie dies benötigen.

Weitere Informationen zu Workflow-Ausführungen finden Sie unter[Einen Workflow ausführen](workflows-working-runs.md).

**Topics**
+ [Gate-Typen](#workflows-gates-types)
+ [Kann ich ein Gate einrichten, das parallel zu einer anderen Aktion läuft?](#workflows-approval-parallel)
+ [Kann ich ein Gate verwenden, um zu verhindern, dass ein Workflow-Lauf gestartet wird?](#workflows-gates-prevent)
+ [Einschränkungen von Gates](#workflows-gate-limitations)
+ [Hinzufügen eines Gates zu einem Workflow](workflows-gates-add.md)
+ [Sequenzierung von Gates und Aktionen](workflows-gates-depends-on.md)
+ [Die Version eines Gates angeben](workflows-gates-version.md)

## Gate-Typen
<a name="workflows-gates-types"></a>

Derzeit CodeCatalyst unterstützt Amazon eine Art von Gate: das **Approval** Gate. Weitere Informationen finden Sie unter [Genehmigungen für Workflow-Läufe erforderlich](workflows-approval.md).

## Kann ich ein Gate einrichten, das parallel zu einer anderen Aktion läuft?
<a name="workflows-approval-parallel"></a>

Nein. Gates können nur vor oder nach einer Aktion laufen. Weitere Informationen finden Sie unter [Sequenzierung von Gates und Aktionen](workflows-gates-depends-on.md).

## Kann ich ein Gate verwenden, um zu verhindern, dass ein Workflow-Lauf gestartet wird?
<a name="workflows-gates-prevent"></a>

Ja, mit Qualifikationen.

Sie können verhindern, dass eine *Workflow-Ausführung Aufgaben ausführt*, was sich geringfügig von der Verhinderung des *Starts* unterscheidet.

Um zu verhindern, dass ein Workflow Aufgaben ausführt, fügen Sie vor der allerersten Aktion in einem Workflow ein Tor hinzu. In diesem Szenario wird ein Workflow-Lauf *gestartet, d. h. es werden* Ihre Quell-Repository-Dateien heruntergeladen. Er wird jedoch daran gehindert, Aufgaben auszuführen, bis das Gate entsperrt ist.

**Anmerkung**  
Workflows, die starten und dann durch ein Gate blockiert werden, werden trotzdem auf Ihre *maximale Anzahl gleichzeitiger Workflow-Ausführungen pro Speicherkontingent* und anderen Kontingenten angerechnet. Um sicherzustellen, dass Sie die Workflow-Kontingente nicht überschreiten, sollten Sie einen Workflow-Auslöser verwenden, um einen Workflow bedingt zu starten, anstatt ein Gate zu verwenden. Erwägen Sie auch, anstelle eines Gates eine Regel zur Genehmigung von Pull-Requests zu verwenden. Weitere Informationen zu Kontingenten, Triggern und Genehmigungsregeln für Pull-Requests finden Sie unter [Kontingente für Workflows in CodeCatalyst](workflows-quotas.md)[Automatisches Starten einer Workflow-Ausführung mithilfe von Triggern](workflows-add-trigger.md), und[Verwaltung der Anforderungen für das Zusammenführen einer Pull-Anfrage mit Genehmigungsregeln](source-pull-requests-approval-rules.md).

## Einschränkungen von Gates
<a name="workflows-gate-limitations"></a>

Für Gates gelten die folgenden Einschränkungen:
+ Gates können nicht in Verbindung mit der Compute-Sharing-Funktion verwendet werden. Weitere Informationen über dieses Feature finden Sie unter [Rechenleistung für mehrere Aktionen gemeinsam nutzen](compute-sharing.md).
+ Gates können nicht innerhalb von Aktionsgruppen verwendet werden. Weitere Informationen zu Aktionsgruppen finden Sie unter[Gruppierung von Aktionen in Aktionsgruppen](workflows-group-actions.md).

# Hinzufügen eines Gates zu einem Workflow
<a name="workflows-gates-add"></a>

In Amazon können Sie einem Workflow ein Tor hinzufügen CodeCatalyst, um zu verhindern, dass er fortgesetzt wird, sofern nicht bestimmte Bedingungen erfüllt sind. Gehen Sie wie folgt vor, um einem Workflow ein Gate hinzuzufügen.

Weitere Informationen zu Gates finden Sie unter[Gating eines Workflow-Laufs](workflows-gates.md).

**So fügen Sie ein Gate hinzu und konfigurieren es**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie Ihr Projekt.

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**

1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

1. Wählen Sie **Edit** (Bearbeiten) aus.

1. Wählen Sie **Visual**.

1. Wählen Sie auf der linken Seite **Gates** aus.

1. Suchen Sie im Gate-Katalog nach einem Gate und wählen Sie dann das Pluszeichen (**\$1**), um das Gate zu Ihrem Workflow hinzuzufügen.

1. Konfigurieren Sie das Gate. Wählen Sie **Visual**, um den visuellen Editor zu verwenden, oder **YAML**, um den YAML-Editor zu verwenden. Eine ausführliche Anleitung finden Sie unter:
   + [Hinzufügen eines Genehmigungstors](workflows-approval-add.md)

1. (Optional) Wählen Sie **Validieren**, um sicherzustellen, dass der YAML-Code gültig ist.

1. Wählen Sie **Commit**, um Ihre Änderungen zu übernehmen.

# Sequenzierung von Gates und Aktionen
<a name="workflows-gates-depends-on"></a>

In Amazon können Sie ein Gate einrichten CodeCatalyst, das vor oder nach einer Workflow-Aktion, Aktionsgruppe oder einem Gate ausgeführt wird. Sie können beispielsweise ein `Approval` Gate einrichten, das vor einer `Deploy` Aktion ausgeführt wird. In diesem Fall soll die `Deploy` Aktion vom `Approval` Gate *abhängen*.

Um Abhängigkeiten zwischen Gates und Aktionen einzurichten, konfigurieren Sie das Gate oder die Aktion **Hängt von der Eigenschaft ab**. Detaillierte Anweisungen finden Sie unter [Abhängigkeiten zwischen Aktionen einrichten](workflows-depends-on-set-up.md). Die Anweisungen, auf die verwiesen wird, beziehen sich auf *Workflow-Aktionen*, gelten aber auch für Gates. 

Ein Beispiel für die Einrichtung der Eigenschaft **Hängt von ab** mit einem Tor finden Sie unter[Beispiel: Ein Genehmigungstor](workflows-approval-example.md).

Weitere Informationen zu Gates finden Sie unter[Gating eines Workflow-Laufs](workflows-gates.md).

Weitere Informationen zu Workflow-Aktionen finden Sie unter[Workflow-Aktionen konfigurieren](workflows-actions.md).

# Die Version eines Gates angeben
<a name="workflows-gates-version"></a>

Wenn Sie einem Workflow ein Gate hinzufügen, wird standardmäßig die Vollversion der Workflow-Definitionsdatei im folgenden Format CodeCatalyst hinzugefügt:

`vmajor.minor.patch` 

Zum Beispiel:

```
My-Gate:
  Identifier: aws/approval@v1
```

Sie können die Version verlängern, sodass der Workflow eine bestimmte Haupt- oder Nebenversion des Gates verwendet. Detaillierte Anweisungen finden Sie unter [Angabe der zu verwendenden Aktionsversion](workflows-action-versions.md). Das referenzierte Thema bezieht sich auf Workflow-Aktionen, gilt aber auch für Gates.

Weitere Informationen zu Gates in CodeCatalyst finden Sie unter[Gating eines Workflow-Laufs](workflows-gates.md).