Créez une distribution intermédiaire avec une politique de déploiement continu Mettre à jour une distribution intermédiaire Mettre à jour une politique de déploiement continu Promouvoir une configuration de distribution intermédiaire

Travaillez avec une politique de distribution progressive et 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éez une distribution intermédiaire avec une politique de déploiement continu

Les procédures suivantes vous montrent 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 en utilisant le AWS Management Console.

Pour créer une distribution intermédiaire et une politique de déploiement continu (console)

Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.
Dans le volet de navigation, sélectionnez Distributions.
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.
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.
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.
2. Choisissez Next (Suivant).
3. Modifiez la configuration de la distribution intermédiaire. Pour plus d'informations sur les paramètres que vous pouvez mettre à jour, consultez Mettre à jour les distributions principales et intermédiaires.
  
  Lorsque vous avez terminé de modifier la configuration de la distribution intermédiaire, choisissez Next (Suivant).
4. 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 Acheminer les demandes vers la distribution intermédiaire.
  
  Lorsque vous avez terminé la configuration du trafic, choisissez Next (Suivant).
5. 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)

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.
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 valeur ETag de la distribution principale (que vous avez obtenue à l'étape précédente).
- (Facultatif) Remplacez CLI_example par l'ID de la référence appelant de votre choix.
```
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)

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
```
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 celaItems, 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 Acheminer les demandes vers la distribution intermédiaire et Permanence des sessions pour les configurations basées sur le poids.
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)

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
```
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é.
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
```

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 :

Pour plus d'informations sur les champs que vous spécifiez dans ces appels d'API, consultez :

Acheminer les demandes vers la distribution intermédiaire
Permanence des sessions pour les configurations basées sur le poids
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(sur la distribution principale) pour associer la stratégie de déploiement continu à la distribution principale.

Mettre à jour une distribution intermédiaire

Les procédures suivantes vous montrent 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 plus d’informations, consultez Mettre à jour les distributions principales et intermédiaires.

Pour mettre à jour une distribution intermédiaire (console)

Ouvrez la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.
Dans le volet de navigation, sélectionnez Distributions.
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.
Choisissez View staging distribution (Afficher la distribution intermédiaire).
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 Mettre à jour les distributions principales et intermédiaires.

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)

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
```
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 Mettre à jour les distributions principales et intermédiaires.
- Renommez le champ ETag en IfMatch, mais ne modifiez pas la valeur du champ.
Enregistrez le fichier lorsque vous avez terminé.
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
```

API

Pour mettre à jour la configuration d'une distribution intermédiaire, utilisez UpdateDistribution(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 Mettre à jour les distributions principales et intermédiaires.

Mettre à jour une politique de déploiement continu

Les procédures suivantes vous montrent 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)

Ouvrez la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.
Dans le volet de navigation, sélectionnez Distributions.
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.
Dans la section Continuous deployment (Déploiement continu), choisissez Edit policy (Modifier la politique).
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)

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
```
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 Acheminer les demandes vers la distribution intermédiaire et Permanence des sessions pour les configurations basées sur le poids.
- Renommez le champ ETag en IfMatch, mais ne modifiez pas la valeur du champ.
Enregistrez le fichier lorsque vous avez terminé.
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
```

API

Pour mettre à jour une politique de déploiement continu, utilisez UpdateContinuousDeploymentPolicy.

Promouvoir une configuration de distribution intermédiaire

Les procédures suivantes vous montrent comment promouvoir une configuration de 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)

Ouvrez la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.
Dans le volet de navigation, sélectionnez Distributions.
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.
Dans la section Continuous deployment (Déploiement continu), choisissez Promote (Promouvoir).
Saisissez confirm, puis choisissez Promote (Promouvoir).

CLI

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 valeurs ETag 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.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

CloudFront flux de travail de déploiement continu

Surveiller une distribution intermédiaire