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.

# Tutorial: Variablen auf Pipeline-Ebene verwenden
<a name="tutorials-pipeline-variables"></a>

In diesem Tutorial erstellen Sie eine Pipeline, in der Sie eine Variable auf Pipeline-Ebene hinzufügen und eine CodeBuild Build-Aktion ausführen, die Ihren Variablenwert ausgibt.

**Wichtig**  
Im Rahmen der Erstellung einer Pipeline wird ein vom Kunden bereitgestellter S3-Artefakt-Bucket von CodePipeline for Artifacts verwendet. (Dies unterscheidet sich von dem Bucket, der für eine S3-Quellaktion verwendet wird.) Wenn sich der S3-Artefakt-Bucket in einem anderen Konto als dem Konto für Ihre Pipeline befindet, stellen Sie sicher, dass der S3-Artefakt-Bucket dem Konto gehört AWS-Konten , das sicher und zuverlässig ist.

**Topics**
+ [Voraussetzungen](#tutorials-pipeline-variables-prereq)
+ [Schritt 1: Erstellen Sie Ihre Pipeline und erstellen Sie ein Projekt](#tutorials-pipeline-variables-pipeline)
+ [Schritt 2: Änderungen veröffentlichen und Protokolle anzeigen](#tutorials-pipeline-variables-view)

## Voraussetzungen
<a name="tutorials-pipeline-variables-prereq"></a>

Sie benötigen Folgendes, um starten zu können:
+ Erstellen Sie ein Repository CodeCommit .
+ Fügen Sie dem Repository eine TXT-Datei hinzu.

## Schritt 1: Erstellen Sie Ihre Pipeline und erstellen Sie ein Projekt
<a name="tutorials-pipeline-variables-pipeline"></a>

In diesem Abschnitt erstellen Sie eine Pipeline mit den folgenden Aktionen:
+ Eine Quellphase mit einer Verbindung zu deinem CodeCommit Repository.
+ Eine Build-Phase mit einer AWS CodeBuild Build-Aktion.

**So erstellen Sie mit dem Assistenten eine Pipeline**

1. Melden Sie sich bei der CodePipeline Konsole unter an [ https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

1. Wählen Sie auf der Seite **Welcome (Willkommen)** die Option **Getting started (Erste Schritte)** oder auf der Seite **Pipelines** die Option **Create pipeline (Pipeline erstellen)**.

1. Wählen Sie auf der ** Seite ** Schritt 1: Erstellungsoption auswählen unter ** Erstellungsoptionen ** die ** Option Benutzerdefinierte Pipeline ** erstellen aus. Wählen Sie **Weiter** aus.

1. Geben Sie auf ** Schritt 2: Wählen Sie die Pipeline-Einstellungen aus ** und geben Sie im Feld ** Pipeline-Name ** den Wert ein**MyVariablesPipeline**.

1. Behalten Sie unter ** Pipeline-Typ ** die Standardauswahl bei ** V2**. Die Pipeline-Typen unterscheiden sich in ihren Eigenschaften und ihrem Preis. Weitere Informationen finden Sie unter [Pipeline-Typen](pipeline-types.md).

1. Wählen Sie unter **Service role (Servicerolle)** die Option **New service role (Neue Servicerolle)**.
**Anmerkung**  
Wenn Sie stattdessen Ihre bestehende CodePipeline Servicerolle verwenden möchten, stellen Sie sicher, dass Sie die `codeconnections:UseConnection` IAM-Berechtigung zu Ihrer Servicerollenrichtlinie hinzugefügt haben. Anweisungen für die CodePipeline Servicerolle finden [ Sie unter Hinzufügen von Berechtigungen zur CodePipeline Servicerolle](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).

1. Wählen Sie unter ** Variablen ** die Option Variable ** hinzufügen aus**. Geben Sie unter **Name** `timeout` ein. Geben Sie im Feld ** Standard ** den Wert 1000 ein. Geben Sie im Feld Beschreibung die folgende Beschreibung ein:**Timeout**.

   Dadurch wird eine Variable erstellt, in der Sie den Wert deklarieren können, wenn die Pipeline-Ausführung beginnt. Variablennamen müssen übereinstimmen `[A-Za-z0-9@\-_]+` und können alles außer einer leeren Zeichenfolge sein.

1. Lassen Sie die Standardwerte bei **Erweiterte Einstellungen** unverändert. Wählen Sie unter **Artifact store (Artefaktspeicher)** die Option **Default location (Standardstandort)** aus, um den Standard-Artefakt-Speicherort für die Pipeline in der entsprechenden Region zu verwenden, beispielsweise mit dem Amazon S3-Artefakt-Bucket als Standard.
**Anmerkung**  
Dabei handelt es sich nicht um den Quell-Bucket für Ihren Quellcode, sondern um den Artefaktspeicher für Ihre Pipeline. Für jede Pipeline benötigen Sie einen separaten Artefaktspeicher, z. B. einen S3 Bucket.

   Wählen Sie **Next (Weiter)**.

1. Fügen Sie auf der ** Seite ** Schritt 3: Quellstufe hinzufügen eine Quellstufe hinzu:

   1. Wählen Sie unter **Source provider (Quell-Anbieter)** die Option **AWS CodeCommit**.

   1. Wählen Sie unter ** Repository-Name ** und ** ** Branch-Name Ihr Repository und Ihren Branch aus.

   Wählen Sie **Weiter** aus.

1. Fügen Sie in ** Schritt 4: Build-Phase ** hinzufügen eine Build-Phase hinzu:

   1. Wählen Sie unter **Build provider (Build-Anbieter)** die Option **AWS CodeBuild** aus. Belassen Sie unter **Region** als Standardeinstellung die Pipeline-Region.

   1. Wählen Sie **Create project** (Projekt erstellen) aus.

   1. Geben Sie unter **Project name (Projektname)** einen Namen für dieses Build-Projekt ein.

   1. Wählen Sie für **Environment image (Umgebungs-Image)** die Option **Managed image (Verwaltetes Image)** aus. Wählen Sie für **Operating system (Betriebssystem)** die Option **Ubuntu** aus.

   1. Wählen Sie unter **Runtime (Laufzeit)** die Option **Standard** aus. Wählen Sie für ** Image ** die Option ** aws/codebuild /standard:5.0**.

   1. Wählen Sie unter **Service role (Servicerolle)** die Option **New service role (Neue Servicerolle)** aus.
**Anmerkung**  
Notieren Sie sich den Namen Ihrer Servicerolle CodeBuild . Für den letzten Schritt in diesem Tutorial benötigen Sie den Rollennamen.

   1. Wählen Sie unter **BuildSpec** bei **Build specifications (Build-Spezifikationen)** die Option **Insert build commands (Build-Befehle einfügen)** aus. Wählen Sie Zum Editor ** ** wechseln und fügen Sie Folgendes unter Befehle ** erstellen ein**. In der Buildspec `$CUSTOM_VAR1` wird die Kundenvariable verwendet, um die Pipeline-Variable im Build-Log auszugeben. Im folgenden Schritt erstellen Sie die `$CUSTOM_VAR1` Ausgabevariable als Umgebungsvariable.

      ```
      version: 0.2
      #env:
        #variables:
           # key: "value"
           # key: "value"
        #parameter-store:
           # key: "value"
           # key: "value"
        #git-credential-helper: yes
      phases:
        install:
          #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
          #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
          runtime-versions:
            nodejs: 12
          #commands:
            # - command
            # - command
        #pre_build:
          #commands:
            # - command
            # - command
        build:
          commands:
            - echo $CUSTOM_VAR1
        #post_build:
          #commands:
            # - command
            # - command
      artifacts:
        files:
           - '*'
          # - location
        name: $(date +%Y-%m-%d)
        #discard-paths: yes
        #base-directory: location
      #cache:
        #paths:
          # - paths
      ```

   1. Wählen Sie ** Weiter zu CodePipeline**. Dies kehrt zur CodePipeline Konsole zurück und erstellt ein CodeBuild Projekt, das Ihre Build-Befehle für die Konfiguration verwendet. Das Build-Projekt verwendet eine Servicerolle zur Verwaltung von AWS-Service Berechtigungen. Dieser Vorgang kann einige Minuten dauern.

   1. Wählen Sie unter ** Umgebungsvariablen * — optional die Option Umgebungsvariable* ** hinzufügen aus **, um eine Umgebungsvariable als Eingabevariable für die Build-Aktion zu erstellen, die durch die Variable auf Pipeline-Ebene aufgelöst wird.** Dadurch wird die in der Buildspec als angegebene Variable erstellt. `$CUSTOM_VAR1` Geben Sie unter **Name** `CUSTOM_VAR1` ein. Geben Sie unter **Value (Wert)** `#{variables.timeout}` ein. Wählen Sie unter ** Typ ** die Option. `Plaintext`

      Der `#{variables.timeout}` Wert für die Umgebungsvariable basiert auf dem Variablennamespace auf Pipeline-Ebene `variables` und der Variablen auf Pipeline-Ebene, die in Schritt 7 für die Pipeline `timeout` erstellt wurde.

   1. Wählen Sie **Weiter** aus.

1. Wählen Sie in ** Schritt 5: Testphase hinzufügen die Option Testphase ** überspringen aus**, und akzeptieren Sie dann die Warnmeldung**, indem Sie erneut Überspringen auswählen. ** ** 

   Wählen Sie **Weiter** aus.

1. Wählen Sie auf der ** Seite ** Schritt 6: Bereitstellungsphase hinzufügen die Option Bereitstellungsphase ** überspringen aus**, und akzeptieren Sie dann die Warnmeldung, indem Sie ** erneut auf ** Überspringen klicken. Wählen Sie **Weiter** aus.

1. Wählen ** Sie auf Schritt 7: Überprüfen ** die Option Pipeline ** erstellen aus**.

## Schritt 2: Änderungen veröffentlichen und Protokolle anzeigen
<a name="tutorials-pipeline-variables-view"></a>

1. Nachdem die Pipeline erfolgreich ausgeführt wurde, wählen Sie in Ihrer erfolgreichen Build-Phase die Option Details ** anzeigen aus**.

   Wählen Sie auf der Detailseite den ** Tab ** Logs. Sehen Sie sich die CodeBuild Build-Ausgabe an. Die Befehle geben den Wert der eingegebenen Variablen aus.

1. Wählen Sie im linken Navigationsbereich ** Historie ** aus.

   Wählen Sie die letzte Ausführung aus und wählen Sie dann den ** Tab ** Variablen. Sehen Sie sich den aufgelösten Wert für die Pipeline-Variable an.