Arbeiten mit Variablen

So erstellen Sie eine Pipeline mit Variablen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Wählen Sie Create pipeline (Pipeline erstellen) aus. Geben Sie einen Namen für die Pipeline ein und wählen Sie anschließend Next (Weiter) aus.

3. Wählen Sie unter Quelle unter Anbieter die Option CodeCommit. Wählen Sie das CodeCommit Repository und den Branch für die Quellaktion aus, und klicken Sie dann auf Weiter.

4. Wählen Sie unter Build unter Provider die Option aus CodeBuild. Wählen Sie den Namen eines vorhandenen CodeBuild Build-Projekts oder wählen Sie Projekt erstellen aus. Erstellen Sie unter Build-Projekt erstellen ein Build-Projekt und wählen Sie dann Zurück zu CodePipeline.

   Wählen Sie in Environment variables (Umgebungsvariablen) die Option Add environment variables (Umgebungsvariablen hinzufügen) aus. Geben Sie beispielsweise die Ausführungs-ID mit der Variablensyntax #{codepipeline.PipelineExecutionId} und die Commit-ID mit der Variablensyntax ein#{SourceVariables.CommitId}.

   Anmerkung

   Sie können in jedes Aktionskonfigurationsfeld des Assistenten Variablensyntax eingeben.

5. Wählen Sie Create (Erstellen) aus.

6. Nach der Erstellung der Pipeline können Sie den Namespace anzeigen, der vom Assistenten erstellt wurde. Wählen Sie in der Pipeline das Symbol für die Phase aus, für die Sie den Namespace anzeigen möchten. In diesem Beispiel wird der automatisch generierte Namespace der Quellaktion angezeigt, SourceVariables.

   

So bearbeiten Sie den Namespace für eine vorhandene Aktion

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Wählen Sie die Pipeline aus, die Sie bearbeiten möchten, und anschließend Edit (Bearbeiten). Wählen Sie für die Quellphase Edit stage (Phase bearbeiten) aus. Fügen Sie die CodeCommit Aktion hinzu.

3. Zeigen Sie in Edit action (Aktion bearbeiten) das Feld Variable namespace (Namespace der Variable) an. Wenn die vorhandene Aktion zuvor oder ohne Verwendung des Assistenten erstellt wurde, müssen Sie einen Namespace hinzufügen. Geben Sie in Variable namespace (Namespace der Variable) einen Namespace-Namen ein. Wählen Sie anschließend Save (Speichern) aus.

So zeigen Sie Ausgabevariablen an

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Wenn die Pipeline erstellt wurde und erfolgreich ausgeführt wird, können Sie die Variablen auf der Seite Action execution details (Details der Aktionsausführung) anzeigen. Weitere Informationen finden Sie unter Anzeigen von Variablen (Konsole).

So konfigurieren Sie eine Aktion mit einem Namespace

1. Folgen Sie den Schritten unterEine Pipeline, Phasen und Aktionen erstellen, um eine Pipeline mit dem zu erstellenCLI. Starten Sie eine Eingabedatei, um den Befehl create-pipeline mit dem Parameter --cli-input-json bereitzustellen. Fügen Sie in der Pipelinestruktur den Parameter namespace hinzu und geben Sie einen Namen an, z. B. SourceVariables.

   . . . 
   {
             "inputArtifacts": [],
             "name": "Source",
             "region": "us-west-2",
             "namespace": "SourceVariables",
             "actionTypeId": {
               "category": "Source",
               "owner": "AWS",
               "version": "1",
               "provider": "CodeCommit"
             },
             "outputArtifacts": [
   
   . . . 

2. Speichern Sie die Datei mit einem Namen wie MyPipeline.json.

3. Führen Sie den Befehl an einem Terminal (Linux, macOS oder Unix) oder einer Befehlszeile (Windows) aus und erstellen Sie die Pipeline. create-pipeline

   Rufen Sie die beim Ausführen des Befehls create-pipeline erstellte Datei auf. Beispielsweise:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

So konfigurieren Sie nachgeschaltete Aktionen für den Verbrauch von Variablen

1. Bearbeiten Sie eine Eingabedatei, um dem Befehl update-pipeline den Parameter --cli-input-json bereitzustellen. Fügen Sie in der nachgeschalteten Aktion die Variable der Konfiguration für diese Aktion hinzu. Eine Variable besteht aus einem Namespace und einem Schlüssel, getrennt durch einen Punkt. Um beispielsweise Variablen für die Pipeline-Ausführungs-ID und die Quell-Commit-ID hinzuzufügen, geben Sie den Namespace codepipeline für die Variable #{codepipeline.PipelineExecutionId} an. Geben Sie den Namespace SourceVariables für die Variable #{SourceVariables.CommitId} an.

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifacts"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

2. Speichern Sie die Datei mit einem Namen wie MyPipeline.json.

3. Führen Sie den Befehl an einem Terminal (Linux, macOS oder Unix) oder einer Befehlszeile (Windows) aus und erstellen Sie die Pipeline. create-pipeline

   Rufen Sie die beim Ausführen des Befehls create-pipeline erstellte Datei auf. Beispielsweise:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

   Die Namen aller mit Ihrem AWS Konto verknüpften Pipelines werden angezeigt.

2. Wählen Sie im Feld Name den Namen der Pipeline.

3. Wählen Sie View history (Verlauf anzeigen).

4. Nach erfolgreicher Ausführung der Pipeline können Sie die von der Quellaktion erzeugten Variablen anzeigen. Wählen Sie View history (Verlauf anzeigen). Wählen Sie in der Aktionsliste für die Pipeline-Ausführung die Option Quelle aus, um die Details der Aktionsausführung für die CodeCommit Aktion anzuzeigen. Sie können die Variablen im Bildschirm „Action detail (Aktionsdetails)“ unter Output variables (Ausgabevariablen) anzeigen.

   

5. Nach erfolgreicher Ausführung der Pipeline können Sie die von der Build-Aktion erzeugten Variablen anzeigen. Wählen Sie View history (Verlauf anzeigen). Wählen Sie in der Aktionsliste für die Pipeline-Ausführung die Option Build aus, um die Details zur Aktionsausführung für die CodeBuild Aktion anzuzeigen. Sie können die Variablen auf der Seite „Action detail (Aktionsdetails)“ unter Action configuration (Aktionskonfiguration) anzeigen. Der automatisch generierte Namespace wird angezeigt.

   

   Standardmäßig wird in Action configuration (Aktionskonfiguration) die Variablensyntax angezeigt. Sie können Show resolved configuration (Aufgelöste Konfiguration anzeigen) auswählen, um zur Anzeige der Werte zu wechseln, die während der Aktionsausführung erzeugt wurden.

   

1. Verwenden Sie den folgenden Befehl:

   
   aws codepipeline list-action-executions

   Die Ausgabe zeigt den Parameter outputVariables wie hier gezeigt an.

   "outputVariables": {
                       "BranchName": "main",
                       "CommitMessage": "Updated files for test",
                       "AuthorDate": "2019-11-08T22:24:34Z",
                       "CommitId": "d99b0083cc10EXAMPLE",
                       "CommitterDate": "2019-11-08T22:24:34Z",
                       "RepositoryName": "variables-repo"
                   },
               

2. Verwenden Sie den folgenden Befehl:

   
   aws codepipeline get-pipeline --name <pipeline-name>

   In der Aktionskonfiguration für die CodeBuild Aktion können Sie die Variablen anzeigen:

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifact"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

   Die Namen aller mit Ihrem AWS Konto verknüpften Pipelines werden angezeigt. Wählen Sie die Pipeline aus, der Sie die Genehmigung hinzufügen möchten.

2. Um die Pipeline zu bearbeiten, wählen Sie Edit (Bearbeiten). Fügen Sie nach der Quellaktion eine manuelle Genehmigung hinzu. Geben Sie unter Action name (Aktionsname) den Namen der Genehmigungsaktion ein.

3. Wählen Sie unter Action provider (Aktionsanbieter) die Option Manual approval (Manuelle Genehmigung).

4. Fügen Sie URLzur Überprüfung die Variablensyntax für CommitId zu Ihrem CodeCommit URL hinzu. Stellen Sie sicher, dass Sie den Namespace verwenden, der Ihrer Quellaktion zugewiesen ist. Die Variablensyntax für eine CodeCommit Aktion mit dem Standard-Namespace SourceVariables lautet #{SourceVariables.CommitId} beispielsweise.

   Geben Sie im Feld Kommentare in CommitMessage die Commit-Nachricht ein:

   Please approve this change. Commit message: #{SourceVariables.CommitMessage}

5. Nachdem die Pipeline erfolgreich läuft, können Sie die Variablenwerte in der Genehmigungsmeldung anzeigen.

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

   Die Namen aller mit Ihrem AWS Konto verknüpften Pipelines werden angezeigt. Wählen Sie die Pipeline aus, der Sie die Genehmigung hinzufügen möchten.

2. Um die Pipeline zu bearbeiten, wählen Sie Edit (Bearbeiten). Wählen Sie auf der Phase, die Ihre CodeBuild Aktion enthält, Phase bearbeiten aus.

3. Wählen Sie das Symbol, um Ihre CodeBuild Aktion zu bearbeiten.

4. Geben Sie auf der Seite Aktion bearbeiten unter Umgebungsvariablen Folgendes ein:

   • Geben Sie im Feld Name einen Namen für Ihre Umgebungsvariable ein.

   • Geben Sie im Feld Wert die Variablensyntax für Ihre Pipeline-Ausgabevariable ein, die den Namespace enthält, der Ihrer Quellaktion zugewiesen ist. Die Syntax der Ausgabevariablen für eine GitHub Aktion mit dem Standard-Namespace SourceVariables lautet beispielsweise. #{SourceVariables.BranchName}

   • Wählen Sie unter Typ die Option Plaintext aus.

5. Nachdem die Pipeline erfolgreich ausgeführt wurde, können Sie sehen, wie die aufgelöste Ausgabevariable dem Wert in der Umgebungsvariablen entspricht. Wählen Sie eine der folgenden Optionen aus:

   • CodePipeline Konsole: Wählen Sie Ihre Pipeline und dann Verlauf aus. Wählen Sie die letzte Pipeline-Ausführung aus.

     • Wählen Sie unter Timeline den Selektor für Source aus. Dies ist die Quellaktion, die GitHub Ausgabevariablen generiert. Wählen Sie Ausführungsdetails anzeigen aus. Sehen Sie sich unter Ausgabevariablen die Liste der durch diese Aktion generierten Ausgabevariablen an.

     • Wählen Sie unter Timeline den Selektor für Build aus. Dies ist die Build-Aktion, die die CodeBuild Umgebungsvariablen für Ihr Build-Projekt angibt. Wählen Sie Ausführungsdetails anzeigen aus. Sehen Sie sich unter Aktionskonfiguration Ihre CodeBuild Umgebungsvariablen an. Wählen Sie Gelöste Konfiguration anzeigen aus. Ihr Umgebungsvariablenwert ist die aufgelöste BranchName Ausgabevariable aus der GitHub Quellaktion. In diesem Beispiel lautet der aufgelöste Wertmain.

       Weitere Informationen finden Sie unter Anzeigen von Variablen (Konsole).

   • CodeBuild Konsole: Wählen Sie Ihr Build-Projekt und wählen Sie den Link für Ihren Build-Run. Unter Umgebungsvariablen ist Ihre aufgelöste Ausgabevariable der Wert für die CodeBuild Umgebungsvariable. In diesem Beispiel ist die Umgebungsvariable Name BranchName und der Wert ist die aufgelöste BranchName Ausgabevariable aus der GitHub Quellaktion. In diesem Beispiel lautet der aufgelöste Wertmain.