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 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).