Arbeiten Sie mit einer Richtlinie für Staging-Verteilung und kontinuierliche Bereitstellung - Amazon CloudFront
Erstellen Sie eine Staging-Verteilung mit einer Richtlinie für die kontinuierliche BereitstellungAktualisieren Sie eine Staging-VerteilungAktualisieren Sie eine Richtlinie für die kontinuierliche BereitstellungWerben Sie für eine Konfiguration der Staging-Verteilung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten Sie mit einer Richtlinie für Staging-Verteilung und kontinuierliche Bereitstellung

Sie können Staging-Verteilungen und Richtlinien für die kontinuierliche Bereitstellung in der CloudFront Konsole, mit der AWS Command Line Interface (AWS CLI) oder mit der CloudFront API erstellen, aktualisieren und ändern.

Erstellen Sie eine Staging-Verteilung mit einer Richtlinie für die kontinuierliche Bereitstellung

Die folgenden Verfahren zeigen Ihnen, wie Sie eine Staging-Verteilung mit einer kontinuierlichen Bereitstellungsrichtlinie erstellen.

Console

Sie können eine Staging-Verteilung mit einer kontinuierlichen Bereitstellungsrichtlinie erstellen, indem Sie die verwenden. AWS Management Console

So erstellen Sie eine Staging-Verteilung und eine Richtlinie für die kontinuierliche Bereitstellung (Konsole)

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CloudFront Konsole unterhttps://console.aws.amazon.com/cloudfront/v4/home.

  2. Rufen Sie im Navigationsbereich Distributions auf.

  3. Wählen Sie die Verteilung aus, die Sie als primäre Verteilung verwenden möchten. Die primäre Verteilung ist die Verteilung, die zurzeit für den Produktionsdatenverkehr zuständig ist. Aus dieser Verteilung erstellen Sie die Staging-Verteilung.

  4. Wählen Sie im Abschnitt Continuous deployment (Kontinuierliche Bereitstellung) die Option Create Staging Distribution (Staging-Verteilung erstellen) aus. Dadurch wird der Assistent Create Staging Distribution (Staging-Verteilung erstellen) geöffnet.

  5. Führen Sie im Assistenten Create Staging Distribution (Create Staging Distribution) folgende Schritte aus:

    1. (Optional) Geben Sie eine Beschreibung für die Staging-Verteilung ein.

    2. Wählen Sie Weiter aus.

    3. Ändern Sie die Konfiguration der Staging-Verteilung. Weitere Informationen zu den aktualisierbaren Einstellungen finden Sie unter Aktualisieren Sie die Primär- und Staging-Distributionen.

      Wenn Sie mit den Änderungen an der Konfiguration der Staging-Verteilung fertig sind, wählen Sie Next (Weiter) aus.

    4. Geben Sie über die Konsole die Traffic configuration (Datenverkehrskonfiguration) an. Dadurch wird bestimmt, wie der CloudFront Datenverkehr an die Staging-Verteilung weitergeleitet wird. (CloudFront Speichert die Verkehrskonfiguration in einer Richtlinie für die kontinuierliche Bereitstellung.)

      Weitere Informationen zu den Optionen für die Datenverkehrskonfiguration finden Sie unter Anfragen an die Staging-Distribution weiterleiten.

      Wenn Sie die Traffic configuration (Datenverkehrskonfiguration) abgeschlossen haben, wählen Sie Next (Weiter) aus.

    5. Überprüfen Sie die Konfiguration der Staging-Verteilung, einschließlich der Datenverkehrskonfiguration, und wählen Sie dann Create Staging Distribution (Staging-Verteilung erstellen) aus.

Wenn Sie den Assistenten zum Erstellen einer Staging-Verteilung in der CloudFront Konsole abgeschlossen haben, CloudFront geht er wie folgt vor:

  • Erstellen einer Staging-Verteilung mit den von Ihnen (in Schritt 5c) angegebenen Einstellungen

  • Erstellen einer Richtlinie für die kontinuierliche Bereitstellung mit der von Ihnen (in Schritt 5d) angegebenen Datenverkehrskonfiguration

  • Anfügen der Richtlinie für die kontinuierliche Bereitstellung an die primäre Verteilung, aus der Sie die Staging-Verteilung erstellt haben

Wenn die Konfiguration der Primärverteilung mit der beigefügten Continuous Deployment Policy an Edge-Standorten bereitgestellt wird, CloudFront beginnt das Senden des angegebenen Datenverkehrs auf der Grundlage der Verkehrskonfiguration an die Staging-Verteilung.

CLI

Gehen Sie wie folgt vor, um eine Staging-Verteilung und eine Richtlinie für die kontinuierliche Bereitstellung mit der AWS CLI zu erstellen.

So erstellen Sie eine Staging-Verteilung (CLI)

  1. Verwenden Sie die Befehle aws cloudfront get-distribution und grep gemeinsam, um den ETag-Wert der Verteilung zu ermitteln, die Sie als primäre Verteilung verwenden möchten. Die primäre Verteilung ist die Verteilung, die zurzeit für den Produktionsdatenverkehr zuständig ist. Aus dieser Verteilung erstellen Sie die Staging-Verteilung.

    Im Folgenden wird ein Beispielbefehl gezeigt. Ersetzen Sie im folgenden Beispiel primary_distribution_ID durch die ID der primären Verteilung. 

    
aws cloudfront get-distribution --id primary_distribution_ID | grep 'ETag'

    Kopieren Sie den ETag-Wert, da Sie ihn für den folgenden Schritt benötigen.

  2. Verwenden Sie den Befehl aws cloudfront copy-distribution, um eine Staging-Verteilung zu erstellen. Im folgenden Beispielbefehl werden zur besseren Lesbarkeit Escape-Zeichen (\) und Zeilenumbrüche verwendet, Sie sollten diese jedoch im Befehl weglassen. Beachten Sie in dem Beispielbefehl Folgendes:

    • Ersetzen Sie primary_distribution_ID durch die ID der primären Verteilung.

    • Ersetzen Sie primary_distribution_ETag durch den ETag-Wert der primären Verteilung (den Sie im vorherigen Schritt ermittelt haben).

    • (Optional) Ersetzen Sie CLI_example durch die gewünschte Aufruferreferenz-ID.

    
aws cloudfront copy-distribution --primary-distribution-id primary_distribution_ID \
                                 --if-match primary_distribution_ETag \
                                 --staging \
                                 --caller-reference 'CLI_example'

    Die Ausgabe des Befehls enthält Informationen über die Staging-Verteilung und ihre Konfiguration. Kopieren Sie den CloudFront Domainnamen der Staging-Distribution, da Sie ihn für einen folgenden Schritt benötigen.

So erstellen Sie eine Richtlinie für die kontinuierliche Bereitstellung (CLI mit Eingabedatei)

  1. Verwenden Sie den folgenden Befehl, um eine Datei mit dem Namen continuous-deployment-policy.yaml zu erstellen, die alle Eingabeparameter für den Befehl create-continuous-deployment-policy enthält. Im folgenden Befehl werden zur besseren Lesbarkeit Escape-Zeichen (\) und Zeilenumbrüche verwendet, Sie sollten diese jedoch im Befehl weglassen.

    
aws cloudfront create-continuous-deployment-policy --generate-cli-skeleton yaml-input \
                                                   > continuous-deployment-policy.yaml

  2. Öffnen Sie die Datei mit dem Namen continuous-deployment-policy.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei, um die gewünschten Einstellungen für die Richtlinie für die kontinuierliche Bereitstellung anzugeben, und speichern Sie die Datei. Gehen Sie beim Bearbeiten der Datei wie folgt vor:

    • Im Abschnitt StagingDistributionDnsNames:

      • Ändern Sie den Wert von Quantity in 1.

      • Fügen Sie für Items den CloudFront Domainnamen der Staging-Distribution (den Sie aus einem vorherigen Schritt gespeichert haben) ein.

    • Im Abschnitt TrafficConfig:

      • Wählen Sie einen Type aus, entweder SingleWeight oder SingleHeader.

      • Entfernen Sie die Einstellungen für den anderen Typ. Wenn Sie beispielsweise eine gewichtete Datenverkehrskonfiguration wünschen, legen Sie für Type SingleWeight fest und entfernen Sie dann die Einstellungen für SingleHeaderConfig.

      • Um eine gewichtete Datenverkehrskonfiguration zu verwenden, legen Sie als Wert für Weight eine Dezimalzahl zwischen .01 (ein Prozent) und .15 (fünfzehn Prozent) fest.

      Weitere Informationen zu den Optionen in TrafficConfig finden Sie unter Anfragen an die Staging-Distribution weiterleiten und Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen.

  3. Verwenden Sie den folgenden Befehl, um die Richtlinie für die kontinuierliche Bereitstellung unter Verwendung von Eingabeparametern aus der Datei continuous-deployment-policy.yaml zu erstellen.

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

    Kopieren Sie den Id-Wert in die Ausgabe des Befehls. Dies ist die ID der Richtlinie für die kontinuierliche Bereitstellung, die Sie in einem nachfolgenden Schritt benötigen werden.

So fügen Sie eine Richtlinie für die kontinuierliche Bereitstellung an eine primäre Verteilung an (CLI mit Eingabedatei)

  1. Verwenden Sie den folgenden Befehl, um die Konfiguration der primären Verteilung in einer Datei namens primary-distribution.yaml zu speichern. Ersetzen Sie primary_distribution_ID durch die ID der primären Verteilung.

    
aws cloudfront get-distribution-config --id primary_distribution_ID --output yaml > primary-distribution.yaml

  2. Öffnen Sie die Datei mit dem Namen primary-distribution.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei und nehmen Sie die folgenden Änderungen vor:

    • Fügen Sie die ID der Richtlinie für die kontinuierliche Bereitstellung (die Sie aus einem vorherigen Schritt kopiert haben) in das Feld ContinuousDeploymentPolicyId ein.

    • 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 primäre Verteilung so zu aktualisieren, dass die Richtlinie für die kontinuierliche Bereitstellung verwendet wird. Ersetzen Sie primary_distribution_ID durch die ID der primären Verteilung.

    
aws cloudfront update-distribution --id primary_distribution_ID --cli-input-yaml file://primary-distribution.yaml

Wenn die Konfiguration der Primärverteilung mit der beigefügten Continuous Deployment Policy an Edge-Standorten bereitgestellt wird, CloudFront beginnt der Versand des angegebenen Datenverkehrs an die Staging-Verteilung, basierend auf der Verkehrskonfiguration.

API

Verwenden Sie die folgenden API-Operationen, um mit der CloudFront API eine Richtlinie für die Staging-Verteilung und kontinuierliche Bereitstellung zu erstellen:

Weitere Informationen zu den Feldern, die Sie in diesen API-Aufrufen angeben, finden Sie:

Nachdem Sie eine Staging-Verteilung und eine Continuous Deployment Policy erstellt haben, verwenden Sie UpdateDistribution(auf der Primärdistribution), um die Continuous Deployment Policy der Primärdistribution zuzuordnen.

Aktualisieren Sie eine Staging-Verteilung

Die folgenden Verfahren zeigen Ihnen, wie Sie eine Staging-Verteilung mit einer kontinuierlichen Bereitstellungsrichtlinie aktualisieren.

Console

Sie können bestimmte Konfigurationen sowohl für die Primär- als auch für die Staging-Distribution aktualisieren. Weitere Informationen finden Sie unter Aktualisieren Sie die Primär- und Staging-Distributionen.

So aktualisieren Sie eine Staging-Verteilung (Konsole)

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

  2. Rufen Sie im Navigationsbereich Distributions auf.

  3. Wählen Sie die primäre Verteilung aus. Dies ist die Verteilung, die zurzeit für den Produktionsdatenverkehr zuständig ist. Aus dieser Verteilung haben Sie die Staging-Verteilung erstellt.

  4. Wählen Sie View Staging Distribution (Staging-Verteilung anzeigen) aus.

  5. Ändern Sie die Konfiguration der Staging-Verteilung über die Konsole. Weitere Informationen zu den aktualisierbaren Einstellungen finden Sie unter Aktualisieren Sie die Primär- und Staging-Distributionen.

Sobald die Konfiguration der Staging-Verteilung an Edge-Standorten bereitgestellt ist, wird sie für den eingehenden Datenverkehr wirksam, der an die Staging-Verteilung weitergeleitet wird.

CLI
So aktualisieren Sie eine Staging-Verteilung (CLI mit Eingabedatei)

  1. Verwenden Sie den folgenden Befehl, um die Konfiguration der Staging-Verteilung in einer Datei namens staging-distribution.yaml zu speichern. Ersetzen Sie staging_distribution_ID durch die ID der Staging-Verteilung.

    
aws cloudfront get-distribution-config --id staging_distribution_ID --output yaml > staging-distribution.yaml

  2. Öffnen Sie die Datei mit dem Namen staging-distribution.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei und nehmen Sie die folgenden Änderungen vor:

    Speichern Sie die Datei, wenn Sie fertig sind.

  3. Verwenden Sie den folgenden Befehl, um die Konfiguration der Staging-Verteilung zu aktualisieren. Ersetzen Sie staging_distribution_ID durch die ID der Staging-Verteilung.

    
aws cloudfront update-distribution --id staging_distribution_ID --cli-input-yaml file://staging-distribution.yaml

Sobald die Konfiguration der Staging-Verteilung an Edge-Standorten bereitgestellt ist, wird sie für den eingehenden Datenverkehr wirksam, der an die Staging-Verteilung weitergeleitet wird.

API

Um die Konfiguration einer Staging-Distribution zu aktualisieren, verwenden Sie UpdateDistribution(auf der Staging-Distribution), um die Konfiguration der Staging-Distribution zu ändern. Weitere Informationen zu den aktualisierbaren Einstellungen finden Sie unter Aktualisieren Sie die Primär- und Staging-Distributionen.

Aktualisieren Sie eine Richtlinie für die kontinuierliche Bereitstellung

Die folgenden Verfahren zeigen Ihnen, wie Sie eine Richtlinie für die kontinuierliche Bereitstellung aktualisieren.

Console

Sie können die Datenverkehrskonfiguration Ihrer Distribution aktualisieren, indem Sie die Continuous Deployment Policy aktualisieren.

So aktualisieren Sie eine Richtlinie für die kontinuierliche Bereitstellung (Konsole)

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

  2. Rufen Sie im Navigationsbereich Distributions auf.

  3. Wählen Sie die primäre Verteilung aus. Dies ist die Verteilung, die zurzeit für den Produktionsdatenverkehr zuständig ist. Aus dieser Verteilung haben Sie die Staging-Verteilung erstellt.

  4. Wählen Sie im Abschnitt Continuous deployment (Kontinuierliche Bereitstellung) Edit policy (Richtlinie bearbeiten) aus.

  5. Ändern Sie die Datenverkehrskonfiguration in der Richtlinie für die kontinuierliche Bereitstellung. Klicken Sie auf Save changes (Änderungen speichern), wenn Sie fertig sind.

Wenn die Konfiguration der Primärverteilung mit der aktualisierten Continuous Deployment Policy an Edge-Standorten bereitgestellt wird, CloudFront beginnt das Senden von Datenverkehr an die Staging-Verteilung auf der Grundlage der aktualisierten Datenverkehrskonfiguration.

CLI
So aktualisieren Sie eine Richtlinie für die kontinuierliche Bereitstellung (CLI mit Eingabedatei)

  1. Verwenden Sie den folgenden Befehl, um die Konfiguration der Richtlinie für die kontinuierliche Bereitstellung in einer Datei namens continuous-deployment-policy.yaml zu speichern. Ersetzen Sie continuous_deployment_policy_ID durch die ID der Richtlinie für die kontinuierliche Bereitstellung. Im folgenden Befehl werden zur besseren Lesbarkeit Escape-Zeichen (\) und Zeilenumbrüche verwendet, Sie sollten diese jedoch im Befehl weglassen.

    
aws cloudfront get-continuous-deployment-policy-config --id continuous_deployment_policy_ID \
                                                       --output yaml > continuous-deployment-policy.yaml

  2. Öffnen Sie die Datei mit dem Namen continuous-deployment-policy.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei und nehmen Sie die folgenden Änderungen vor:

    • Ändern Sie die Konfiguration der Richtlinie für die kontinuierliche Bereitstellung wie gewünscht. Sie können beispielsweise von einer Header-basierten zu einer gewichteten Datenverkehrskonfiguration übergehen oder den Prozentsatz des Datenverkehrs (Gewichtung) durch eine gewichtete Konfiguration ersetzen. Weitere Informationen finden Sie unter Anfragen an die Staging-Distribution weiterleiten und Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen.

    • 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 Richtlinie für die kontinuierliche Bereitstellung zu aktualisieren. Ersetzen Sie continuous_deployment_policy_ID durch die ID der Richtlinie für die kontinuierliche Bereitstellung. Im folgenden Befehl werden zur besseren Lesbarkeit Escape-Zeichen (\) und Zeilenumbrüche verwendet, Sie sollten diese jedoch im Befehl weglassen.

    
aws cloudfront update-continuous-deployment-policy --id continuous_deployment_policy_ID \
                                                   --cli-input-yaml file://continuous-deployment-policy.yaml

Wenn die Konfiguration der Primärverteilung mit der aktualisierten Richtlinie für die kontinuierliche Bereitstellung an Edge-Standorten bereitgestellt wird, CloudFront beginnt das Senden von Datenverkehr an die Staging-Verteilung auf der Grundlage der aktualisierten Verkehrskonfiguration.

API

Um eine Richtlinie für die kontinuierliche Bereitstellung zu aktualisieren, verwenden Sie. UpdateContinuousDeploymentPolicy

Werben Sie für eine Konfiguration der Staging-Verteilung

Die folgenden Verfahren zeigen Ihnen, wie Sie eine Staging-Verteilungskonfiguration heraufstufen.

Console

Wenn Sie eine Staging-Verteilung heraufstufen, wird die Konfiguration von der Staging-Distribution in die Primärverteilung CloudFront kopiert. CloudFront deaktiviert außerdem die Continuous Deployment Policy und leitet den gesamten Datenverkehr an die Primärverteilung weiter.

Nachdem Sie eine Konfiguration hochgestuft haben, können Sie die betreffende Staging-Verteilung erneut verwenden, wenn Sie das nächste Mal eine Konfigurationsänderung testen möchten.

So stufen Sie die Konfiguration einer Staging-Verteilung hoch (Konsole)

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

  2. Rufen Sie im Navigationsbereich Distributions auf.

  3. Wählen Sie die primäre Verteilung aus. Dies ist die Verteilung, die zurzeit für den Produktionsdatenverkehr zuständig ist. Aus dieser Verteilung haben Sie die Staging-Verteilung erstellt.

  4. Wählen Sie im Abschnitt Continuous deployment (Kontinuierliche Bereitstellung) Promote (Hochstufen) aus.

  5. Geben Sie confirm ein und wählen Sie dann Promote (Hochstufen) aus.

CLI

Wenn Sie eine Staging-Distribution heraufstufen, CloudFront kopiert die Konfiguration aus der Staging-Distribution in die primäre Distribution. CloudFront deaktiviert außerdem die Continuous Deployment Policy und leitet den gesamten Datenverkehr an die Primärverteilung weiter.

Nachdem Sie eine Konfiguration hochgestuft haben, können Sie die betreffende Staging-Verteilung erneut verwenden, wenn Sie das nächste Mal eine Konfigurationsänderung testen möchten.

So stufen Sie die Konfiguration einer Staging-Verteilung hoch (CLI)

  • Verwenden Sie den Befehl aws cloudfront update-distribution-with-staging-config, um die Konfiguration der Staging-Verteilung auf die primäre Verteilung hochzustufen. Im folgenden Beispielbefehl werden zur besseren Lesbarkeit Escape-Zeichen (\) und Zeilenumbrüche verwendet, Sie sollten diese jedoch im Befehl weglassen. Beachten Sie in dem Beispielbefehl Folgendes:

    • Ersetzen Sie primary_distribution_ID durch die ID der primären Verteilung.

    • Ersetzen Sie staging_distribution_ID durch die ID der Staging-Verteilung.

    • Ersetzen Sie primary_distribution_ETag und staging_distribution_ETag durch die ETag-Werte der primären Verteilung und der Staging-Verteilung. Stellen Sie sicher, dass der Wert der primären Verteilung an erster Stelle steht, wie im Beispiel dargestellt.

    
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

Um die Konfiguration einer Staging-Distribution auf die Primärdistribution hochzustufen, verwenden Sie. UpdateDistributionWithStagingConfig