Travaillez avec une politique de distribution progressive et de déploiement continu

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'adressehttps://console.aws.amazon.com/cloudfront/v4/home.

2. Dans le volet de navigation, sélectionnez Distributions.

3. 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.

4. 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.

5. 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).

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.

2. 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)

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

2. 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.

3. 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

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

3. 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

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

1. Ouvrez la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.

2. Dans le volet de navigation, sélectionnez Distributions.

3. 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.

4. Choisissez View staging distribution (Afficher la distribution intermédiaire).

5. 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.

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

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

3. 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

Pour mettre à jour une politique de déploiement continu (console)

1. Ouvrez la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.

2. Dans le volet de navigation, sélectionnez Distributions.

3. 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.

4. Dans la section Continuous deployment (Déploiement continu), choisissez Edit policy (Modifier la politique).

5. Modifiez la configuration du trafic dans la politique de déploiement continu. Lorsque vous avez terminé, choisissez Save changes (Enregistrer les modifications).

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

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

3. 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

Pour promouvoir la configuration d'une distribution intermédiaire (console)

1. Ouvrez la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.

2. Dans le volet de navigation, sélectionnez Distributions.

3. 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.

4. Dans la section Continuous deployment (Déploiement continu), choisissez Promote (Promouvoir).

5. Saisissez confirm, puis choisissez Promote (Promouvoir).

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'