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. # Verwenden Sie CloudFront Continuous Deployment, um CDN-Konfigurationsänderungen sicher zu testen Mit Amazon CloudFront *Continuous Deployment* können Sie Änderungen an Ihrer CDN-Konfiguration sicher implementieren, indem Sie zunächst mit einer Teilmenge des Produktionsdatenverkehrs testen. Sie können eine *Staging-Verteilung* und eine *Richtlinie für die kontinuierliche Bereitstellung* verwenden, um einen Teil des Datenverkehrs von tatsächlichen Viewern (in der Produktion) an die neue CDN-Konfiguration zu senden und zu überprüfen, ob diese wie erwartet funktioniert. Sie können die Leistung der neuen Konfiguration in Echtzeit überwachen und, wenn Sie bereit sind, die neue Konfiguration so hochstufen, dass sie für den gesamten Datenverkehr über die *primäre Verteilung* gilt. Das folgende Diagramm zeigt die Vorteile der CloudFront kontinuierlichen Bereitstellung. Ohne diese Funktionalität müssten Sie CDN-Konfigurationsänderungen mit simuliertem Datenverkehr testen. Bei Verwendung der kontinuierlichen Bereitstellung können Sie die Änderungen an einem Teil des Produktionsdatenverkehrs testen und dann auf die primäre Verteilung hochstufen, wenn Sie dazu bereit sind. ![\[Grafik der CloudFront kontinuierlichen Bereitstellung, bei der der Produktionsdatenverkehr an eine Staging-Verteilung weitergeleitet wird.\]](http://docs.aws.amazon.com/de_de/AmazonCloudFront/latest/DeveloperGuide/images/cloudfront-continuous-deployment.png) In den folgenden Themen erfahren Sie mehr über die Arbeit mit kontinuierlicher Bereitstellung. **Topics** + [ # CloudFront kontinuierlicher Bereitstellungs-Workflow ](continuous-deployment-workflow.md) + [ # Arbeiten mit einer Staging-Distribution und einer Richtlinie für die kontinuierliche Bereitstellung ](working-with-staging-distribution-continuous-deployment-policy.md) + [ # Überwachen einer Staging-Distribution ](monitoring-staging-distribution.md) + [ # Informationen zur kontinuierlichen Bereitstellung ](understanding-continuous-deployment.md) + [ # Kontingente und andere zu berücksichtigende Aspekte bei der kontinuierlichen Bereitstellung ](continuous-deployment-quotas-considerations.md) # CloudFront kontinuierlicher Bereitstellungs-Workflow Der folgende allgemeine Arbeitsablauf erklärt, wie Sie Konfigurationsänderungen bei CloudFront kontinuierlicher Bereitstellung sicher testen und bereitstellen können. 1. 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. 1. Erstellen Sie von der primären Verteilung ausgehend eine *Staging-Verteilung*. Eine Staging-Verteilung ist zunächst eine Kopie der primären Verteilung. 1. Erstellen Sie eine *Datenverkehrskonfiguration* in einer *Richtlinie für die kontinuierliche Bereitstellung* und fügen Sie diese der primären Verteilung an. Dadurch wird bestimmt, wie CloudFront der Verkehr an die Staging-Verteilung weitergeleitet wird. Weitere Informationen zum Weiterleiten von Anforderungen an eine Staging-Verteilung finden Sie unter [Weiterleiten von Anforderungen an die Staging-Distribution](understanding-continuous-deployment.md#understanding-continuous-deployment-routing). 1. Aktualisieren Sie die Konfiguration der Staging-Verteilung. Weitere Informationen zu den aktualisierbaren Einstellungen finden Sie unter [Aktualisieren der primären Distribution und der Staging-Distribution](understanding-continuous-deployment.md#updating-staging-and-primary-distributions). 1. Überwachen Sie die Staging-Verteilung, um festzustellen, ob die Konfigurationsänderungen erwartungsgemäß funktionieren. Weitere Informationen zum Überwachen einer Staging-Verteilung finden Sie unter [Überwachen einer Staging-Distribution](monitoring-staging-distribution.md). Während der Überwachung der Staging-Verteilung können Sie folgende Aktionen ausführen: + Erneutes Aktualisieren der Konfiguration der Staging-Verteilung, um die Konfigurationsänderungen weiter zu testen + Aktualisieren der Richtlinie für die kontinuierliche Bereitstellung (Datenverkehrskonfiguration), um mehr oder weniger Datenverkehr an die Staging-Verteilung zu senden 1. Wenn Sie mit der Leistung der Staging-Verteilung zufrieden sind, können Sie die Konfiguration der Staging-Verteilung auf die primäre Verteilung *hochstufen*. Dabei wird die Konfiguration der Staging-Verteilung in die primäre Verteilung kopiert. Dadurch wird auch die Continuous Deployment Policy deaktiviert, was bedeutet, dass der gesamte CloudFront Datenverkehr an die primäre Verteilung weitergeleitet wird. Sie können eine Automatisierung erstellen, die die Leistung der Staging-Verteilung überwacht (Schritt 5) und die Konfiguration automatisch hochstuft (Schritt 6), wenn bestimmte Kriterien erfüllt sind. 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. Weitere Informationen zum Arbeiten mit Staging-Verteilungen und Richtlinien für die kontinuierliche Bereitstellung in der CloudFront Konsole AWS CLI, der oder der CloudFront API finden Sie im folgenden Abschnitt. # Arbeiten mit einer Staging-Distribution und einer Richtlinie für die 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 einer Staging-Distribution und einer Richtlinie für die kontinuierliche Bereitstellung Die folgenden Verfahren zeigen Ihnen, wie Sie mit einer Richtlinie für die kontinuierliche Bereitstellung eine Staging-Distribution erstellen. ------ #### [ Console ] Sie können eine Staging-Distribution mit einer Richtlinie für die kontinuierliche Bereitstellung erstellen, indem Sie die AWS-Managementkonsole verwenden. **So erstellen Sie eine Staging-Verteilung und eine Richtlinie für die kontinuierliche Bereitstellung (Konsole)** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudFront Konsole unter. [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home) 1. Rufen Sie im Navigationsbereich **Distributions** auf. 1. 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. 1. 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. 1. 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. 1. Wählen Sie **Weiter** aus. 1. Ändern Sie die Konfiguration der Staging-Verteilung. Weitere Informationen zu den aktualisierbaren Einstellungen finden Sie unter [Aktualisieren der primären Distribution und der Staging-Distribution](understanding-continuous-deployment.md#updating-staging-and-primary-distributions). Wenn Sie mit den Änderungen an der Konfiguration der Staging-Verteilung fertig sind, wählen Sie **Next** (Weiter) aus. 1. Geben Sie über die Konsole die **Traffic configuration** (Datenverkehrskonfiguration) an. Dies 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 [Weiterleiten von Anforderungen an die Staging-Distribution](understanding-continuous-deployment.md#understanding-continuous-deployment-routing). Wenn Sie die **Traffic configuration** (Datenverkehrskonfiguration) abgeschlossen haben, wählen Sie **Next** (Weiter) aus. 1. Ü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. Im folgenden Beispiel ersetzen Sie es *primary\$1distribution\$1ID* durch die ID der Primärdistribution. ``` 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. 1. Verwenden Sie den Befehl **aws cloudfront copy-distribution**, um eine Staging-Verteilung zu erstellen. Im folgenden Beispielbefehl werden zur besseren Lesbarkeit Escape-Zeichen (\$1) und Zeilenumbrüche verwendet, Sie sollten diese jedoch im Befehl weglassen. Beachten Sie in dem Beispielbefehl Folgendes: + *primary\$1distribution\$1ID*Ersetzen Sie es durch die ID der Primärdistribution. + *primary\$1distribution\$1ETag*Ersetzen Sie durch den `ETag` Wert der Primärverteilung (den Sie im vorherigen Schritt erhalten haben). + (Optional) *CLI\$1example* Ersetzen Sie durch die gewünschte Anruferreferenz-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 (\$1) 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 ``` 1. Ö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 [Weiterleiten von Anforderungen an die Staging-Distribution](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) und [Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions). 1. 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. *primary\$1distribution\$1ID*Ersetzen Sie ihn durch die ID der Primärdistribution. ``` aws cloudfront get-distribution-config --id primary_distribution_ID --output yaml > primary-distribution.yaml ``` 1. Ö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. 1. Verwenden Sie den folgenden Befehl, um die primäre Verteilung so zu aktualisieren, dass die Richtlinie für die kontinuierliche Bereitstellung verwendet wird. Ersetze es *primary\$1distribution\$1ID* durch die ID der Primärdistribution. ``` 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, den angegebenen Teil des Datenverkehrs auf der Grundlage der Verkehrskonfiguration an die Staging-Verteilung zu senden. ------ #### [ API ] Verwenden Sie die folgenden API-Operationen, um mit der CloudFront API eine Richtlinie für die Staging-Verteilung und kontinuierliche Bereitstellung zu erstellen: + [CopyDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CopyDistribution.html) + [CreateContinuousDeploymentPolicy](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateContinuousDeploymentPolicy.html) Weitere Informationen zu den Feldern, die Sie in diesen API-Aufrufen angeben, finden Sie: + [Weiterleiten von Anforderungen an die Staging-Distribution](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) + [Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions) + Die API-Referenzdokumentation für Ihr AWS SDK oder einen anderen API-Client Nachdem Sie eine Staging-Verteilung und eine Continuous Deployment Policy erstellt haben, verwenden Sie [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(auf der Primärdistribution), um die Continuous Deployment Policy der Primärdistribution zuzuordnen. ------ ## Aktualisieren einer Staging-Distribution Die folgenden Verfahren zeigen Ihnen, wie Sie mit einer Richtlinie für die kontinuierliche Bereitstellung eine Staging-Distribution aktualisieren. ------ #### [ Console ] Sie können bestimmte Konfigurationen sowohl für die primäre Distribution als auch für die Staging-Distribution aktualisieren. Weitere Informationen finden Sie unter [Aktualisieren der primären Distribution und der Staging-Distribution](understanding-continuous-deployment.md#updating-staging-and-primary-distributions). **So aktualisieren Sie eine Staging-Verteilung (Konsole)** 1. Öffnen Sie die CloudFront Konsole unter. [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home) 1. Rufen Sie im Navigationsbereich **Distributions** auf. 1. 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. 1. Wählen Sie **View Staging Distribution** (Staging-Verteilung anzeigen) aus. 1. Ändern Sie die Konfiguration der Staging-Verteilung über die Konsole. Weitere Informationen zu den aktualisierbaren Einstellungen finden Sie unter [Aktualisieren der primären Distribution und der Staging-Distribution](understanding-continuous-deployment.md#updating-staging-and-primary-distributions). 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. *staging\$1distribution\$1ID*Ersetzen Sie es durch die ID der Staging-Distribution. ``` aws cloudfront get-distribution-config --id staging_distribution_ID --output yaml > staging-distribution.yaml ``` 1. Ö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 der primären Distribution und der Staging-Distribution](understanding-continuous-deployment.md#updating-staging-and-primary-distributions). + Benennen Sie das Feld `ETag` in `IfMatch` um, ändern Sie jedoch nicht den Wert des Feldes. Speichern Sie die Datei, wenn Sie fertig sind. 1. Verwenden Sie den folgenden Befehl, um die Konfiguration der Staging-Verteilung zu aktualisieren. Ersetzen Sie es *staging\$1distribution\$1ID* durch die ID der Staging-Distribution. ``` 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](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(auf der Staging-Distribution), um die Konfiguration der Staging-Distribution zu ändern. Weitere Informationen zu den aktualisierbaren Einstellungen finden Sie unter [Aktualisieren der primären Distribution und der Staging-Distribution](understanding-continuous-deployment.md#updating-staging-and-primary-distributions). ------ ## Aktualisieren einer 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 Richtlinie für die kontinuierliche Bereitstellung aktualisieren. **So aktualisieren Sie eine Richtlinie für die kontinuierliche Bereitstellung (Konsole)** 1. Öffnen Sie die Konsole unter CloudFront . [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home) 1. Rufen Sie im Navigationsbereich **Distributions** auf. 1. 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. 1. Wählen Sie im Abschnitt **Continuous deployment** (Kontinuierliche Bereitstellung) **Edit policy** (Richtlinie bearbeiten) aus. 1. Ä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 es *continuous\$1deployment\$1policy\$1ID* durch die ID der Continuous Deployment Policy. Im folgenden Befehl werden zur besseren Lesbarkeit Escape-Zeichen (\$1) 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 ``` 1. Ö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 erhalten Sie unter [Weiterleiten von Anforderungen an die Staging-Distribution](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) und [Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions). + Benennen Sie das Feld `ETag` in `IfMatch` um, ändern Sie jedoch nicht den Wert des Feldes. Speichern Sie die Datei, wenn Sie fertig sind. 1. Verwenden Sie den folgenden Befehl, um die Richtlinie für die kontinuierliche Bereitstellung zu aktualisieren. *continuous\$1deployment\$1policy\$1ID*Ersetzen Sie es durch die ID der Richtlinie für die kontinuierliche Bereitstellung. Im folgenden Befehl werden zur besseren Lesbarkeit Escape-Zeichen (\$1) 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 Continuous Deployment Policy 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](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateContinuousDeploymentPolicy.html) ------ ## Hochstufen der Konfiguration einer Staging-Distribution Die folgenden Verfahren zeigen Ihnen, wie Sie die Konfiguration einer Staging-Distribution hochstufen. ------ #### [ Console ] *Wenn Sie eine Staging-Distribution heraufstufen, wird die Konfiguration von der Staging-Distribution in die primäre Distribution 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](https://console.aws.amazon.com/cloudfront/v4/home) 1. Rufen Sie im Navigationsbereich **Distributions** auf. 1. 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. 1. Wählen Sie im Abschnitt **Continuous deployment** (Kontinuierliche Bereitstellung) **Promote** (Hochstufen) aus. 1. 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 (\$1) und Zeilenumbrüche verwendet, Sie sollten diese jedoch im Befehl weglassen. Beachten Sie in dem Beispielbefehl Folgendes: + *primary\$1distribution\$1ID*Ersetzen Sie es durch die ID der Primärverteilung. + *staging\$1distribution\$1ID*Ersetzen Sie es durch die ID der Staging-Distribution. + Ersetzen Sie *primary\$1distribution\$1ETag* und *staging\$1distribution\$1ETag* durch die `ETag` Werte der Primär- und Stagingverteilung. 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](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistributionWithStagingConfig.html) ------ # Überwachen einer Staging-Distribution Um die Leistung einer Staging-Verteilung zu überwachen, können Sie dieselben [Metriken, Protokolle und Berichte verwenden,](reports-and-monitoring.md) die für alle Verteilungen CloudFront verfügbar sind. Beispiel: + Sie können die [ CloudFrontStandard-Verteilungsmetriken](viewing-cloudfront-metrics.md#monitoring-console.distributions) (wie Gesamtzahl der Anfragen und Fehlerrate) in der CloudFront Konsole anzeigen und [gegen Aufpreis zusätzliche Messwerte (wie Cache-Trefferrate und Fehlerrate nach Statuscode) aktivieren](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional). Zudem können Sie Alarme basierend auf diesen Metriken erstellen. + Sie können [Standardprotokolle und Zugriffsprotokolle](AccessLogs.md) [in Echtzeit](real-time-logs.md) einsehen, um detaillierte Informationen zu den Anfragen zu erhalten, die bei der Staging-Verteilung eingehen. Standardprotokolle enthalten die folgenden beiden Felder, anhand derer Sie die primäre Distribution identifizieren können, an die die Anforderung ursprünglich gesendet wurde, bevor sie an die Staging-Verteilung CloudFront weitergeleitet wurde: und. `primary-distribution-id` `primary-distribution-dns-name` + In der CloudFront Konsole können Sie [Berichte](reports.md) anzeigen und herunterladen, z. B. den Cache-Statistikbericht. # Informationen zur kontinuierlichen Bereitstellung In den folgenden Themen wird erklärt, wie CloudFront Continuous Deployment funktioniert. **Topics** + [ ## Weiterleiten von Anforderungen an die Staging-Distribution ](#understanding-continuous-deployment-routing) + [ ## Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen ](#understanding-continuous-deployment-sessions) + [ ## Aktualisieren der primären Distribution und der Staging-Distribution ](#updating-staging-and-primary-distributions) + [ ## Primäre Verteilungen und Staging-Verteilungen nutzen nicht denselben Cache ](#staging-and-primary-no-shared-cache) ## Weiterleiten von Anforderungen an die Staging-Distribution Wenn Sie CloudFront Continuous Deployment verwenden, müssen Sie nichts an den Viewer-Anfragen ändern. Viewer haben nicht die Möglichkeit, unter Verwendung eines DNS-Namens, einer IP-Adresse oder eines CNAME Anforderungen direkt an eine Staging-Verteilung zu senden. Stattdessen senden Zuschauer Anfragen an die primäre (Produktions-) Distribution und leiten einige dieser Anfragen auf CloudFront der Grundlage der Datenverkehrskonfigurationse instellungen in der Continuous Deployment Policy an die Staging-Distribution weiter. Es gibt zwei Arten von Datenverkehrskonfigurationen: **Gewichtet** Bei einer gewichtsbasierten Konfiguration wird der angegebene Prozentsatz der Viewer-Anforderungen an die Staging-Verteilung weitergeleitet. Wenn Sie eine gewichtsbasierte Konfiguration verwenden, können Sie auch die *Sitzungsbindung aktivieren, wodurch* sichergestellt wird, dass Anfragen desselben Betrachters als Teil einer einzigen Sitzung CloudFront behandelt werden. Weitere Informationen finden Sie unter [Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen](#understanding-continuous-deployment-sessions). **Header-basiert** Bei einer Header-basierten Konfiguration werden Anforderungen an die Staging-Verteilung weitergeleitet, wenn die Viewer-Anforderung einen bestimmten HTTP-Header enthält (den Header und Wert geben Sie selbst an). Anforderungen, die den angegebenen Header und Wert nicht enthalten, werden an die primäre Verteilung weitergeleitet. Diese Konfiguration ist hilfreich, wenn Sie lokale Tests durchführen oder die Kontrolle über die Viewer-Anforderungen haben. Header, die an Ihre Staging-Verteilung weitergeleitet werden, müssen das Präfix `aws-cf-cd-` enthalten. ## Sitzungs-Stickiness bei gewichtsbasierten Konfigurationen Wenn Sie eine gewichtsbasierte Konfiguration verwenden, um Traffic an eine Staging-Verteilung weiterzuleiten, können Sie auch die *Sitzungsbindung aktivieren, wodurch sichergestellt wird*, dass Anfragen von demselben Viewer als eine einzelne Sitzung CloudFront behandelt werden. Wenn Sie Session Stickiness aktivieren, CloudFront wird ein Cookie gesetzt, sodass alle Anfragen desselben Viewers in einer einzigen Sitzung von einer Distribution bedient werden, entweder von der Primär- oder der Staging-Distribution. Wenn Sie Sitzungs-Stickiness aktivieren, können Sie auch die Leerlaufdauer (*idle duration*) angeben. Wenn der Viewer für diese Zeit inaktiv ist (keine Anfragen sendet), läuft die Sitzung ab und CloudFront behandelt future Anfragen von diesem Viewer als neue Sitzung. Sie geben die Leerlaufdauer in Sekunden an. Möglich sind dabei Werte von 300 (fünf Minuten) bis 3 600 Sekunden (einer Stunde). CloudFront Setzt in den folgenden Fällen alle Sitzungen (auch aktive) zurück und betrachtet alle Anfragen als neue Sitzung: + Sie deaktivieren oder aktivieren die Richtlinie für die kontinuierliche Bereitstellung. + Sie deaktivieren oder aktivieren die Einstellung für Sitzungs-Stickiness. ## Aktualisieren der primären Distribution und der Staging-Distribution Wenn einer primären Verteilung eine Richtlinie für die kontinuierliche Bereitstellung angefügt ist, sind die folgenden Konfigurationsänderungen sowohl für die primäre Verteilung als auch für die Staging-Verteilung verfügbar: + Alle Einstellungen in Bezug auf das Cache-Verhalten, einschließlich des Standard-Cache-Verhaltens + Alle Ursprungseinstellungen (Ursprünge und Ursprungsgruppen) + Benutzerdefinierte Fehlerreaktionen (Fehlerseiten) + Geografische Einschränkungen + Standardstammobjekt + Protokollierungseinstellungen + Beschreibung (Kommentar) Sie können auch externe Ressourcen aktualisieren, auf die in der Konfiguration einer Distribution verwiesen wird, z. B. eine Cache-Richtlinie, eine Response-Header-Richtlinie, eine CloudFront Funktion oder eine Lambda @Edge -Funktion. ## Primäre Verteilungen und Staging-Verteilungen nutzen nicht denselben Cache Primäre Verteilungen und Staging-Verteilungen nutzen nicht denselben Cache. Wenn die erste Anfrage an eine Staging-Distribution CloudFront gesendet wird, ist deren Cache leer. Wenn Anforderungen bei der Staging-Verteilung ankommen, beginnt diese mit dem Zwischenspeichern der Antworten (sofern entsprechend konfiguriert). # Kontingente und andere zu berücksichtigende Aspekte bei der kontinuierlichen Bereitstellung CloudFront Für die kontinuierliche Bereitstellung gelten die folgenden Kontingente und weitere Überlegungen. ## Kontingente + Maximale Anzahl von Staging-Verteilungen pro AWS-Konto: 20 + Maximale Anzahl von Richtlinien für die kontinuierliche Bereitstellung pro AWS-Konto: 20 + Maximaler Prozentsatz des Datenverkehrs, den Sie bei einer gewichtsbasierten Konfiguration an eine Staging-Verteilung senden können: 15 % + Mindest- und Höchstwerte für die Leerlaufdauer bei Sitzungs-Stickiness: 300–3 600 Sekunden Weitere Informationen finden Sie unter [Kontingente](cloudfront-limits.md). **Anmerkung** Wenn Sie die kontinuierliche Bereitstellung verwenden und Ihre primäre Distribution mit OAC für den S3-Bucket-Zugriff eingerichtet ist, aktualisieren Sie Ihre S3-Bucket-Richtlinie, um den Zugriff für die Staging-Distribution zu ermöglichen. Beispiele für S3-Bucket-Richtlinien finden Sie unter [Erteilen Sie die CloudFront Erlaubnis, auf den S3-Bucket zuzugreifen](private-content-restricting-access-to-s3.md#oac-permission-to-access-s3). ## AWS WAF Web ACLs Wenn Sie die kontinuierliche Bereitstellung für Ihre Distribution aktivieren, gelten die folgenden Überlegungen für AWS WAF: + Sie können der Distribution keine AWS WAF Web Access Control List (ACL) zuordnen, wenn diese ACL der Distribution zum ersten Mal zugeordnet wurde. + Sie können eine AWS WAF Web-ACL nicht von der Verteilung trennen. Bevor Sie die oben genannten Aufgaben ausführen können, müssen Sie die Richtlinie für die kontinuierliche Bereitstellung für Ihre Produktionsdistribution löschen. Dadurch wird auch die Staging-Distribution gelöscht. Weitere Informationen finden Sie unter [Verwenden von AWS WAF-Sicherheitsvorkehrungen](distribution-web-awswaf.md). ## Fälle, in denen alle Anfragen an die primäre Distribution CloudFront gesendet werden In bestimmten Fällen, z. B. in Zeiten hoher Ressourcenauslastung, werden CloudFront möglicherweise alle Anfragen an die primäre Verteilung gesendet, unabhängig davon, was in der Richtlinie für die kontinuierliche Bereitstellung festgelegt ist. CloudFront sendet zu Spitzenzeiten alle Anfragen an die primäre Distribution, unabhängig davon, was in der Richtlinie für die kontinuierliche Bereitstellung festgelegt ist. Spitzenverkehr bezieht sich auf den Verkehr auf dem *CloudFront Service* und nicht auf den Verkehr auf Ihrer Distribution. ## HTTP/3 Sie können die kontinuierliche Bereitstellung nicht mit einer Verteilung verwenden, die HTTP/3 unterstützt.