Tutorial: Eine Pipeline erstellen, die AWS AppConfig als Bereitstellungsanbieter verwendet wird

In diesem Tutorial konfigurieren Sie eine Pipeline, die kontinuierlich Konfigurationsdateien bereitstellt und in Ihrer Bereitstellungsphase AWS AppConfig als Bereitstellungsaktionsanbieter dient.

Voraussetzungen

Bevor Sie beginnen, müssen Sie die folgenden Schritte ausführen:

• In diesem Beispiel wird eine S3-Quelle für Ihre Pipeline verwendet. Erstellen oder verwenden Sie einen Amazon S3 S3-Bucket mit aktivierter Versionierung. Sie können den Anweisungen unter Schritt 1: Erstellen eines S3-Buckets für Ihre Anwendung folgen, um einen S3-Bucket zu erstellen.

Schritt 1: Erstellen Sie Ihre Ressourcen AWS AppConfig

In diesem Abschnitt erstellen Sie die folgenden Ressourcen:

• Eine Anwendung AWS AppConfig ist eine logische Codeeinheit, die Ihren Kunden Funktionen zur Verfügung stellt.

• Eine Umgebung in AWS AppConfig ist eine logische Bereitstellungsgruppe von AppConfig Zielen, z. B. Anwendungen in einer Beta- oder Produktionsumgebung.

• Ein Konfigurationsprofil ist eine Sammlung von Einstellungen, die das Verhalten Ihrer Anwendung beeinflussen. Das Konfigurationsprofil ermöglicht AWS AppConfig den Zugriff auf Ihre Konfiguration an ihrem gespeicherten Speicherort.

• (Optional) Eine Bereitstellungsstrategie AWS AppConfig definiert das Verhalten einer Konfigurationsbereitstellung, z. B. wie viel Prozent der Clients die neu bereitgestellte Konfiguration zu einem bestimmten Zeitpunkt während einer Bereitstellung erhalten sollen.

Um eine Anwendung, eine Umgebung, ein Konfigurationsprofil und eine Bereitstellungsstrategie zu erstellen

1. Melden Sie sich bei der an AWS Management Console.

2. Verwenden Sie die Schritte in den folgenden Themen, um Ihre Ressourcen in zu erstellen AWS AppConfig.

   • Erstellen Sie eine Anwendung.

   • Erstellen Sie eine Umgebung.

   • Erstellen Sie ein AWS CodePipeline Konfigurationsprofil.

   • (Optional) Wählen Sie eine vordefinierte Bereitstellungsstrategie oder erstellen Sie Ihre eigene.

Schritt 2: Laden Sie Dateien in Ihren S3-Quell-Bucket hoch

Erstellen Sie in diesem Abschnitt Ihre Konfigurationsdatei (en). Dann komprimieren Sie Ihre Quelldateien und übertragen Sie sie in den Bucket, den die Pipeline für Ihre Quellphase verwendet.

Um Konfigurationsdateien zu erstellen

1. Erstellen Sie eine configuration.json Datei für jede Konfiguration in jeder Region. Fügen Sie den folgenden Inhalt hinzu:

   Hello World!

2. Gehen Sie wie folgt vor, um Ihre Konfigurationsdateien zu komprimieren und hochzuladen.

Um Quelldateien zu komprimieren und hochzuladen

1. Erstellen Sie eine .zip-Datei mit Ihren Dateien und geben Sie der ZIP-Datei einen Namen. configuration-files.zip Beispielsweise kann Ihre ZIP-Datei die folgende Struktur haben:

   .
   └── appconfig-configurations
       └── MyConfigurations
           ├── us-east-1
           │   └── configuration.json
           └── us-west-2
               └── configuration.json

2. Wählen Sie in der Amazon S3 S3-Konsole für Ihren Bucket Upload und folgen Sie den Anweisungen, um Ihre ZIP-Datei hochzuladen.

Schritt 3: Erstellen Ihrer Pipeline

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

• Eine Quellstufe mit einer Amazon S3 S3-Aktion, bei der die Quellartefakte die Dateien für Ihre Konfiguration sind.

• Eine Bereitstellungsphase mit einer AppConfig Bereitstellungsaktion.

So erstellen Sie mit dem Assistenten eine Pipeline

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

4. Wählen Sie im Feld Pipeline-Typ die Option V1 für die Zwecke dieses Tutorials aus. Sie können auch V2 wählen. Beachten Sie jedoch, dass sich die Pipeline-Typen in ihren Eigenschaften und im Preis unterscheiden. Weitere Informationen finden Sie unter Pipeline-Typen.

5. Wählen Sie unter Servicerolle die Option Neue Servicerolle aus, um CodePipeline die Erstellung einer Servicerolle in IAM zu ermöglichen.

6. Belassen Sie die Einstellungen unter Erweiterte Einstellungen bei den Standardeinstellungen, und wählen Sie dann Next (Weiter) aus.

7. Wählen Sie in Step 2: Add source stage (Schritt 2: Quellstufe hinzufügen) unter Source provider (Quellanbieter) die Option Amazon S3. Wählen Sie in Bucket den Namen Ihres S3-Quell-Buckets aus.

   Geben Sie im Feld S3-Objektschlüssel den Namen Ihrer .zip-Datei ein:configuration-files.zip.

   Wählen Sie Weiter aus.

8. Wählen Sie unter Step 3: Add build stage (Schritt 3: Build-Stufe hinzufügen) die Option Skip build stage (Build-Stufe überspringen) und akzeptieren Sie die Warnmeldung, indem Sie erneut auf Skip (Überspringen) klicken.

   Wählen Sie Weiter aus.

9. Unter Step 4: Add deploy stage (Schritt 4: Bereitstellungsstufe hinzufügen):

   1. Wählen Sie unter Deploy provider (Bereitstellungsanbieter) die Option AWS AppConfig aus.

   2. Wählen Sie unter Anwendung den Namen der Anwendung aus, in AWS AppConfig der Sie sie erstellt haben. Das Feld zeigt die ID für Ihre Anwendung.

   3. Wählen Sie unter Umgebung den Namen der Umgebung aus, in der Sie erstellt haben AWS AppConfig. Das Feld zeigt die ID für Ihre Umgebung.

   4. Wählen Sie unter Konfigurationsprofil den Namen des Konfigurationsprofils aus, in dem Sie es erstellt haben AWS AppConfig. Das Feld zeigt die ID für Ihr Konfigurationsprofil.

   5. Wählen Sie unter Bereitstellungsstrategie den Namen Ihrer Bereitstellungsstrategie aus. Dabei kann es sich entweder um eine Bereitstellungsstrategie handeln, die Sie in erstellt haben, AppConfig oder um eine, die Sie unter vordefinierten Bereitstellungsstrategien ausgewählt haben AppConfig. Das Feld zeigt die ID für Ihre Bereitstellungsstrategie.

   6. Geben Sie im Feld Konfigurationspfad für das Eingabeartefakt den Dateipfad ein. Stellen Sie sicher, dass Ihr Konfigurationspfad für das Eingabeartefakt mit der Verzeichnisstruktur in Ihrer S3-Bucket-ZIP-Datei übereinstimmt. Geben Sie für dieses Beispiel den folgenden Dateipfad ein:. appconfig-configurations/MyConfigurations/us-west-2/configuration.json

   7. Wählen Sie Weiter aus.

10. Prüfen Sie in Step 5: Review die Informationen und wählen Sie dann Create pipeline aus.

Schritt 4: Nehmen Sie eine Änderung an einer beliebigen Quelldatei vor und überprüfen Sie die Bereitstellung

Nehmen Sie eine Änderung an Ihren Quelldateien vor und laden Sie die Änderung in Ihren Bucket hoch. Damit wird die Ausführung Ihrer Pipeline ausgelöst. Überprüfen Sie anhand der Version, ob Ihre Konfiguration verfügbar ist.