Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# 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 à cette personne sûre et Comptes AWS qu'elle sera fiable.
**Topics**
+ [Conditions préalables](#tutorials-AppConfig-prereq)
+ [Étape 1 : Créez vos AWS AppConfig ressources](#tutorials-AppConfig-application)
+ [Étape 2 : télécharger des fichiers dans votre compartiment source S3](#tutorials-AppConfig-bucket)
+ [Étape 3 : Créer votre pipeline](#tutorials-AppConfig-pipeline)
+ [Étape 4 : apporter une modification à n'importe quel fichier source et vérifier le déploiement](#tutorials-AppConfig-verify)
## Conditions préalables
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](tutorials-simple-s3.md#s3-create-s3-bucket) 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.
1. Suivez les étapes décrites dans les rubriques suivantes pour créer vos ressources dans AWS AppConfig.
+ [Créez une application](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-application.html).
+ [Créez un environnement](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-environment.html).
+ [Créez un profil AWS CodePipeline de configuration](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-configuration-and-profile.html).
+ (Facultatif) [Choisissez une stratégie de déploiement prédéfinie ou créez la vôtre](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-deployment-strategy.html).
## É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!
```
1. 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
```
1. 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](https://console.aws.amazon.com/codesuite/codepipeline/home).
1. Sur la page **Bienvenue**, la page **Démarrez** ou la page **Pipelines**, choisissez **Créer un pipeline**.
1. Sur la page **Étape 1 : Choisir une option de création**, sous **Options de création**, choisissez l'option **Créer un pipeline personnalisé**. Choisissez **Suivant**.
1. À **l'étape 2 : Choisissez les paramètres du pipeline**, dans **Nom du pipeline**, entrez**MyAppConfigPipeline**.
1. CodePipeline fournit des pipelines de type V1 et V2, dont les caractéristiques et le prix diffèrent. Le type V2 est le seul type que vous pouvez choisir dans la console. Pour plus d'informations, consultez la section [Types de pipelines](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Pour plus d'informations sur la tarification CodePipeline, consultez la section [Tarification](https://aws.amazon.com/codepipeline/pricing/).
1. Dans **Rôle de service**, choisissez **Nouveau rôle de service** pour autoriser CodePipeline la création d'un rôle de service dans IAM.
1. Laissez les paramètres sous **Advanced settings (Paramètres avancés)** à leurs valeurs par défaut, puis choisissez **Suivant**.
1. À **l'étape 3 : Ajouter une étape source**, dans **Source provider**, 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**.
1. À **l'étape 4 : Ajouter une phase de construction**, choisissez **Ignorer l'étape** de génération, puis acceptez le message d'avertissement en choisissant à nouveau **Ignorer**.
Choisissez **Suivant**.
1. À **l'étape 5 : Ajouter une phase de test**, choisissez **Ignorer l'étape de test**, puis acceptez le message d'avertissement en choisissant à nouveau **Ignorer**.
Choisissez **Suivant**.
1. À **l'étape 6 : Ajouter une phase de déploiement** :
1. Dans **Deploy provider**, sélectionnez **AWS AppConfig**.
1. 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.
1. Dans **Environnement**, choisissez le nom de l'environnement dans lequel vous l'avez créé AWS AppConfig. Le champ indique l'identifiant de votre environnement.
1. 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.
1. 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.
1. 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`.
1. Choisissez **Suivant**.
1. À **l'étape 7 : Passez** en revue, passez en revue les informations, puis choisissez **Créer un 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.