Erstellen von Cache-Richtlinien - Amazon CloudFront

Erstellen von Cache-Richtlinien

Sie können eine Cache-Richtlinie verwenden, um das Cache-Trefferverhältnis zu verbessern, indem Sie die Werte (URL-Abfragezeichenfolgen, HTTP-Header und Cookies) steuern, die im Cache-Schlüssel enthalten sind. Sie können eine Cache-Richtlinie in der CloudFront-Konsole, über die AWS Command Line Interface (AWS CLI) oder über die CloudFront-API erstellen.

Nachdem Sie eine Cache-Richtlinie erstellt haben, fügen Sie sie einer oder mehreren Cache-Verhaltensweisen in einer CloudFront-Verteilung an.

Console
So erstellen Sie eine Cache-Richtlinie (Konsole):

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Seite Richtlinien in der CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home?#/policies.

  2. Wählen Sie Create cache policy (Cache-Richtlinie erstellen).

  3. Wählen Sie die gewünschte Einstellung für diese Cache-Richtlinie aus. Weitere Informationen finden Sie unter Grundlegendes zu Cache-Richtlinien.

  4. Wenn Sie fertig sind, wählen Sie Erstellen.

Nachdem Sie eine Cache-Richtlinie erstellt haben, können Sie sie an eine Cache-Verhaltensweise anfügen.

So fügen Sie eine Cache-Richtlinie an eine vorhandene Verteilung an (Konsole):

  1. Öffnen Sie die Seite Distributions (Verteilungen) in der CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home#/distributions.

  2. Wählen Sie die Verteilung aus, die Sie aktualisieren möchten, und anschließend die Registerkarte Verhaltensweisen aus.

  3. Wählen Sie das Cacheverhalten, das Sie aktualisieren möchten, und anschließend Bearbeiten aus.

    Um ein neues Cacheverhalten zu erstellen, wählen Sie Verhalten erstellen aus.

  4. Stellen Sie im Abschnitt Cache-Schlüssel- und Ursprungsanforderungen sicher, dass Cache-Richtlinie und Ursprungsanforderungsrichtlinie ausgewählt sind.

  5. Wählen Sie für Cache Policy (Cache-Richtlinie) die Cache-Richtlinie aus, die diesem Cache-Verhalten angefügt werden soll.

  6. Wählen Sie unten auf der Seite die Option Änderungen speichern aus.

So fügen Sie eine Cache-Richtlinie an eine neue Verteilung an (Konsole):

  1. Öffnen Sie die CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home.

  2. Wählen Sie Verteilung erstellen.

  3. Stellen Sie im Abschnitt Cache-Schlüssel- und Ursprungsanforderungen sicher, dass Cache-Richtlinie und Ursprungsanforderungsrichtlinie ausgewählt sind.

  4. Wählen Sie unter Cache policy (Cache-Richtlinie) die Cache-Richtlinie aus, die an das Standard-Cacheverhalten dieser Verteilung angefügt werden soll.

  5. Wählen Sie die gewünschten Einstellungen für den Ursprung, das Standard-Cacheverhalten und andere Verteilungseinstellungen aus. Weitere Informationen finden Sie unter Referenz für alle Distributionseinstellungen.

  6. Wenn Sie fertig sind, wählen Sie Verteilung erstellen aus.

CLI

Verwenden Sie den AWS Command Line Interface-Befehl, um eine Cache-Richtlinie mit dem AWS CLI (aws cloudfront create-cache-policy) zu erstellen. Sie können die Eingabeparameter des Befehls in einer Eingabedatei bereitstellen, anstatt jeden einzelnen Parameter als Befehlszeileneingabe anzugeben.

So erstellen Sie eine Cache-Richtlinie (CLI mit Eingabedatei):

  1. Verwenden Sie den folgenden Befehl, um eine Datei mit dem Namen cache-policy.yaml zu erstellen, die alle Eingabeparameter für den create-cache-policy-Befehl enthält.

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

  2. Öffnen Sie die Datei mit dem Namen cache-policy.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei, um die gewünschten Cache-Richtlinieneinstellungen anzugeben, und speichern Sie die Datei. Sie können optionale Felder aus der Datei entfernen, erforderliche Felder dürfen jedoch nicht entfernt werden.

    Weitere Informationen zu den Cache-Richtlinieneinstellungen finden Sie unter Grundlegendes zu Cache-Richtlinien.

  3. Verwenden Sie den folgenden Befehl, um die Cache-Richtlinie mit Eingabeparametern aus der cache-policy.yaml-Datei zu erstellen.

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

    Notieren Sie den Id-Wert in der Ausgabe des Befehls. Dies ist die Cache-Richtlinien-ID, die Sie benötigen, um die Cache-Richtlinie an das Cache-Verhalten einer CloudFront-Verteilung anzufügen.

So fügen Sie eine Cache-Richtlinie an eine vorhandene Verteilung an (CLI mit Eingabedatei):

  1. Verwenden Sie den folgenden Befehl, um die Verteilungskonfiguration für die zu aktualisierende CloudFront-Verteilung zu speichern. Ersetzen Sie distribution_ID durch die ID der Verteilung.

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

  2. Öffnen Sie die Datei mit dem Namen dist-config.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei, indem Sie die folgenden Änderungen an jeder Cache-Verhaltensweise vornehmen, die Sie aktualisieren, um eine Cache-Richtlinie zu verwenden.

    • Fügen Sie in der Cache-Verhaltensweise ein Feld mit dem Namen hinz CachePolicyId. Verwenden Sie für den Wert des Feldes die Cache-Richtlinien-ID, die Sie nach dem Erstellen der Richtlinie notiert haben.

    • Entfernen Sie die Felder MinTTL, MaxTTL, DefaultTTL und ForwardedValues aus der Cache-Verhaltensweise. Diese Einstellungen werden in der Cache-Richtlinie angegeben, somit können Sie diese Felder und eine Cache-Richtlinie nicht in dasselbe Cache-Verhalten einschließen.

    • Benennen Sie das Feld ETag in IfMatch um, ändern Sie jedoch nicht den Wert des Feldes.

    Speichern Sie die Datei, wenn Sie fertig sind.

  3. Verwenden Sie den folgenden Befehl, um die Verteilung so zu aktualisieren, dass die Cache-Richtlinie verwendet wird. Ersetzen Sie distribution_ID durch die ID der Verteilung.

    
aws cloudfront update-distribution --id distribution_ID --cli-input-yaml file://dist-config.yaml
So fügen Sie eine Cache-Richtlinie an eine neue Verteilung an (CLI mit Eingabedatei):

  1. Verwenden Sie den folgenden Befehl, um eine Datei mit dem Namen distribution.yaml zu erstellen, die alle Eingabeparameter für den create-distribution-Befehl enthält.

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

  2. Öffnen Sie die Datei mit dem Namen distribution.yaml, die Sie gerade erstellt haben. Geben Sie im Standard-Cacheverhalten in das CachePolicyId-Feld die Cache-Richtlinien-ID ein, die Sie nach dem Erstellen der Richtlinie notiert haben. Fahren Sie mit der Bearbeitung der Datei fort, um die gewünschten Verteilungseinstellungen anzugeben, und speichern Sie die Datei, wenn Sie fertig sind.

    Weitere Informationen zu den Verteilungseinstellungen finden Sie unter Referenz für alle Distributionseinstellungen.

  3. Verwenden Sie den folgenden Befehl, um die Verteilung mit Eingabeparametern aus der Datei distribution.yaml zu erstellen.

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

Um eine Cache-Richtlinie mit der CloudFront-API zu erstellen, verwenden Sie CreateCachePolicy. Weitere Informationen zu den Feldern, die Sie in diesem API-Aufruf angeben, finden Sie unter Grundlegendes zu Cache-Richtlinien und in der API-Referenzdokumentation für Ihr AWS-SDK oder einen anderen API-Client.

Nachdem Sie eine Cache-Richtlinie erstellt haben, können Sie sie mit einem der folgenden API-Aufrufe an eine Cache-Verhaltensweise anfügen:

  • Verwenden Sie UpdateDistribution, um sie an eine Cache-Verhaltensweise in einer vorhandenen Verteilung anzufügen.

  • Um sie an ein Cache-Verhaltensweise in einer neuen Verteilung anzufügen, verwenden Sie CreateDistribution.

Geben Sie für beide API-Aufrufe die ID der Cache-Richtlinie im Feld CachePolicyId innerhalb eines Cache-Verhaltens an. Weitere Informationen zu den anderen Feldern, die Sie in diesen API-Aufrufen angeben, finden Sie unter Referenz für alle Distributionseinstellungen und in der API-Referenzdokumentation für Ihr AWS SDK oder einen anderen API-Client.