Création de politiques de cache - Amazon CloudFront

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.

Création de politiques de cache

Vous pouvez utiliser une politique de cache pour améliorer votre taux d'accès au cache en contrôlant les valeurs (chaînes de requête URL, en-têtes HTTP et cookies) incluses dans la clé de cache. Vous pouvez créer une politique de cache dans la CloudFront console, avec le AWS Command Line Interface (AWS CLI) ou avec l' CloudFront API.

Après avoir créé une politique de cache, vous l'associez à un ou plusieurs comportements de cache dans une CloudFront distribution.

Console
Pour créer une politique de cache (console)

  1. Connectez-vous à la page Politiques AWS Management Console et ouvrez-la dans la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home?#/policies.

  2. Choisissez Créer une politique de cache.

  3. Choisissez le paramètre souhaité pour cette politique de cache. Pour plus d'informations, consultez Comprendre les politiques de cache.

  4. Lorsque vous avez terminé, choisissez Create (Créer).

Après avoir créé une politique de cache, vous pouvez l'attacher à un comportement de cache.

Pour attacher une politique de cache à une distribution existante (console)

  1. Ouvrez la page Distributions dans la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home#/distributions.

  2. Choisissez la distribution à mettre à jour, puis choisissez l'onglet Comportements.

  3. Choisissez le comportement du cache à mettre à jour, puis choisissez Modifier.

    Ou, pour créer un nouveau comportement de cache, choisissez Create behavior (Créer un comportement).

  4. Dans la section Cache key and origin requests (Clé de cache et demandes d'origine), assurez-vous que l'option Cache policy and origin request policy (Politique de cache et politique de demande d'origine) est sélectionnée.

  5. Pour Cache policy (Politique de cache), choisissez la politique de cache à attacher à ce comportement de cache.

  6. Choisissez Save changes (Enregistrer les modifications) en bas de la page.

Pour attacher une politique de cache à une nouvelle distribution (console)

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

  2. Choisissez Create distribution (Créer une distribution).

  3. Dans la section Cache key and origin requests (Clé de cache et demandes d'origine), assurez-vous que l'option Cache policy and origin request policy (Politique de cache et politique de demande d'origine) est sélectionnée.

  4. Pour Cache policy (Politique de cache), choisissez la politique de cache à attacher au comportement de cache par défaut de cette distribution.

  5. Choisissez les paramètres souhaités pour l'origine, le comportement de cache par défaut et les autres paramètres de distribution. Pour plus d'informations, consultez Référence des paramètres de distribution.

  6. Lorsque vous avez terminé, choisissez Create distribution (Créer une distribution).

CLI

Pour créer une politique de cache avec le AWS Command Line Interface (AWS CLI), utilisez la aws cloudfront create-cache-policy commande. Vous pouvez utiliser un fichier d'entrée pour fournir les paramètres d'entrée de la commande, plutôt que de spécifier chaque paramètre individuel comme entrée de ligne de commande.

Pour créer une politique de cache (CLI avec un fichier d'entrée)

  1. Utilisez la commande suivante pour créer un fichier nommé cache-policy.yaml qui contient tous les paramètres d’entrée de la commande create-cache-policy.

    
aws cloudfront create-cache-policy --generate-cli-skeleton yaml-input > cache-policy.yaml

  2. Ouvrez le fichier nommé cache-policy.yaml que vous venez de créer. Modifiez le fichier pour spécifier les paramètres de politique de cache que vous souhaitez, puis enregistrez le fichier. Vous pouvez supprimer des champs facultatifs du fichier, mais ne supprimez pas les champs obligatoires.

    Pour de plus amples informations sur les paramètres de politique de cache, veuillez consulter Comprendre les politiques de cache.

  3. Utilisez la commande suivante pour créer la politique de cache à l'aide des paramètres d'entrée du fichier cache-policy.yaml.

    
aws cloudfront create-cache-policy --cli-input-yaml file://cache-policy.yaml

    Notez la valeur Id dans la sortie de la commande. Il s'agit de l'ID de politique de cache, dont vous avez besoin pour associer la politique de cache au comportement de cache d'une CloudFront distribution.

Pour attacher une politique de cache à une distribution existante (CLI avec un fichier d'entrée)

  1. Utilisez la commande suivante pour enregistrer la configuration de distribution pour la CloudFront distribution que vous souhaitez mettre à jour. Remplacez distribution_ID par l’ID de la distribution.

    
aws cloudfront get-distribution-config --id distribution_ID --output yaml > dist-config.yaml

  2. Ouvrez le fichier nommé dist-config.yaml que vous venez de créer. Modifiez le fichier en apportant les modifications suivantes à chaque comportement de cache que vous mettez à jour pour utiliser une politique de cache.

    • Dans le comportement du cache, ajoutez un champ nommé CachePolicyId. Pour la valeur du champ, utilisez l'ID de politique de cache que vous avez noté après la création de la politique.

    • Supprimez les champs MinTTL, MaxTTL, DefaultTTL et ForwardedValues du comportement du cache. Ces paramètres sont spécifiés dans la politique de cache, de sorte que vous ne pouvez pas inclure ces champs et une politique de cache dans le même comportement de cache.

    • 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 afin d'utiliser la politique de cache. Remplacez distribution_ID par l’ID de la distribution.

    
aws cloudfront update-distribution --id distribution_ID --cli-input-yaml file://dist-config.yaml
Pour attacher une politique de cache à une nouvelle distribution (CLI avec un fichier d'entrée)

  1. Utilisez la commande suivante pour créer un fichier nommé distribution.yaml qui contient tous les paramètres d’entrée de la commande create-distribution.

    
aws cloudfront create-distribution --generate-cli-skeleton yaml-input > distribution.yaml

  2. Ouvrez le fichier nommé distribution.yaml que vous venez de créer. Dans le comportement de cache par défaut, dans le champ CachePolicyId, entrez l'ID de politique de cache que vous avez noté après la création de la politique. Poursuivez la modification du fichier pour spécifier les paramètres de distribution souhaité, puis enregistrez le fichier lorsque vous avez terminé.

    Pour de plus amples informations sur les paramètres de distribution, veuillez consulter Référence des paramètres de distribution.

  3. Utilisez la commande suivante pour créer la distribution à l'aide des paramètres d'entrée du fichier distribution.yaml.

    
aws cloudfront create-distribution --cli-input-yaml file://distribution.yaml
API

Pour créer une politique de cache avec l' CloudFront API, utilisez CreateCachePolicy. Pour plus d'informations sur les champs que vous spécifiez dans cet appel d'API, consultez Comprendre les politiques de cache la documentation de référence de l'API pour votre AWS SDK ou autre client d'API.

Après avoir créé une politique de cache, vous pouvez l'attacher à un comportement de cache, à l'aide de l'un des appels d'API suivants :

  • Pour l'associer à un comportement de cache dans une distribution existante, utilisez UpdateDistribution.

  • Pour l'associer à un comportement de cache dans une nouvelle distribution, utilisez CreateDistribution.

Pour ces deux appels d'API, indiquez l'ID de la politique de cache dans le champ CachePolicyId, à l'intérieur d'un comportement de cache. Pour plus d'informations sur les autres champs que vous spécifiez dans ces appels d'API, consultez Référence des paramètres de distribution la documentation de référence de l'API pour votre AWS SDK ou autre client d'API.