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. # Verwenden vordefinierter Variablen *Vordefinierte Variablen* sind Schlüssel-Wert-Paare, die von einem Workflow automatisch ausgegeben und Ihnen zur Verwendung in Workflow-Aktionen zur Verfügung gestellt werden. Weitere Informationen zu Variablen finden Sie unter. [Verwenden von Variablen in Workflows](workflows-working-with-variables.md) **Topics** + [Beispiele für die Referenzierung vordefinierter Variablen](workflows-predefined-examples.md) + [Verweisen auf eine vordefinierte Variable](workflows-working-with-variables-reference-output-vars.md) + [Ermitteln, welche vordefinierten Variablen Ihr Workflow ausgibt](workflows-working-with-variables-determine-output-vars.md) + [Liste der vordefinierten Variablen](workflow-ref-action-variables.md) # Beispiele für die Referenzierung vordefinierter Variablen Die folgenden Beispiele zeigen, wie Sie in der Workflow-Definitionsdatei auf vordefinierte Variablen verweisen. Weitere Informationen zu vordefinierten Variablen finden Sie unter[Verwenden vordefinierter Variablen](workflows-using-predefined-variables.md). **Topics** + [Beispiel: Verweisen auf die vordefinierte CommitId Variable ""](#workflows-working-with-variables-ex-refer-action) + [Beispiel: Verweisen auf die vordefinierte BranchName Variable ""](#workflows-working-with-variables-ex-branch) ## Beispiel: Verweisen auf die vordefinierte CommitId Variable "" Das folgende Beispiel zeigt Ihnen, wie Sie in der `MyBuildAction` Aktion auf die `CommitId` vordefinierte Variable verweisen. Die `CommitId` Variable wird automatisch von ausgegeben CodeCatalyst. Weitere Informationen finden Sie unter [Liste der vordefinierten Variablen](workflow-ref-action-variables.md). Obwohl das Beispiel zeigt, dass die Variable in der Build-Aktion verwendet wird, können Sie sie `CommitId` in jeder beliebigen Aktion verwenden. ``` MyBuildAction: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource Configuration: Steps: #Build Docker image and tag it with a commit ID - Run: docker build -t image-repo/my-docker-image:latest . - Run: docker tag image-repo/my-docker-image:${WorkflowSource.CommitId} ``` ## Beispiel: Verweisen auf die vordefinierte BranchName Variable "" Das folgende Beispiel zeigt Ihnen, wie Sie in der `CDKDeploy` Aktion auf die `BranchName` vordefinierte Variable verweisen. Die `BranchName` Variable wird automatisch von ausgegeben CodeCatalyst. Weitere Informationen finden Sie unter [Liste der vordefinierten Variablen](workflow-ref-action-variables.md). Obwohl das Beispiel zeigt, dass die Variable in der **AWS CDK Bereitstellungsaktion** verwendet wird, können Sie sie `BranchName` in jeder beliebigen Aktion verwenden. ``` CDKDeploy: Identifier: aws/cdk-deploy@v2 Inputs: Sources: - WorkflowSource Configuration: StackName: app-stack-${WorkflowSource.BranchName} ``` # Verweisen auf eine vordefinierte Variable Sie können in jeder Aktion innerhalb eines CodeCatalyst Amazon-Workflows auf vordefinierte Variablen verweisen. Verwenden Sie die folgenden Anweisungen, um auf eine vordefinierte Variable in einem Workflow zu verweisen. Weitere Informationen zu vordefinierten Variablen finden Sie unter[Verwenden vordefinierter Variablen](workflows-using-predefined-variables.md). **Voraussetzung** Ermitteln Sie den Namen der vordefinierten Variablen, auf die Sie verweisen möchten, z. `CommitId` B. Weitere Informationen finden Sie unter [Ermitteln, welche vordefinierten Variablen Ihr Workflow ausgibt](workflows-working-with-variables-determine-output-vars.md). ------ #### [ Visual ] *Nicht verfügbar. Wählen Sie YAML, um die YAML-Anweisungen anzuzeigen.* ------ #### [ YAML ] **Um auf eine vordefinierte Variable zu verweisen (YAML-Editor)** 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 **YAML.** 1. Fügen Sie in einer CodeCatalyst Aktion die vordefinierte Variablenreferenz mit der folgenden Syntax hinzu: ``` ${action-group-name.action-name-or-WorkflowSource.variable-name} ``` Ersetzen Sie: + *action-group-name*mit dem Namen der Aktionsgruppe. **Anmerkung** Sie können weglassen, *action-group-name* wenn es keine Aktionsgruppe gibt oder wenn die Variable durch eine Aktion in derselben Aktionsgruppe erzeugt wird. + *action-name-or-WorkflowSource*mit: Der Name der Aktion, die die Variable ausgibt. oder `WorkflowSource`, wenn es sich bei der Variablen um die `CommitId` Variable `BranchName` oder handelt. + *variable-name*mit dem Namen der Variablen. Beispiel: ``` MySecondAction: Configuration: Steps: - Run: echo ${MyFirstECSAction.cluster} ``` Ein weiteres Beispiel: ``` MySecondAction: Configuration: Steps: - Run: echo ${WorkflowSource.CommitId} ``` Weitere Beispiele finden Sie unter [Beispiele für die Referenzierung vordefinierter Variablen](workflows-predefined-examples.md). Weitere Informationen finden Sie unter [YAML-Workflow-Definition](workflow-reference.md) Für Ihre Aktion. 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** aus. ------ # Ermitteln, welche vordefinierten Variablen Ihr Workflow ausgibt Gehen Sie wie folgt vor, um zu ermitteln, welche vordefinierten Variablen ein Workflow ausgibt, wenn er ausgeführt wird. Sie können dann innerhalb desselben Workflows auf diese Variablen verweisen. Weitere Informationen zu vordefinierten Variablen finden Sie unter[Verwenden vordefinierter Variablen](workflows-using-predefined-variables.md). **So ermitteln Sie die vordefinierten Variablen, die Ihr Workflow ausgibt** + Führen Sie eine der folgenden Aktionen aus: + **Führen Sie den Workflow einmal** aus. Nach Abschluss des Laufs werden die vom Workflow ausgegebenen Variablen auf der Registerkarte **Variablen** der Seite mit den Ausführungsdetails angezeigt. Weitere Informationen finden Sie unter [Status und Details der Workflow-Ausführung anzeigen](workflows-view-run.md). + **Konsultieren Sie die [Liste der vordefinierten Variablen](workflow-ref-action-variables.md)**. In dieser Referenz sind der Variablenname (Schlüssel) und der Wert für jede vordefinierte Variable aufgeführt. **Anmerkung** Die maximale Gesamtgröße der Variablen eines Workflows ist unter aufgeführt[Kontingente für Workflows in CodeCatalyst](workflows-quotas.md). Wenn die Gesamtgröße das Maximum überschreitet, schlägt die Aktion, die nach dem Erreichen des Maximums ausgeführt wird, möglicherweise fehl. # Liste der vordefinierten Variablen In den folgenden Abschnitten finden Sie eine Übersicht über die vordefinierten Variablen, die automatisch durch CodeCatalyst Aktionen im Rahmen einer Workflow-Ausführung erzeugt werden. Weitere Informationen zu vordefinierten Variablen finden Sie unter[Verwenden vordefinierter Variablen](workflows-using-predefined-variables.md). **Anmerkung** Diese Liste enthält nur vordefinierte Variablen, die von der CodeCatalyst Quelle und den [CodeCatalyst Aktionen ausgegeben werden](workflows-actions.md#workflows-actions-types). Wenn Sie andere Aktionstypen verwenden, z. B. Aktionen oder GitHub CodeCatalyst Labs-Aktionen, finden Sie stattdessen weitere Informationen unter[Ermitteln, welche vordefinierten Variablen Ihr Workflow ausgibt](workflows-working-with-variables-determine-output-vars.md). **Liste** **Anmerkung** Nicht alle CodeCatalyst Aktionen erzeugen vordefinierte Variablen. Wenn die Aktion nicht in der Liste enthalten ist, erzeugt sie keine Variablen. + [Variablen BranchName '' und CommitId ''](workflows-sources-variables.md) + [CloudFormation 'Stack'-Variablen bereitstellen](deploy-action-cfn-variables.md) + [Variablen „In Amazon ECS bereitstellen“](deploy-action-ecs-variables.md) + [Variablen „Im Kubernetes-Cluster bereitstellen“](deploy-action-eks-variables.md) + [Variablen 'AWS CDK bereitstellen'](cdk-dep-action-variables.md) + [AWS CDK 'Bootstrap'-Variablen](cdk-boot-action-variables.md) + [Variablen 'AWS Lambda aufrufen'](lam-invoke-action-variables.md) + [Variablen „Amazon ECS-Aufgabendefinition rendern“](render-ecs-action-variables.md)