

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.

# Aktion „Amazon ECS-Aufgabendefinition rendern“ hinzufügen
<a name="render-ecs-action-add"></a>

 Verwenden Sie die folgenden Anweisungen, um Ihrem Workflow die Aktion **„Amazon ECS rendern“ -Aufgabendefinition** hinzuzufügen. 

**Voraussetzung**  
Bevor Sie beginnen, stellen Sie sicher, dass Sie über einen Workflow verfügen, der eine Build-Aktion enthält, die dynamisch ein Docker-Image generiert. Einzelheiten finden Sie im vorherigen [Beispiel-Workflow](render-ecs-action-example-workflow.md).

------
#### [ Visual ]

**Um die Aktion „Amazon ECS-Aufgabendefinition rendern“ mit dem visuellen Editor hinzuzufügen**

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 **Bearbeiten** aus.

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

1. Wählen Sie oben links **\$1 Aktionen**, um den Aktionskatalog zu öffnen.

1. Wählen Sie in der Drop-down-Liste **Amazon** aus CodeCatalyst.

1. Suchen Sie nach der Aktion **„Amazon ECS-Aufgabendefinition rendern**“ und führen Sie einen der folgenden Schritte aus:
   + Wählen Sie das Pluszeichen (**\$1**), um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.

     Oder
   + Wählen Sie **„Amazon ECS-Aufgabendefinition rendern**“. Das Dialogfeld mit den Aktionsdetails wird angezeigt. In diesem Dialogfeld:
     + (Optional) Wählen Sie „**Quelltext** [anzeigen“, um den Quellcode der Aktion](workflows-view-source.md#workflows-view-source.title) anzuzeigen.
     + Wählen Sie **Zum Workflow** hinzufügen, um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.

1. Füllen Sie auf den Registerkarten **Eingaben** und **Konfiguration** die Felder nach Ihren Bedürfnissen aus. Eine Beschreibung der einzelnen Felder finden Sie unter[Aktion 'Amazon ECS-Aufgabendefinition rendern' YAML](render-ecs-action-ref.md). Diese Referenz enthält detaillierte Informationen zu jedem Feld (und dem entsprechenden YAML-Eigenschaftswert), wie es sowohl im YAML- als auch im visuellen Editor angezeigt wird.

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

------
#### [ YAML ]

**Um die Aktion „Amazon ECS-Aufgabendefinition rendern“ mit dem YAML-Editor hinzuzufügen**

1. [Öffnen Sie die Konsole unter https://codecatalyst.aws/ CodeCatalyst .](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 **Bearbeiten** aus.

1. Wählen Sie **YAML.**

1. Wählen Sie links oben **\$1 Aktionen, um den Aktionskatalog** zu öffnen.

1. Wählen Sie in der Drop-down-Liste **Amazon** aus CodeCatalyst.

1. Suchen Sie nach der Aktion **„Amazon ECS-Aufgabendefinition rendern**“ und führen Sie einen der folgenden Schritte aus:
   + Wählen Sie das Pluszeichen (**\$1**), um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.

     Oder
   + Wählen Sie **„Amazon ECS-Aufgabendefinition rendern**“. Das Dialogfeld mit den Aktionsdetails wird angezeigt. In diesem Dialogfeld:
     + (Optional) Wählen Sie „**Quelltext** [anzeigen“, um den Quellcode der Aktion](workflows-view-source.md#workflows-view-source.title) anzuzeigen.
     + Wählen Sie **Zum Workflow** hinzufügen, um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.

1. Ändern Sie die Eigenschaften im YAML-Code nach Ihren Bedürfnissen. Eine Erläuterung der einzelnen verfügbaren Eigenschaften finden Sie in der[Aktion 'Amazon ECS-Aufgabendefinition rendern' YAML](render-ecs-action-ref.md).

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

------

**Nächste Schritte**

Nachdem Sie die Render-Aktion hinzugefügt haben, fügen Sie Ihrem Workflow die Aktion **Deploy to Amazon ECS** hinzu, indem Sie den Anweisungen unter folgen[Bereitstellung auf Amazon ECS mit einem Workflow](deploy-action-ecs.md). Gehen Sie beim Hinzufügen der Bereitstellungsaktion wie folgt vor:

1. Wählen Sie auf der Registerkarte „**Eingaben**“ der Aktion „Bereitstellen“ unter **Artefakte — optional** das Artefakt aus, das durch die Renderaktion generiert wurde. Sie enthält die aktualisierte Aufgabendefinitionsdatei.

   Weitere Informationen zu Artefakten finden Sie unter [Artefakte und Dateien zwischen Aktionen teilen](workflows-working-artifacts.md).

1. Geben Sie auf der Registerkarte **Konfiguration** der Bereitstellungsaktion im Feld **Aufgabendefinition** die folgende Aktionsvariable an: `${action-name.task-definition}` wobei der Name Ihrer Renderaktion *action-name* steht, zum Beispiel`RenderTaskDef`. Die Renderaktion setzt diese Variable auf den neuen Namen der Aufgabendefinitionsdatei.

   Weitere Hinweise zu Variablen finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md).

   Weitere Informationen zur Konfiguration der Bereitstellungsaktion finden Sie im vorherigen [Beispiel-Workflow](render-ecs-action-example-workflow.md).