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 : Utiliser des variables au niveau du pipeline
Dans ce didacticiel, vous allez créer un pipeline dans lequel vous ajouterez une variable au niveau du pipeline et exécuterez une action de CodeBuild génération qui génère la valeur de votre variable.
**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-pipeline-variables-prereq)
+ [Étape 1 : Créez votre pipeline et créez votre projet](#tutorials-pipeline-variables-pipeline)
+ [Étape 2 : publier les modifications et consulter les journaux](#tutorials-pipeline-variables-view)
## Conditions préalables
Avant de commencer, vous devez exécuter les opérations suivantes :
+ Créez un CodeCommit référentiel.
+ Ajoutez un fichier .txt au référentiel.
## Étape 1 : Créez votre pipeline et créez votre projet
Dans cette section, vous créez un pipeline avec les actions suivantes :
+ Un stage source avec une connexion à votre CodeCommit dépôt.
+ Une phase de construction avec une action de AWS CodeBuild construction.
**Pour créer un pipeline avec l'assistant**
1. Connectez-vous à la CodePipeline console à l'adresse [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Sur la page **Bienvenue**, **Démarrez** ou **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**MyVariablesPipeline**.
1. Dans **Type de pipeline**, conservez la sélection par défaut à **V2**. Les types de pipelines diffèrent en termes de caractéristiques et de prix. Pour de plus amples informations, veuillez consulter [Types de pipelines](pipeline-types.md).
1. Dans **Service role (Rôle de service)**, choisissez **New service role (Nouveau rôle de service)**.
**Note**
Si vous choisissez plutôt d'utiliser votre rôle de CodePipeline service existant, assurez-vous d'avoir ajouté l'autorisation `codeconnections:UseConnection` IAM à votre politique de rôle de service. Pour obtenir des instructions relatives au rôle de CodePipeline service, voir [Ajouter des autorisations au rôle CodePipeline de service](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).
1. Sous **Variables**, sélectionnez **Ajouter une variable**. Pour **Name (Nom)**, entrez `timeout`. Dans **Par défaut**, entrez 1000. Dans la description, entrez la description suivante : **Timeout**
Cela créera une variable dans laquelle vous pourrez déclarer la valeur au début de l'exécution du pipeline. Les noms des variables doivent correspondre `[A-Za-z0-9@\-_]+` et peuvent être n'importe quoi sauf une chaîne vide.
1. Sous **Paramètres avancés**, conservez les valeurs par défaut. Dans le **magasin d'artefacts** choisissez **Default location (Emplacement par défaut)** pour utiliser le magasin d'artefacts par défaut, tel que le compartiment d'artefacts Amazon S3 désigné par défaut, pour votre pipeline dans la région que vous avez sélectionnée pour ce dernier.
**Note**
Il ne s'agit pas du compartiment source de votre code source. Il s'agit du magasin d'artefacts pour votre pipeline. Un magasin d'artefacts distinct, tel qu'un compartiment S3, est nécessaire pour chaque pipeline.
Choisissez **Suivant**.
1. Sur la page **Étape 3 : Ajouter un stage source**, ajoutez un stage source :
1. Dans **Fournisseur de source**, choisissez **AWS CodeCommit**.
1. Dans **Nom du dépôt** et **Nom de la branche**, choisissez votre dépôt et votre branche.
Choisissez **Suivant**.
1. À **l'étape 4 : Ajouter une phase de construction**, ajoutez une étape de construction :
1. Dans le champ **Fournisseur de génération**, choisissez **AWS CodeBuild**. Acceptez la région du pipeline comme **Région** par défaut.
1. Sélectionnez **Create a project (Créer un projet)**.
1. Dans **Nom du projet**, saisissez un nom pour ce projet de génération.
1. Dans le champ **Image d'environnement**, choisissez **Image gérée**. Pour **Système d'exploitation**, choisissez **Ubuntu**.
1. Pour **Runtime (Exécution)**, sélectionnez **Standard**. **Pour **Image**, choisissez aws/codebuild/standard : 5.0.**
1. Pour **Rôle de service**, choisissez **Nouveau rôle de service**.
**Note**
Notez le nom de votre rôle CodeBuild de service. Vous aurez besoin du nom du rôle pour la dernière étape de ce didacticiel.
1. Sous **Buildspec**, pour **Build specifications (Spécifications de génération)**, choisissez **Insert build commands (Insérer des commandes de génération)**. Choisissez **Passer à l'éditeur**, puis collez le texte suivant sous **Commandes de génération**. Dans le buildspec, la variable client `$CUSTOM_VAR1` sera utilisée pour afficher la variable de pipeline dans le journal de construction. Vous allez créer la variable `$CUSTOM_VAR1` de sortie en tant que variable d'environnement à l'étape suivante.
```
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. Choisissez **Continuer vers CodePipeline**. Cela revient à la CodePipeline console et crée un CodeBuild projet qui utilise vos commandes de construction pour la configuration. Le projet de construction utilise un rôle de service pour gérer les Service AWS autorisations. Cette étape peut prendre quelques minutes.
1. Sous **Variables d'environnement *- facultatif***, pour créer une variable d'environnement en tant que variable d'entrée pour l'action de génération qui sera résolue par la variable au niveau du pipeline, choisissez **Ajouter une variable d'environnement**. Cela créera la variable spécifiée dans le buildspec en tant que. `$CUSTOM_VAR1` Pour **Name (Nom)**, entrez `CUSTOM_VAR1`. Dans **Value (Valeur)**, entrez `#{variables.timeout}`. Dans **Type**, sélectionnez`Plaintext`.
La `#{variables.timeout}` valeur de la variable d'environnement est basée sur l'espace de noms des variables au niveau du pipeline `variables` et sur la variable au niveau du pipeline `timeout` créée pour le pipeline à l'étape 7.
1. 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. Sur la page **Étape 6 : Ajouter une phase de déploiement**, choisissez **Ignorer l'étape de déploiement**, puis acceptez le message d'avertissement en choisissant à nouveau **Ignorer**. Choisissez **Suivant**.
1. À **l'étape 7 : Révision**, choisissez **Créer un pipeline**.
## Étape 2 : publier les modifications et consulter les journaux
1. Une fois le pipeline exécuté avec succès, lors de la phase de construction réussie, choisissez **Afficher les détails**.
Sur la page de détails, choisissez l'onglet **Logs**. Affichez le résultat CodeBuild de la compilation. Les commandes produisent la valeur de la variable saisie.
1. Dans le menu de navigation de gauche, sélectionnez **Historique**.
Choisissez l'exécution récente, puis cliquez sur l'onglet **Variables**. Affichez la valeur résolue pour la variable de pipeline.