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.
# Utilisation d’une distribution intermédiaire et d’une politique de déploiement continu
Vous pouvez créer, mettre à jour et modifier des distributions intermédiaires et des politiques de déploiement continu dans la CloudFront console, avec le AWS Command Line Interface (AWS CLI) ou avec l' CloudFront API.
## Création d’une distribution intermédiaire avec une politique de déploiement continu
Les procédures suivantes expliquent comment créer une distribution intermédiaire avec une politique de déploiement continu.
------
#### [ Console ]
Vous pouvez créer une distribution intermédiaire avec une politique de déploiement continu à l’aide de la AWS Management Console.
**Pour créer une distribution intermédiaire et une politique de déploiement continu (console)**
1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le volet de navigation, sélectionnez **Distributions**.
1. Choisissez la distribution que vous souhaitez utiliser comme *distribution principale*. La distribution principale sert actuellement le trafic de production, c’est celle à partir de laquelle vous allez créer la distribution intermédiaire.
1. Dans la section **Continuous deployment** (Déploiement continu), choisissez **Create staging distribution** (Créer une distribution intermédiaire). L'assistant **Create staging distribution** (Créer une distribution intermédiaire) s'ouvre.
1. Dans l'assistant **Create staging distribution** (Créer une distribution intermédiaire), procédez comme suit :
1. (Facultatif) Saisissez une description pour la distribution intermédiaire.
1. Choisissez **Next** (Suivant).
1. Modifiez la configuration de la distribution intermédiaire. Pour plus d'informations sur les paramètres que vous pouvez mettre à jour, consultez [Mise à jour des distributions principale et intermédiaire](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
Lorsque vous avez terminé de modifier la configuration de la distribution intermédiaire, choisissez **Next** (Suivant).
1. Utilisez la console pour spécifier la **configuration du trafic**. Cela détermine la manière dont le trafic est CloudFront acheminé vers la distribution intermédiaire. (CloudFront stocke la configuration du trafic dans une *politique de déploiement continu*.)
Pour plus d'informations sur les options d’une **configuration de trafic**, consultez [Routage des demandes vers la distribution intermédiaire](understanding-continuous-deployment.md#understanding-continuous-deployment-routing).
Lorsque vous avez terminé la **configuration du trafic**, choisissez **Next** (Suivant).
1. Passez en revue la configuration de la distribution intermédiaire, y compris la configuration du trafic, puis choisissez **Create staging distribution** (Créer une distribution intermédiaire).
Lorsque vous avez terminé l'assistant **de création d'une distribution intermédiaire** dans la CloudFront console CloudFront , procédez comme suit :
+ Crée une distribution intermédiaire avec les paramètres que vous avez spécifiés (à l'étape 5c)
+ Crée une politique de déploiement continu avec la configuration du trafic que vous avez spécifiée (à l'étape 5d)
+ Attache la politique de déploiement continu à la distribution principale à partir de laquelle vous avez créé la distribution intermédiaire
Lorsque la configuration de la distribution principale, avec la politique de déploiement continu attachée, est déployée vers des emplacements périphériques, CloudFront commence à envoyer la partie spécifiée du trafic à la distribution intermédiaire en fonction de la configuration du trafic.
------
#### [ CLI ]
Pour créer une distribution intermédiaire et une politique de déploiement continu avec le AWS CLI, utilisez les procédures suivantes.
**Pour créer une distribution intermédiaire (interface de ligne de commande)**
1. Utilisez les commandes **aws cloudfront get-distribution** et **grep** ensemble pour obtenir la valeur `ETag` de la distribution que vous souhaitez utiliser comme *distribution principale*. La distribution principale sert actuellement le trafic de production, c’est celle à partir de laquelle vous allez créer la distribution intermédiaire.
Voici un exemple de commande. Dans l'exemple suivant, remplacez {{primary\_distribution\_ID}} par l'ID de la distribution principale.
```
aws cloudfront get-distribution --id {{primary_distribution_ID}} | grep 'ETag'
```
Copiez la valeur `ETag` car vous en aurez besoin à l'étape suivante.
1. Utilisez la commande **aws cloudfront copy-distribution** pour créer une distribution intermédiaire. L'exemple de commande suivant utilise des caractères d'échappement (\\) et des sauts de ligne pour plus de lisibilité, mais vous devez les omettre dans la commande. Dans l’exemple de commande suivant :
+ Remplacez {{primary\_distribution\_ID}} par l'ID de la distribution principale.
+ Remplacez {{primary\_distribution\_ETag}} par la `ETag` valeur de la distribution principale (que vous avez obtenue à l'étape précédente).
+ (Facultatif) {{CLI\_example}} Remplacez-le par le numéro de référence de l'appelant souhaité.
```
aws cloudfront copy-distribution --primary-distribution-id {{primary_distribution_ID}} \
--if-match {{primary_distribution_ETag}} \
--staging \
--caller-reference '{{CLI_example}}'
```
La sortie de la commande affiche des informations sur la distribution intermédiaire et sa configuration. Copiez le nom de CloudFront domaine de la distribution intermédiaire, car vous en aurez besoin pour l'étape suivante.
**Pour créer une politique de déploiement continu (interface de ligne de commande avec un fichier d'entrée)**
1. Utilisez la commande suivante pour créer un fichier nommé `continuous-deployment-policy.yaml` qui contient tous les paramètres d'entrée de la commande **create-continuous-deployment-policy**. La commande suivante utilise des caractères d'échappement (\\) et des sauts de ligne pour plus de lisibilité, mais vous devez les omettre dans la commande.
```
aws cloudfront create-continuous-deployment-policy --generate-cli-skeleton yaml-input \
> continuous-deployment-policy.yaml
```
1. Ouvrez le fichier nommé `continuous-deployment-policy.yaml` que vous venez de créer. Modifiez le fichier pour spécifier les paramètres de la politique de déploiement continu de votre choix, puis enregistrez le fichier. Lorsque vous modifiez le fichier :
+ Dans la section `StagingDistributionDnsNames` :
+ Remplacez la valeur de `Quantity` par `1`.
+ Pour cela`Items`, collez le nom de CloudFront domaine de la distribution intermédiaire (que vous avez enregistré lors d'une étape précédente).
+ Dans la section `TrafficConfig` :
+ Choisissez un `Type`, `SingleWeight` ou `SingleHeader`.
+ Supprimez les paramètres de l'autre type. Par exemple, si vous souhaitez une configuration du trafic basée sur le poids, définissez `Type` sur `SingleWeight`, puis supprimez les paramètres de `SingleHeaderConfig`.
+ Pour utiliser une configuration de trafic basée sur le poids, définissez la valeur de `Weight` sur un nombre décimal compris entre `.01` (un pour cent) et `.15` (quinze pour cent).
Pour plus d’informations sur les options de `TrafficConfig`, consultez [Routage des demandes vers la distribution intermédiaire](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) et [Permanence des sessions pour les configurations basées sur le poids](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions).
1. Utilisez la commande suivante pour créer la politique de déploiement continu à l'aide des paramètres d'entrée du fichier `continuous-deployment-policy.yaml`.
```
aws cloudfront create-continuous-deployment-policy --cli-input-yaml file://continuous-deployment-policy.yaml
```
Copiez la valeur `Id` dans la sortie de la commande. Il s'agit de l’ID de la politique de déploiement continu, dont vous aurez besoin lors d’une étape suivante.
**Pour attacher une politique de déploiement continu à une distribution principale (interface de ligne de commande avec un fichier d'entrée)**
1. Utilisez la commande suivante pour enregistrer la configuration de la distribution principale dans un fichier nommé `primary-distribution.yaml`. Remplacez {{primary\_distribution\_ID}} par l'ID de la distribution principale.
```
aws cloudfront get-distribution-config --id {{primary_distribution_ID}} --output yaml > primary-distribution.yaml
```
1. Ouvrez le fichier nommé `primary-distribution.yaml` que vous venez de créer. Modifiez le fichier en apportant les modifications suivantes :
+ Collez l'ID de la politique de déploiement continu (que vous avez copié lors d'une étape précédente) dans le champ `ContinuousDeploymentPolicyId`.
+ Renommez le champ `ETag` en `IfMatch`, mais ne modifiez pas la valeur du champ.
Enregistrez le fichier lorsque vous avez terminé.
1. Utilisez la commande suivante pour mettre à jour la distribution principale afin d'utiliser la politique de déploiement continu. Remplacez {{primary\_distribution\_ID}} par l'ID de la distribution principale.
```
aws cloudfront update-distribution --id {{primary_distribution_ID}} --cli-input-yaml file://primary-distribution.yaml
```
Lorsque la configuration de la distribution principale, avec la politique de déploiement continu attachée, est déployée vers des emplacements périphériques, CloudFront commence à envoyer la partie spécifiée du trafic à la distribution intermédiaire en fonction de la configuration du trafic.
------
#### [ API ]
Pour créer une politique de distribution intermédiaire et de déploiement continu avec l' CloudFront API, utilisez les opérations d'API suivantes :
+ [CopyDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CopyDistribution.html)
+ [CreateContinuousDeploymentPolicy](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateContinuousDeploymentPolicy.html)
Pour plus d'informations sur les champs que vous spécifiez dans ces appels d'API, consultez :
+ [Routage des demandes vers la distribution intermédiaire](understanding-continuous-deployment.md#understanding-continuous-deployment-routing)
+ [Permanence des sessions pour les configurations basées sur le poids](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions)
+ La documentation de référence de l'API pour votre AWS SDK ou autre client d'API
Après avoir créé une distribution intermédiaire et une politique de déploiement continu, utilisez [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(sur la distribution principale) pour associer la stratégie de déploiement continu à la distribution principale.
------
## Mise à jour d’une distribution intermédiaire
Les procédures suivantes expliquent comment mettre à jour une distribution intermédiaire avec une politique de déploiement continu.
------
#### [ Console ]
Vous pouvez mettre à jour certaines configurations pour la distribution principale et la distribution intermédiaire. Pour de plus amples informations, veuillez consulter [Mise à jour des distributions principale et intermédiaire](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
**Pour mettre à jour une distribution intermédiaire (console)**
1. Ouvrez la CloudFront console à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le volet de navigation, sélectionnez **Distributions**.
1. Choisissez la distribution principale. Il s’agit de la distribution qui sert actuellement le trafic de production, celle à partir de laquelle vous avez créé la distribution intermédiaire.
1. Choisissez **View staging distribution** (Afficher la distribution intermédiaire).
1. Utilisez la console pour modifier la configuration de la distribution intermédiaire. Pour plus d'informations sur les paramètres que vous pouvez mettre à jour, consultez [Mise à jour des distributions principale et intermédiaire](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
Dès que la configuration de la distribution intermédiaire est déployée vers des emplacements périphériques, elle prend effet pour le trafic entrant acheminé vers la distribution intermédiaire.
------
#### [ CLI ]
**Pour mettre à jour une distribution intermédiaire (interface de ligne de commande avec un fichier d'entrée)**
1. Utilisez la commande suivante pour enregistrer la configuration de la distribution intermédiaire dans un fichier nommé `staging-distribution.yaml`. Remplacez {{staging\_distribution\_ID}} par l'ID de la distribution intermédiaire.
```
aws cloudfront get-distribution-config --id {{staging_distribution_ID}} --output yaml > staging-distribution.yaml
```
1. Ouvrez le fichier nommé `staging-distribution.yaml` que vous venez de créer. Modifiez le fichier en apportant les modifications suivantes :
+ Modifiez la configuration de la distribution intermédiaire. Pour plus d'informations sur les paramètres que vous pouvez mettre à jour, consultez [Mise à jour des distributions principale et intermédiaire](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
+ Renommez le champ `ETag` en `IfMatch`, mais ne modifiez pas la valeur du champ.
Enregistrez le fichier lorsque vous avez terminé.
1. Utilisez la commande suivante pour mettre à jour la configuration de la distribution intermédiaire. Remplacez {{staging\_distribution\_ID}} par l'ID de la distribution intermédiaire.
```
aws cloudfront update-distribution --id {{staging_distribution_ID}} --cli-input-yaml file://staging-distribution.yaml
```
Dès que la configuration de la distribution intermédiaire est déployée vers des emplacements périphériques, elle prend effet pour le trafic entrant acheminé vers la distribution intermédiaire.
------
#### [ API ]
Pour mettre à jour la configuration d'une distribution intermédiaire, utilisez [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(sur la distribution intermédiaire) pour modifier la configuration de la distribution intermédiaire. Pour plus d’informations sur les paramètres que vous pouvez mettre à jour, consultez [Mise à jour des distributions principale et intermédiaire](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
------
## Mise à jour d’une politique de déploiement continu
Les procédures suivantes expliquent comment mettre à jour une politique de déploiement continu.
------
#### [ Console ]
Vous pouvez mettre à jour la configuration du trafic de votre distribution en mettant à jour la politique de déploiement continu.
**Pour mettre à jour une politique de déploiement continu (console)**
1. Ouvrez la CloudFront console à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le volet de navigation, sélectionnez **Distributions**.
1. Choisissez la distribution principale. Il s’agit de la distribution qui sert actuellement le trafic de production, celle à partir de laquelle vous avez créé la distribution intermédiaire.
1. Dans la section **Continuous deployment** (Déploiement continu), choisissez **Edit policy** (Modifier la politique).
1. Modifiez la configuration du trafic dans la politique de déploiement continu. Lorsque vous avez terminé, choisissez **Save changes** (Enregistrer les modifications).
Lorsque la configuration de la distribution principale avec la politique de déploiement continu mise à jour est déployée sur des emplacements périphériques, CloudFront commence à envoyer du trafic vers la distribution intermédiaire en fonction de la configuration de trafic mise à jour.
------
#### [ CLI ]
**Pour mettre à jour une politique de déploiement continu (interface de ligne de commande avec un fichier d'entrée)**
1. Utilisez la commande suivante pour enregistrer la configuration de la politique de déploiement continu dans un fichier nommé `continuous-deployment-policy.yaml`. Remplacez {{continuous\_deployment\_policy\_ID}} par l'ID de la politique de déploiement continu. La commande suivante utilise des caractères d'échappement (\\) et des sauts de ligne pour plus de lisibilité, mais vous devez les omettre dans la commande.
```
aws cloudfront get-continuous-deployment-policy-config --id {{continuous_deployment_policy_ID}} \
--output yaml > continuous-deployment-policy.yaml
```
1. Ouvrez le fichier nommé `continuous-deployment-policy.yaml` que vous venez de créer. Modifiez le fichier en apportant les modifications suivantes :
+ Modifiez la configuration de la politique de déploiement continu comme vous le souhaitez. Par exemple, vous pouvez passer d'une configuration de trafic basée sur l’en-tête à une configuration de trafic basée sur le poids, ou vous pouvez modifier le pourcentage de trafic (poids) pour une configuration basée sur le poids. Pour plus d’informations, consultez [Routage des demandes vers la distribution intermédiaire](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) et [Permanence des sessions pour les configurations basées sur le poids](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions).
+ Renommez le champ `ETag` en `IfMatch`, mais ne modifiez pas la valeur du champ.
Enregistrez le fichier lorsque vous avez terminé.
1. Utilisez la commande suivante pour mettre à jour la politique de déploiement continu. Remplacez {{continuous\_deployment\_policy\_ID}} par l'ID de la politique de déploiement continu. La commande suivante utilise des caractères d'échappement (\\) et des sauts de ligne pour plus de lisibilité, mais vous devez les omettre dans la commande.
```
aws cloudfront update-continuous-deployment-policy --id {{continuous_deployment_policy_ID}} \
--cli-input-yaml file://continuous-deployment-policy.yaml
```
Lorsque la configuration de la distribution principale avec la politique de déploiement continu mise à jour est déployée sur des emplacements périphériques, CloudFront commence à envoyer du trafic vers la distribution intermédiaire en fonction de la configuration de trafic mise à jour.
------
#### [ API ]
Pour mettre à jour une politique de déploiement continu, utilisez [UpdateContinuousDeploymentPolicy](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateContinuousDeploymentPolicy.html).
------
## Promouvoir la configuration d’une distribution intermédiaire
Les procédures suivantes expliquent comment promouvoir la configuration d’une distribution intermédiaire.
------
#### [ Console ]
Lorsque vous *faites la promotion* d'une distribution intermédiaire, CloudFront copie la configuration de la distribution intermédiaire vers la distribution principale. CloudFront désactive également la politique de déploiement continu et achemine tout le trafic vers la distribution principale.
Après avoir promu une configuration, vous pouvez réutiliser la même distribution intermédiaire la prochaine fois que vous souhaitez tester un changement de configuration.
**Pour promouvoir la configuration d'une distribution intermédiaire (console)**
1. Ouvrez la CloudFront console à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le volet de navigation, sélectionnez **Distributions**.
1. Choisissez la distribution principale. Il s’agit de la distribution qui sert actuellement le trafic de production, celle à partir de laquelle vous avez créé la distribution intermédiaire.
1. Dans la section **Continuous deployment** (Déploiement continu), choisissez **Promote** (Promouvoir).
1. Saisissez **confirm**, puis choisissez **Promote** (Promouvoir).
------
#### [ CLI ]
Lorsque vous *faites la promotion* d'une distribution intermédiaire, CloudFront copie la configuration de la distribution intermédiaire vers la distribution principale. CloudFront désactive également la politique de déploiement continu et achemine tout le trafic vers la distribution principale.
Après avoir promu une configuration, vous pouvez réutiliser la même distribution intermédiaire la prochaine fois que vous souhaitez tester un changement de configuration.
**Pour promouvoir la configuration d'une distribution intermédiaire (interface de ligne de commande)**
+ Utilisez la commande **aws cloudfront update-distribution-with-staging-config** pour promouvoir la configuration de la distribution intermédiaire vers la distribution principale. L'exemple de commande suivant utilise des caractères d'échappement (\\) et des sauts de ligne pour plus de lisibilité, mais vous devez les omettre dans la commande. Dans l’exemple de commande suivant :
+ Remplacez {{primary\_distribution\_ID}} par l'ID de la distribution principale.
+ Remplacez {{staging\_distribution\_ID}} par l'ID de la distribution intermédiaire.
+ Remplacez {{primary\_distribution\_ETag}} et {{staging\_distribution\_ETag}} par les `ETag` valeurs des distributions principale et intermédiaire. Assurez-vous que la valeur de la distribution principale s’affiche en premier, comme indiqué dans l'exemple.
```
aws cloudfront update-distribution-with-staging-config --id {{primary_distribution_ID}} \
--staging-distribution-id {{staging_distribution_ID}} \
--if-match '{{primary_distribution_ETag}},{{staging_distribution_ETag}}'
```
------
#### [ API ]
Pour promouvoir la configuration d'une distribution intermédiaire vers la distribution principale, utilisez [UpdateDistributionWithStagingConfig](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistributionWithStagingConfig.html).
------