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.
# Utilisez le déploiement CloudFront continu pour tester en toute sécurité les modifications de configuration du CDN
Avec *le déploiement CloudFront continu* d'Amazon, vous pouvez déployer en toute sécurité les modifications apportées à votre configuration CDN en effectuant d'abord des tests avec un sous-ensemble du trafic de production. Vous pouvez utiliser une *distribution intermédiaire* et une *politique de déploiement continu* pour envoyer une partie du trafic provenant d’utilisateurs réels (de production) vers la nouvelle configuration du CDN et vérifier qu'elle fonctionne comme prévu. Vous pouvez surveiller les performances de la nouvelle configuration en temps réel et promouvoir la nouvelle configuration pour qu'elle serve l’ensemble du trafic via la *distribution principale* lorsque vous êtes prêt.
Le schéma suivant montre les avantages du déploiement CloudFront continu. Sans cela, vous devriez tester les changements de configuration du CDN sur un trafic simulé. Avec le déploiement continu, vous pouvez tester les changements sur un sous-ensemble du trafic de production, puis promouvoir les changements vers la distribution principale lorsque vous êtes prêt.
![\[Graphique d' CloudFront un déploiement continu qui envoie le trafic de production vers une distribution intermédiaire.\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudFront/latest/DeveloperGuide/images/cloudfront-continuous-deployment.png)
Pour en savoir plus sur l’utilisation du déploiement continu, consultez les rubriques suivantes.
**Topics**
+ [CloudFront flux de travail de déploiement continu](continuous-deployment-workflow.md)
+ [Utilisation d’une distribution intermédiaire et d’une politique de déploiement continu](working-with-staging-distribution-continuous-deployment-policy.md)
+ [Surveillance d’une distribution intermédiaire](monitoring-staging-distribution.md)
+ [Découvrez le fonctionnement du déploiement continu](understanding-continuous-deployment.md)
+ [Quotas et autres considérations relatives au déploiement continu](continuous-deployment-quotas-considerations.md)
# CloudFront flux de travail de déploiement continu
Le flux de travail de haut niveau suivant explique comment tester et déployer en toute sécurité des modifications de configuration dans le cadre d' CloudFront un déploiement continu.
1. Choisissez la distribution que vous souhaitez utiliser comme *distribution principale*. La distribution principale sert actuellement le trafic de production.
1. À partir de la distribution principale, créez une *distribution intermédiaire*. Une distribution intermédiaire commence comme une copie de la distribution principale.
1. Créez une *configuration de trafic* dans une *politique de déploiement continu* et associez-la à la distribution principale. Cela détermine la manière dont le trafic est CloudFront acheminé vers la distribution intermédiaire. Pour plus d'informations sur l’acheminement des demandes vers une distribution intermédiaire, consultez [Routage des demandes vers la distribution intermédiaire](understanding-continuous-deployment.md#understanding-continuous-deployment-routing).
1. Mettez à jour 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).
1. Surveillez la distribution intermédiaire pour déterminer si les changements de configuration fonctionnent comme prévu. Pour plus d'informations sur la surveillance d’une distribution intermédiaire, consultez [Surveillance d’une distribution intermédiaire](monitoring-staging-distribution.md).
Lorsque vous surveillez la distribution intermédiaire, vous pouvez :
+ Remettre à jour la configuration de la distribution intermédiaire pour continuer à tester les changements de configuration.
+ Mettre à jour la politique de déploiement continu (configuration du trafic) pour envoyer plus ou moins de trafic vers la distribution intermédiaire.
1. Lorsque vous êtes satisfait des performances de la distribution intermédiaire, *promouvez* la configuration de la distribution intermédiaire vers la distribution principale. La configuration de la distribution intermédiaire est ainsi copiée vers la distribution principale. Cela désactive également la politique de déploiement continu, ce qui signifie que tout le trafic est CloudFront acheminé vers la distribution principale.
Vous pouvez créer une automatisation qui surveille les performances de la distribution intermédiaire (étape 5) et promeut automatiquement la configuration (étape 6) lorsque certains critères sont remplis.
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 plus d'informations sur l'utilisation des distributions intermédiaires et des politiques de déploiement continu dans la CloudFront console AWS CLI, l'API ou l' CloudFront API, consultez la section suivante.
# 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\$1distribution\$1ID* 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 (\$1) 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\$1distribution\$1ID* par l'ID de la distribution principale.
+ Remplacez *primary\$1distribution\$1ETag* par la `ETag` valeur de la distribution principale (que vous avez obtenue à l'étape précédente).
+ (Facultatif) *CLI\$1example* 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 (\$1) 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\$1distribution\$1ID* 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\$1distribution\$1ID* 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\$1distribution\$1ID* 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\$1distribution\$1ID* 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\$1deployment\$1policy\$1ID* par l'ID de la politique de déploiement continu. La commande suivante utilise des caractères d'échappement (\$1) 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\$1deployment\$1policy\$1ID* par l'ID de la politique de déploiement continu. La commande suivante utilise des caractères d'échappement (\$1) 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 (\$1) 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\$1distribution\$1ID* par l'ID de la distribution principale.
+ Remplacez *staging\$1distribution\$1ID* par l'ID de la distribution intermédiaire.
+ Remplacez *primary\$1distribution\$1ETag* et *staging\$1distribution\$1ETag* 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).
------
# Surveillance d’une distribution intermédiaire
Pour surveiller les performances d'une distribution intermédiaire, vous pouvez utiliser les mêmes [mesures, journaux et rapports que ceux](reports-and-monitoring.md) CloudFront fournis pour toutes les distributions. Par exemple :
+ Vous pouvez consulter les [mesures de CloudFront distribution par défaut](viewing-cloudfront-metrics.md#monitoring-console.distributions) (telles que le nombre total de demandes et le taux d'erreur) dans la CloudFront console, et vous pouvez [activer des mesures supplémentaires](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional) (telles que le taux de réussite du cache et le taux d'erreur par code d'état) moyennant des frais supplémentaires. Vous pouvez également créer des alarmes en fonction de ces métriques.
+ Vous pouvez consulter [les journaux standard et les](AccessLogs.md) [journaux d'accès en temps réel](real-time-logs.md) pour obtenir des informations détaillées sur les demandes reçues par la distribution intermédiaire. Les journaux standard contiennent les deux champs suivants qui vous aident à identifier la distribution principale à laquelle la demande a été initialement envoyée avant de l' CloudFront acheminer vers la distribution intermédiaire : `primary-distribution-id` et`primary-distribution-dns-name`.
+ Vous pouvez consulter et télécharger [des rapports](reports.md) dans la CloudFront console, par exemple le rapport sur les statistiques du cache.
# Découvrez le fonctionnement du déploiement continu
Les rubriques suivantes expliquent le fonctionnement du déploiement CloudFront continu.
**Topics**
+ [Routage des demandes vers la distribution intermédiaire](#understanding-continuous-deployment-routing)
+ [Permanence des sessions pour les configurations basées sur le poids](#understanding-continuous-deployment-sessions)
+ [Mise à jour des distributions principale et intermédiaire](#updating-staging-and-primary-distributions)
+ [Les distributions principale et intermédiaire ne partagent pas de cache](#staging-and-primary-no-shared-cache)
## Routage des demandes vers la distribution intermédiaire
Lorsque vous utilisez le déploiement CloudFront continu, il n'est pas nécessaire de modifier quoi que ce soit en ce qui concerne les demandes des utilisateurs. Les utilisateurs ne peuvent pas envoyer directement de demandes à une distribution intermédiaire à l'aide d'un nom DNS, d'une adresse IP ou d'un CNAME. Les utilisateurs envoient plutôt des demandes à la distribution principale (de production) et CloudFront acheminent certaines de ces demandes vers la distribution intermédiaire en fonction des paramètres de configuration du trafic définis dans la politique de déploiement continu. Il existe deux types de configurations du trafic :
**Basée sur le poids**
Une configuration basée sur le poids achemine le pourcentage spécifié de demandes des utilisateurs vers la distribution intermédiaire. Lorsque vous utilisez une configuration basée sur le poids, vous pouvez également activer le maintien des *sessions*, ce qui permet de s'assurer que CloudFront les demandes provenant du même utilisateur sont traitées dans le cadre d'une seule session. Pour de plus amples informations, veuillez consulter [Permanence des sessions pour les configurations basées sur le poids](#understanding-continuous-deployment-sessions).
**Basée sur l’en-tête**
Une configuration basée sur l’en-tête achemine les demandes vers la distribution intermédiaire lorsque la demande de l’utilisateur contient un en-tête HTTP spécifique (vous spécifiez l'en-tête et la valeur). Les demandes qui ne contiennent pas l'en-tête et la valeur spécifiés sont acheminées vers la distribution principale. Cette configuration est utile pour les tests locaux ou lorsque vous contrôlez les demandes des utilisateurs.
Les en-têtes acheminés vers votre distribution intermédiaire doivent contenir le préfixe `aws-cf-cd-`.
## Permanence des sessions pour les configurations basées sur le poids
Lorsque vous utilisez une configuration basée sur le poids pour acheminer le trafic vers une distribution intermédiaire, vous pouvez également activer la persistance des *sessions, ce qui* permet de garantir que CloudFront les demandes provenant du même spectateur sont traitées comme une seule session. Lorsque vous activez le caractère permanent des sessions, CloudFront définit un cookie afin que toutes les demandes émanant d'un même utilisateur au cours d'une même session soient traitées par une seule distribution, principale ou intermédiaire.
Lorsque vous activez la permanence des sessions, vous pouvez également spécifier la *durée d'inactivité*. Si le visualiseur est inactif (n'envoie aucune demande) pendant cette durée, la session expire et CloudFront traite les futures demandes de ce visualiseur comme une nouvelle session. Vous spécifiez la durée d'inactivité en nombre de secondes, compris entre 300 (cinq minutes) et 3 600 (une heure).
Dans les cas suivants, CloudFront réinitialise toutes les sessions (même les sessions actives) et considère toutes les demandes comme une nouvelle session :
+ Vous désactivez ou activez la politique de déploiement continu
+ Vous désactivez ou activez le paramètre de permanence des sessions
## Mise à jour des distributions principale et intermédiaire
Lorsqu'une une politique de déploiement continu est attachée à une distribution principale, les changements de configuration suivants sont disponibles pour les distributions principale et intermédiaire :
+ Tous les paramètres de comportement du cache, y compris le comportement du cache par défaut
+ Tous les paramètres d'origine (origines et groupes d'origines)
+ Réponses d'erreur personnalisées (pages d'erreur)
+ Restrictions géographiques
+ Objet racine par défaut
+ Paramètres de journalisation
+ Description (commentaire)
Vous pouvez également mettre à jour les ressources externes référencées dans la configuration d'une distribution, telles qu'une politique de cache, une politique d'en-têtes de réponse, une CloudFront fonction ou une fonction Lambda @Edge.
## Les distributions principale et intermédiaire ne partagent pas de cache
Les distributions principale et intermédiaire ne partagent pas de cache. Lorsque CloudFront la première demande est envoyée à une distribution intermédiaire, son cache est vide. Il commence à mettre en cache les réponses (s’il est configuré pour le faire) au fur et à mesure que les demandes atteignent la distribution intermédiaire.
# Quotas et autres considérations relatives au déploiement continu
CloudFront le déploiement continu est soumis aux quotas suivants et à d'autres considérations.
## Quotas
+ Nombre maximum de distributions intermédiaires par Compte AWS : 20
+ Nombre maximum de politiques de déploiement continu par Compte AWS : 20
+ Pourcentage maximal de trafic que vous pouvez envoyer vers une distribution intermédiaire dans une configuration basée sur le poids : 15 %
+ Valeurs minimale et maximale pour la durée d'inactivité de la permanence des sessions : 300 à 3 600 secondes
Pour de plus amples informations, veuillez consulter [Quotas](cloudfront-limits.md).
**Note**
Lorsque vous utilisez le déploiement continu et que votre distribution principale est configurée avec une OAC pour l’accès au compartiment S3, mettez à jour votre stratégie de compartiment S3 afin d’autoriser l’accès pour la distribution intermédiaire. Pour consulter des exemples de stratégies de compartiment S3, reportez-vous à la [Accorder l' CloudFront autorisation d'accéder au compartiment S3](private-content-restricting-access-to-s3.md#oac-permission-to-access-s3).
## AWS WAF web ACLs
Si vous activez le déploiement continu pour votre distribution, les points suivants doivent être pris en compte pour AWS WAF :
+ Vous ne pouvez pas associer de liste de contrôle d'accès AWS WAF Web (ACL) à la distribution si c'est la première fois que cette liste est associée à la distribution.
+ Vous ne pouvez pas dissocier une ACL AWS WAF Web de la distribution.
Avant de pouvoir effectuer les tâches précédentes, vous devez supprimer la politique de déploiement continu pour votre distribution de production. Cette action supprime également la distribution intermédiaire. Pour de plus amples informations, veuillez consulter [Utilisation de protections AWS WAF](distribution-web-awswaf.md).
## Cas où toutes les demandes sont CloudFront envoyées à la distribution principale
Dans certains cas, tels que les périodes de forte utilisation des ressources, toutes les demandes CloudFront peuvent être envoyées à la distribution principale, indépendamment de ce qui est spécifié dans la politique de déploiement continu.
CloudFront envoie toutes les demandes à la distribution principale pendant les heures de pointe, indépendamment de ce qui est spécifié dans la politique de déploiement continu. Le pic de trafic fait référence au trafic du *CloudFront service*, et non au trafic de votre distribution.
## HTTP/3
Vous ne pouvez pas utiliser le déploiement continu avec une distribution qui prend en charge le protocole HTTP/3.