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 von Variablen in Workflows Eine *Variable* ist ein Schlüssel-Wert-Paar, das Informationen enthält, auf die Sie in Ihrem CodeCatalyst Amazon-Workflow verweisen können. Der Wertteil der Variablen wird bei der Ausführung des Workflows durch einen tatsächlichen Wert ersetzt. Es gibt zwei Arten von Variablen, die Sie in einem Workflow verwenden können: + **Benutzerdefinierte Variablen** — Dies sind Schlüssel-Wert-Paare, die Sie definieren. + **Vordefinierte Variablen** — Dies sind Schlüssel-Wert-Paare, die von einem Workflow automatisch ausgegeben werden. Sie müssen sie nicht definieren. Weitere Informationen zu Workflows finden Sie unter [Erstellen, Testen und Bereitstellen mit WorkflowsMit Workflows erstellen, testen und bereitstellen](workflow.md). **Anmerkung** CodeCatalyst unterstützt auch [GitHub Ausgabeparameter](https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter), die sich wie Variablen verhalten und in anderen Aktionen referenziert werden können. Weitere Informationen finden Sie unter [GitHub Ausgabeparameter exportieren](integrations-github-action-export.md) und [Referenzieren von GitHub Ausgabeparametern](integrations-github-action-referencing.md) **Topics** + [Verwenden von benutzerdefinierten Variablen](workflows-using-variables.md) + [Verwenden vordefinierter Variablen](workflows-using-predefined-variables.md) # Verwenden von benutzerdefinierten Variablen *Benutzerdefinierte Variablen* sind Schlüssel-Wert-Paare, die Sie definieren. Es gibt zwei Arten: + **Klartext-Variablen oder einfach **Variablen**** — Dies sind Schlüssel-Wert-Paare, die Sie in der Workflow-Definitionsdatei im Klartext definieren. + **Secrets** — Dies sind Schlüssel-Wert-Paare, die Sie auf einer separaten **Secrets-Seite** der CodeCatalyst Amazon-Konsole definieren. Der *Schlüssel* (Name) ist ein öffentliches Label, und der *Wert* enthält die Informationen, die Sie geheim halten möchten. Sie geben nur den Schlüssel in der Workflow-Definitionsdatei an. Verwenden Sie geheime Schlüssel anstelle von Kennwörtern und anderen vertraulichen Informationen in der Workflow-Definitionsdatei. **Anmerkung** Der Kürze halber wird in diesem Leitfaden der Begriff *Variable* für *Klartext-Variable* verwendet. Weitere Informationen zu Variablen finden Sie unter. [Verwenden von Variablen in Workflows](workflows-working-with-variables.md) **Topics** + [Beispiele für Variablen](workflows-working-with-variables-ex.md) + [Definition einer Variablen](workflows-working-with-variables-define-input.md) + [Ein Geheimnis definieren](workflows-working-with-variables-define-secret.md) + [Eine Variable exportieren, damit sie von anderen Aktionen verwendet werden kann](workflows-working-with-variables-export-input.md) + [Verweisen auf eine Variable in der Aktion, die sie definiert](workflows-working-with-variables-reference-input.md) + [Referenzieren einer Variablenausgabe durch eine andere Aktion](workflows-working-with-variables-reference-action.md) + [Auf ein Geheimnis verweisen](workflows-working-with-variables-reference-secret.md) # Beispiele für Variablen Die folgenden Beispiele zeigen, wie Variablen in der Workflow-Definitionsdatei definiert und referenziert werden. Weitere Informationen zu Variablen finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md). **Topics** + [Beispiel: Definieren einer Variablen mithilfe der Eigenschaft Inputs](#workflows-working-with-variables-ex-define-inputs) + [Beispiel: Definieren einer Variablen mithilfe der Eigenschaft Steps](#workflows-working-with-variables-ex-define-steps) + [Beispiel: Exportieren einer Variablen mithilfe der Outputs-Eigenschaft](#workflows-working-with-variables-ex-export-outputs) + [Beispiel: Verweisen auf eine Variable, die in derselben Aktion definiert wurde](#workflows-working-with-variables-ex-refer-current) + [Beispiel: Verweisen auf eine Variable, die in einer anderen Aktion definiert wurde](#workflows-working-with-variables-ex-refer-other) + [Beispiel: Verweisen auf ein Geheimnis](#workflows-working-with-variables-ex-refer-secret) ## Beispiel: Definieren einer Variablen mithilfe der Eigenschaft Inputs Das folgende Beispiel zeigt Ihnen, wie Sie zwei Variablen definieren, `VAR1` und`VAR2`, in einem `Inputs` Abschnitt. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: "My variable 1" - Name: VAR2 Value: "My variable 2" ``` ## Beispiel: Definieren einer Variablen mithilfe der Eigenschaft Steps Das folgende Beispiel zeigt Ihnen, wie Sie eine `DATE` Variable in dem `Steps` Abschnitt explizit definieren. ``` Actions: Build: Identifier: aws/build@v1 Configuration: Steps: - Run: DATE=$(date +%m-%d-%y) ``` ## Beispiel: Exportieren einer Variablen mithilfe der Outputs-Eigenschaft Das folgende Beispiel zeigt Ihnen, wie Sie zwei Variablen definieren `REPOSITORY-URI` und `TIMESTAMP` diese mithilfe des `Outputs` Abschnitts exportieren. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: REPOSITORY-URI Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - REPOSITORY-URI - TIMESTAMP ``` ## Beispiel: Verweisen auf eine Variable, die in derselben Aktion definiert wurde Das folgende Beispiel zeigt Ihnen`MyBuildAction`, wie Sie eine `VAR1` Variable in angeben und dann in derselben Aktion darauf verweisen, indem Sie`$VAR1`. ``` Actions: MyBuildAction: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: my-value Configuration: Steps: - Run: $VAR1 ``` ## Beispiel: Verweisen auf eine Variable, die in einer anderen Aktion definiert wurde Das folgende Beispiel zeigt, wie Sie eine `TIMESTAMP` Variable in angeben`BuildActionA`, sie mithilfe der `Outputs` Eigenschaft exportieren und dann in `BuildActionB` using `${BuildActionA.TIMESTAMP}` darauf verweisen. ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - TIMESTAMP BuildActionB: Identifier: aws/build@v1 Configuration: Steps: - Run: docker build -t my-ecr-repo/image-repo:latest . - Run: docker tag my-ecr-repo/image-repo:${BuildActionA.TIMESTAMP} # Specifying just '$TIMESTAMP' here will not work # because TIMESTAMP is not a variable # in the BuildActionB action. ``` ## Beispiel: Verweisen auf ein Geheimnis Das folgende Beispiel zeigt Ihnen, wie Sie auf ein `my-password` Geheimnis verweisen. Das `my-password` ist der Schlüssel des Geheimnisses. Der Schlüssel dieses Geheimnisses und der entsprechende Kennwortwert müssen auf der Seite **Geheimnisse** der CodeCatalyst Konsole angegeben werden, bevor sie in der Workflow-Definitionsdatei verwendet werden können. Weitere Informationen finden Sie unter [Daten mithilfe von Geheimnissen maskieren](workflows-secrets.md). ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: curl -u LiJuan:${Secrets.my-password} https://example.com ``` # Definition einer Variablen Sie können Variablen auf zwei Arten definieren: + Im `Inputs` Abschnitt einer Workflow-Aktion — siehe [So definieren Sie eine Variable im Abschnitt „Eingaben“](#workflows-to-define-variable-input) + Im `Steps` Abschnitt einer Workflow-Aktion — siehe [So definieren Sie eine Variable im Abschnitt „Schritte“](#workflows-to-define-variable-steps) **Anmerkung** Die `Steps` Methode funktioniert nur mit den Aktionen CodeCatalyst Build, Test und **GitHub Actions**, da dies die einzigen Aktionen sind, die einen `Steps` Abschnitt enthalten. Beispiele finden Sie unter [Beispiele für Variablen](workflows-working-with-variables-ex.md). Weitere Hinweise zu Variablen finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md). ------ #### [ Visual ] **So definieren Sie eine Variable im Abschnitt „Eingaben“ (visueller 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 **Visual**. 1. Wählen Sie im Workflow-Diagramm die Aktion aus, für die Sie die Variable setzen möchten. 1. Wählen Sie **Eingaben**. 1. Wählen Sie unter **Variablen — optional** die Option **Variable hinzufügen** aus, und gehen Sie dann wie folgt vor: Geben Sie eine Sequenz von name/value Paaren an, die die Eingabevariablen definieren, die Sie für die Aktion verfügbar machen möchten. Variablennamen sind auf alphanumerische Zeichen (a-z, A-Z, 0-9), Bindestriche (-) und Unterstriche (\$1) beschränkt. Leerzeichen sind nicht erlaubt. Sie können keine Anführungszeichen verwenden, um Sonderzeichen und Leerzeichen in Variablennamen zuzulassen. Weitere Informationen zu Variablen, einschließlich Beispielen, finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.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**. ------ #### [ YAML ] **Um eine Variable im Abschnitt „Eingaben“ zu definieren (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 Workflow-Aktion Code hinzu, der dem folgenden ähnelt: ``` action-name: Inputs: Variables: - Name: variable-name Value: variable-value ``` Weitere Beispiele finden Sie unter [Beispiele für Variablen](workflows-working-with-variables-ex.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**. ------ ------ #### [ Visual ] **Um eine Variable im Abschnitt „Schritte“ zu definieren (visueller 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 **Visual**. 1. Wählen Sie im Workflow-Diagramm die Aktion aus, für die Sie die Variable setzen möchten. 1. Wählen Sie **Konfiguration**. 1. Definieren Sie in **Shell-Befehlen** oder **GitHubActions YAML**, je nachdem, was verfügbar ist, eine Variable in den Aktionen`Steps`, entweder explizit oder implizit. + Um die Variable explizit zu definieren, fügen Sie sie in einen Bash-Befehl direkt in den Abschnitt ein. `Steps` + Um eine Variable implizit zu definieren, geben Sie sie in einer Datei an, auf die im Abschnitt der Aktion verwiesen wird. `Steps` Beispiele finden Sie unter [Beispiele für Variablen](workflows-working-with-variables-ex.md). Weitere Informationen finden Sie unter [YAML-Workflow-Definition](workflow-reference.md) Für die 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**. ------ #### [ YAML ] **Um eine Variable im Abschnitt „Schritte“ zu definieren (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. Definieren Sie in einer Workflow-Aktion eine Variable im `Steps` Abschnitt der Aktion, entweder explizit oder implizit. + Um die Variable explizit zu definieren, fügen Sie sie in einen Bash-Befehl direkt in den `Steps` Abschnitt ein. + Um eine Variable implizit zu definieren, geben Sie sie in einer Datei an, auf die im Abschnitt der Aktion verwiesen wird. `Steps` Beispiele finden Sie unter [Beispiele für Variablen](workflows-working-with-variables-ex.md). Weitere Informationen finden Sie unter [YAML-Workflow-Definition](workflow-reference.md) Für die 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**. ------ # Ein Geheimnis definieren Sie definieren ein Geheimnis auf der Seite **Secrets** der CodeCatalyst Konsole. Weitere Informationen finden Sie unter [Daten mithilfe von Geheimnissen maskieren](workflows-secrets.md). Sie könnten beispielsweise ein Geheimnis definieren, das wie folgt aussieht: + Name (Schlüssel): **my-password** + Wert: **^\$1H3\$1\$1b9** Nachdem das Geheimnis definiert wurde, können Sie den Schlüssel (**my-password**) des Geheimnisses in der Workflow-Definitionsdatei angeben. Ein Beispiel für diese Vorgehensweise finden Sie unter [Beispiel: Verweisen auf ein Geheimnis](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret). # Eine Variable exportieren, damit sie von anderen Aktionen verwendet werden kann Verwenden Sie die folgenden Anweisungen, um eine Variable aus einer Aktion zu exportieren, sodass Sie in anderen Aktionen darauf verweisen können. Bevor Sie eine Variable exportieren, beachten Sie Folgendes: + Wenn Sie nur innerhalb der Aktion, in der sie definiert ist, auf die Variable verweisen müssen, müssen Sie sie nicht exportieren. + Nicht alle Aktionen unterstützen den Export von Variablen. Um festzustellen, ob Ihre Aktion diese Funktion unterstützt, führen Sie die folgenden Anweisungen für den visuellen Editor durch und prüfen Sie, ob die Aktion auf der Registerkarte **Ausgaben** eine Schaltfläche „**Variablen**“ enthält. Falls ja, wird der Export von Variablen unterstützt. + Informationen zum Exportieren einer Variablen aus einer GitHub Aktion finden Sie unter[GitHub Ausgabeparameter exportieren](integrations-github-action-export.md). Weitere Hinweise zu Variablen finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md). **Voraussetzung** Stellen Sie sicher, dass Sie die Variable definiert haben, die Sie exportieren möchten. Weitere Informationen finden Sie unter [Definition einer Variablen](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] **Um eine Variable zu exportieren (visueller 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 **Visual**. 1. Wählen Sie im Workflow-Diagramm die Aktion aus, aus der Sie die Variable exportieren möchten. 1. Wählen Sie **Ausgaben** aus. 1. Wählen Sie unter **Variablen — optional** die Option **Variable hinzufügen** aus, und gehen Sie dann wie folgt vor: Geben Sie den Namen einer Variablen an, die die Aktion exportieren soll. Diese Variable muss bereits im `Steps` Abschnitt `Inputs` oder derselben Aktion definiert sein. 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 eine Variable zu exportieren (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 der Aktion, aus der Sie die Variable exportieren möchten, Code hinzu, der dem folgenden ähnelt: ``` action-name: Outputs: Variables: - Name: variable-name ``` Weitere Beispiele finden Sie unter [Beispiele für Variablen](workflows-working-with-variables-ex.md). 1. (Optional) Wählen Sie **Validieren** aus, 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**. ------ # Verweisen auf eine Variable in der Aktion, die sie definiert Verwenden Sie die folgenden Anweisungen, um in der Aktion, die sie definiert, auf eine Variable zu verweisen. **Anmerkung** Informationen zum Verweisen auf eine durch eine GitHub Aktion generierte Variable finden Sie unter[Referenzieren von GitHub Ausgabeparametern](integrations-github-action-referencing.md). Weitere Hinweise zu Variablen finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md). **Voraussetzung** Vergewissern Sie sich, dass Sie die Variable definiert haben, auf die Sie verweisen möchten. Weitere Informationen finden Sie unter [Definition einer Variablen](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] *Nicht verfügbar. Wählen Sie YAML, um die YAML-Anweisungen anzuzeigen.* ------ #### [ YAML ] **Um in der Aktion, die sie definiert, auf eine Variable zu verweisen** 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 der CodeCatalyst Aktion, die die Variable definiert, auf die Sie verweisen möchten, die Variable mit der folgenden Bash-Syntax hinzu: ``` $variable-name ``` Beispiel: ``` MyAction: Configuration: Steps: - Run: $variable-name ``` Weitere Beispiele finden Sie unter [Beispiele für Variablen](workflows-working-with-variables-ex.md). Weitere Informationen finden Sie in den Referenzinformationen für Ihre Aktion im[YAML-Workflow-Definition](workflow-reference.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** aus. ------ # Referenzieren einer Variablenausgabe durch eine andere Aktion Verwenden Sie die folgenden Anweisungen, um auf Variablen zu verweisen, die von anderen Aktionen ausgegeben wurden. **Anmerkung** Informationen zum Verweisen auf eine Variablenausgabe aus einer GitHub Aktion finden Sie unter[Referenzieren von GitHub Ausgabeparametern](integrations-github-action-referencing.md). Weitere Hinweise zu Variablen finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md). **Voraussetzung** Stellen Sie sicher, dass Sie die Variable exportiert haben, auf die Sie verweisen möchten. Weitere Informationen finden Sie unter [Eine Variable exportieren, damit sie von anderen Aktionen verwendet werden kann](workflows-working-with-variables-export-input.md). ------ #### [ Visual ] *Nicht verfügbar. Wählen Sie YAML, um die YAML-Anweisungen anzuzeigen.* ------ #### [ YAML ] **Um auf eine Variable zu verweisen, die von einer anderen Aktion ausgegeben wurde (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 der CodeCatalyst Aktion mithilfe der folgenden Syntax einen Verweis auf die Variable hinzu: ``` ${action-group-name.action-name.variable-name} ``` Ersetzen Sie: + *action-group-name*mit dem Namen der Aktionsgruppe, die die Aktion enthält, die eine Variable ausgibt. **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*mit dem Namen der Aktion, die die Variable ausgibt. + *variable-name*mit dem Namen der Variablen. Beispiel: ``` MySecondAction: Configuration: Steps: - Run: ${MyFirstAction.TIMESTAMP} ``` Weitere Beispiele finden Sie unter [Beispiele für Variablen](workflows-working-with-variables-ex.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. ------ # Auf ein Geheimnis verweisen Anweisungen zum Verweisen auf ein Geheimnis in der Workflow-Definitionsdatei finden Sie unter. [Verwenden eines Secrets](workflows-secrets.using.md) Ein Beispiel finden Sie unter [Beispiel: Verweisen auf ein Geheimnis](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret). # 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)