Tutoriel : Création d'un pipeline utilisé AWS AppConfig comme fournisseur de déploiement

Dans ce didacticiel, vous allez configurer un pipeline qui fournit en continu des fichiers de configuration en AWS AppConfig tant que fournisseur d'actions de déploiement dans votre phase de déploiement.

Important

Dans le cadre de la création d'un pipeline, un compartiment d'artefacts S3 fourni par le client sera utilisé CodePipeline pour les artefacts. (Ceci est différent du compartiment utilisé pour une action source S3.) Si le compartiment d'artefacts S3 se trouve dans un compte différent de celui de votre pipeline, assurez-vous que le compartiment d'artefacts S3 appartient Comptes AWS à une personne sûre et fiable.

Prérequis

Avant de commencer, vous devez effectuer les opérations suivantes :

• Cet exemple utilise une source S3 pour votre pipeline. Créez ou utilisez un compartiment Amazon S3 avec le contrôle de version activé. Suivez les instructions fournies dans Étape 1 : créer un compartiment source S3 pour votre application pour créer un compartiment S3.

Étape 1 : Créez vos AWS AppConfig ressources

Dans cette section, vous allez créer les ressources suivantes :

• Une application in AWS AppConfig est une unité logique de code qui fournit des fonctionnalités à vos clients.

• Un environnement dans AWS AppConfig est un groupe de déploiement logique de AppConfig cibles, telles que des applications dans un environnement bêta ou de production.

• Un profil de configuration est un ensemble de paramètres qui influencent le comportement de votre application. Le profil de configuration permet AWS AppConfig d'accéder à votre configuration dans son emplacement enregistré.

• (Facultatif) Une stratégie de déploiement AWS AppConfig définit le comportement d'un déploiement de configuration, par exemple le pourcentage de clients devant recevoir la nouvelle configuration déployée à un moment donné au cours d'un déploiement.

Pour créer une application, un environnement, un profil de configuration et une stratégie de déploiement

1. Connectez-vous au AWS Management Console.

2. Suivez les étapes décrites dans les rubriques suivantes pour créer vos ressources dans AWS AppConfig.

   • Créez une application.

   • Créez un environnement.

   • Créez un profil AWS CodePipeline de configuration.

   • (Facultatif) Choisissez une stratégie de déploiement prédéfinie ou créez la vôtre.

Étape 2 : télécharger des fichiers dans votre compartiment source S3

Dans cette section, créez votre ou vos fichiers de configuration. Ensuite, compressez et transférez vos fichiers source vers le compartiment que le pipeline utilise pour votre étape source.

Pour créer des fichiers de configuration

1. Créez un configuration.json fichier pour chaque configuration dans chaque région. Incluez le contenu suivant :

   Hello World!

2. Suivez les étapes ci-dessous pour compresser et télécharger vos fichiers de configuration.

Pour compresser et télécharger des fichiers source

1. Créez un fichier .zip avec vos fichiers et nommez-le. configuration-files.zip Par exemple, votre fichier .zip peut utiliser la structure suivante :

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

2. Dans la console Amazon S3 de votre compartiment, choisissez Upload et suivez les instructions pour télécharger votre fichier .zip.

Étape 3 : Créer votre pipeline

Dans cette section, vous créez un pipeline avec les actions suivantes :

• Un stage source avec une action Amazon S3 où les artefacts source sont les fichiers de votre configuration.

• Une phase de déploiement avec une action AppConfig de déploiement.

Pour créer un pipeline avec l'assistant

1. Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Sur la page Bienvenue, Démarrez ou Pipelines, choisissez Créer un pipeline.

3. Dans l'Étape 1 : Choisir les paramètres d'un pipeline, dans Nom du pipeline, saisissez MyAppConfigPipeline.

4. Dans Type de pipeline, choisissez V2. Pour de plus amples informations, veuillez consulter Types de canalisations. Choisissez Suivant.

5. Dans Rôle de service, choisissez Nouveau rôle de service CodePipeline pour autoriser la création d'un rôle de service dansIAM.

6. Laissez les paramètres sous Advanced settings (Paramètres avancés) à leurs valeurs par défaut, puis choisissez Suivant.

7. Dans Step 2: Add source stage (Étape 2 : Ajouter une étape source), dans Source provider (Fournisseur source), choisissez Amazon S3. Dans Bucket, choisissez le nom de votre compartiment source S3.

   Dans la clé d'objet S3, entrez le nom de votre fichier .zip :configuration-files.zip.

   Choisissez Suivant.

8. Dans Step 3: Add build stage (Étape 3 : Ajouter une étape de génération), choisissez Skip build stage (Ignorer l'étape de génération) et acceptez le message d'avertissement en choisissant à nouveau Skip (Ignorer).

   Choisissez Suivant.

9. Dans Étape 4 : Ajouter une étape de déploiement :

   1. Dans Deploy provider, sélectionnez AWS AppConfig.

   2. Dans Application, choisissez le nom de l'application dans laquelle vous l'avez créée AWS AppConfig. Le champ indique l'ID de votre candidature.

   3. Dans Environnement, choisissez le nom de l'environnement dans lequel vous l'avez créé AWS AppConfig. Le champ indique l'identifiant de votre environnement.

   4. Dans Profil de configuration, choisissez le nom du profil de configuration que vous avez créé dans AWS AppConfig. Le champ indique l'ID de votre profil de configuration.

   5. Dans Stratégie de déploiement, choisissez le nom de votre stratégie de déploiement. Il peut s'agir d'une stratégie de déploiement que vous avez créée dans AppConfig ou d'une stratégie que vous avez choisie parmi les stratégies de déploiement prédéfinies dans AppConfig. Le champ indique l'identifiant de votre stratégie de déploiement.

   6. Dans Chemin de configuration de l'artefact en entrée, entrez le chemin du fichier. Assurez-vous que le chemin de configuration de votre artefact d'entrée correspond à la structure de répertoire du fichier .zip de votre compartiment S3. Pour cet exemple, entrez le chemin de fichier suivant :appconfig-configurations/MyConfigurations/us-west-2/configuration.json.

   7. Choisissez Suivant.

10. Dans Step 5: Review, vérifiez les informations puis choisissez Create pipeline.

Étape 4 : apporter une modification à n'importe quel fichier source et vérifier le déploiement

Apportez une modification à vos fichiers source et chargez-la dans votre bucket. Cela déclenche l'exécution de votre pipeline. Vérifiez que votre configuration est disponible en consultant la version.