Tutorial: Variablen auf Pipeline-Ebene verwenden

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.

Voraussetzungen

Sie benötigen Folgendes, um starten zu können:

• Erstellen Sie ein CodeCommit Repository.

• Fügen Sie dem Repository eine .txt-Datei hinzu.

Schritt 1: Erstellen Sie Ihre Pipeline und erstellen Sie ein Projekt

In diesem Abschnitt erstellen Sie eine Pipeline mit den folgenden Aktionen:

• Eine Quellphase mit einer Verbindung zu Ihrem CodeCommit Repository.

• Eine Build-Phase mit einer AWS CodeBuild Build-Aktion.

So erstellen Sie mit dem Assistenten eine Pipeline

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

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

3. Geben Sie unter Step 1: Choose pipeline settings (Schritt 1: Auswahl der Pipeline-Einstellungen) unter Pipeline name (Pipeline-Name) MyVariablesPipeline ein.

4. Behalten Sie unter Pipeline-Typ die Standardauswahl V2 bei. Pipeline-Typen unterscheiden sich in ihren Eigenschaften und im Preis. Weitere Informationen finden Sie unter Pipeline-Typen.

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

6. Wählen Sie unter Variablen die Option Variable hinzufügen aus. Geben Sie unter Name timeout ein. Geben Sie als Standard 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.

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

8. Fügen Sie auf der Seite Step 2: Add source stage (Schritt 2: Quell-Stufe hinzufügen) eine Quellphase hinzu:

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

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

   Wählen Sie Weiter aus.

9. Fügen Sie unter Add build stage (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.

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

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

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

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

   6. Wählen Sie unter Service role (Servicerolle) die Option New service role (Neue Servicerolle) aus.

      Anmerkung

      Notieren Sie sich den Namen Ihrer CodeBuild Servicerolle. Sie benötigen den Rollennamen für den letzten Schritt in diesem Tutorial.

   7. 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 Build-Befehle 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

   8. Wählen Sie Weiter zu CodePipeline. Dadurch kehren Sie zur CodePipeline Konsole zurück und erstellen 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.

   9. 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 angegebene Variable als 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 Pipelineebene variables und der Variablen auf Pipelineebene, die in Schritt 5 für die Pipeline timeout erstellt wurde.

   10. Wählen Sie Weiter aus.

10. Wählen Sie auf der Seite Step 4: Add deploy stage (Schritt 4: Bereitstellungsstufe hinzufügen) die Option Skip deploy stage (Bereitstellungsstufe überspringen) aus und akzeptieren Sie anschließend die Warnmeldung, indem Sie erneut Skip (Überspringen) auswählen. Wählen Sie Weiter aus.

11. Wählen Sie unter Step 5: Review (Schritt 5: Überprüfen) die Option Create pipeline (Pipeline erstellen) aus.

Schritt 2: Änderungen veröffentlichen und Protokolle anzeigen

1. Nachdem die Pipeline erfolgreich ausgeführt wurde, wählen Sie in der erfolgreichen Buildphase die Option Details anzeigen aus.

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

2. Wählen Sie in der linken Navigationsleiste Historie aus.

   Wählen Sie die letzte Ausführung und dann die Registerkarte Variablen aus. Zeigen Sie den aufgelösten Wert für die Pipeline-Variable an.