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

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.

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

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.

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:

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

   • 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 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

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.

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

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.

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'