Ursprung konfigurieren

Sie können Ursprünge für Media CDN auf verschiedene Arten konfigurieren. Auf dieser Seite erfahren Sie, wie Sie Ursprünge konfigurieren.

Cloud Storage-Bucket als Ursprung konfigurieren

Media CDN unterstützt Cloud Storage-Buckets als Back-Ends für Inhalte. Jeder Dienst kann auf mehrere Buckets verweisen, indem er Routen für den Host, Pfade und andere Anfrageattribute konfiguriert.

Cloud Storage-Buckets werden konfiguriert, indem die Bucket-URL, z. B. gs://my-bucket, als Ursprungsadresse beim Erstellen einer Ursprungsressource verwendet wird.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Media CDN auf.

    Zum Media CDN

  2. Klicken Sie auf den Tab Ursprung.

  3. Klicken Sie auf Ursprung erstellen.

  4. Geben Sie einen Namen für den Ursprung ein. Beispiel: cloud-storage-origin.

  5. Optional: Geben Sie eine Beschreibung ein.

  6. Wählen Sie unter Ursprungsadresse die Option Google Cloud Storage-Bucket auswählen aus.

  7. Rufen Sie Ihren Cloud Storage-Bucket auf und wählen Sie ihn aus.

  8. Behalten Sie für Cloud Storage die Standardeinstellungen für Protokoll und Port bei.

  9. Optional: Wenn Überschreibungen des ursprünglichen Anfrageheaders Vorrang vor Headern haben sollen, die vom Client gesendet oder durch Headeraktionen auf Routenebene verändert wurden, gehen Sie so vor:

    1. Wählen Sie Quellüberschreibung aktivieren aus.
    2. Geben Sie im Abschnitt Header Header an, indem Sie ein oder mehrere Name/Wert-Paare hinzufügen.
  10. Optional: Wählen Sie einen Failover-Ursprung aus, der für den Fall versucht wird, dass dieser Ursprung nicht mehr erreichbar ist. Sie können dieses Feld später aktualisieren.

  11. Wählen Sie Weiterleitungsbedingungen aus.

  12. Wählen Sie Wiederholungsbedingungen aus.

  13. Wählen Sie unter Maximale Anzahl von Versuchen die maximale Anzahl von Versuchen aus, um den Cache aus diesem Ursprung zu füllen.

  14. Optional: Geben Sie die folgenden Zeitüberschreitungswerte an:

    1. Wählen Sie für Verbindungszeitlimit die maximale Dauer aus, die auf den Aufbau der Ursprungsverbindung gewartet werden soll.
    2. Wählen Sie für Antwortzeitlimit die maximale Dauer aus, die für den Abschluss einer Antwort zulässig sein soll.
    3. Wählen Sie für Lesezeitlimit die maximale Dauer aus, die zwischen Lesevorgängen einer einzelnen HTTP-Verbindung oder eines Streams gewartet werden soll.
  15. Optional: Klicken Sie auf Label hinzufügen und geben Sie ein oder mehrere Schlüssel/Wert-Paare an.

  16. Klicken Sie auf Ursprung erstellen.

gcloud

Führen Sie folgenden gcloud edge-cache origins create-Befehl aus:

gcloud edge-cache origins create ORIGIN \
    --origin-address=ADDRESS

Ersetzen Sie Folgendes:

  • ORIGIN: der Name des neuen Ursprungs
  • ADDRESS: der Bucket-Name, z. B. gs://my-bucket

Dies ist unabhängig davon, ob der Bucket multiregional, biregional oder regional ist.

Wenn Sie einen Dienst konfigurieren, können Sie Ihre Video-on-Demand-Inhalte an einen Bucket weiterleiten und Livestreaming-Inhalte an einen zweiten Bucket streamen. Dies ist nützlich, wenn diese Workflows von verschiedenen Teams verwaltet werden. Um die Latenz für die Cache-Füllung zu reduzieren, können Sie die Region eu-media.example.com an einen multiregionalen Cloud Storage-Bucket in der EU und die Region us-media.example.com (oder eine Übereinstimmung in Pfad, Header oder Abfrageparameter) an einen US-basierten Storage-Bucket weiterleiten.

Media CDN-Buckets.
Media CDN-Buckets (zum Vergrößern klicken)

In Fällen, in denen die Schreiblatenz von kritischer Bedeutung ist, z. B. beim Livestreaming mit niedriger Latenz, können Sie einen regionalen Cloud Storage-Endpunkt so nah wie möglich bei Ihren Nutzern konfigurieren.

Anfragen authentifizieren

Verwenden Sie einen der folgenden unterstützten Ansätze, um zu bestätigen, dass eine Anfrage von Media CDN stammt:

  • Prüfen Sie, ob die verbindende IP-Adresse aus den Cache-Füllbereichen von Media CDN stammt. Diese Bereiche werden von allen Kunden gemeinsam genutzt, aber immer von EdgeCacheService-Ressourcen verwendet, wenn eine Verbindung zu einem Ursprung hergestellt wird.
  • Fügen Sie einen benutzerdefinierten Anfrageheader mit einem Tokenwert hinzu, den Sie am Ursprung validieren (z. B. einen zufälligen 16-Byte-Wert). Ihr Ursprung kann dann Anfragen ablehnen, die diesen Wert nicht enthalten.

Ursprungsprotokoll konfigurieren

Wenn Ihr Ursprung HTTP/2 unterstützt, müssen Sie das Protokoll nicht explizit festlegen. Legen Sie für Ursprünge, die nur HTTPS (HTTP/1.1 über TLS) oder HTTP/1.1 (ohne TLS) unterstützen, das Feld protocol explizit fest. Gehen Sie dazu so vor:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Media CDN auf.

    Zum Media CDN

  2. Klicken Sie auf den Tab Ursprung.

  3. Wählen Sie den Ursprung aus und klicken Sie auf Bearbeiten.

  4. Wählen Sie als Protokoll HTTPS oder HTTP aus. Geben Sie für HTTP auch den Port 80 an.

  5. Klicken Sie auf Ursprung aktualisieren.

gcloud

Führen Sie folgenden gcloud edge-cache origins update-Befehl aus:

gcloud edge-cache origins update LEGACY_ORIGIN \
    --protocol=HTTPS

Ersetzen Sie LEGACY_ORIGIN durch den Namen des Ursprungs.

Private Cloud Storage-Buckets konfigurieren

Media CDN kann Inhalte von jedem über das Internet erreichbaren HTTP- oder HTTPS-Endpunkt abrufen. In einigen Fällen kann es sein, dass Sie eine Authentifizierung erforderlich machen möchten, damit nur Media CDN Inhalte abrufen kann und nicht autorisierter Zugriff verhindert wird. Cloud Storage unterstützt dies über IAM-Berechtigungen.

Gehen Sie bei Cloud Storage-Ursprüngen so vor:

  • Weisen Sie dem Media CDN-Dienstkonto eine Rolle zu, die die IAM-Berechtigung storage.objects.get für die Cloud Storage-Buckets enthält, die Sie als Ursprünge verwenden. Weisen Sie beispielsweise die Rolle roles/storage.legacyObjectReader (roles/storage.legacyObjectReader) oder eine benutzerdefinierte Rolle mit der Berechtigung storage.objects.get zu. Da die Rolle roles/storage.objectViewer (roles/storage.objectViewer) die Berechtigung storage.objects.list enthält, sollten Sie sie nur zuweisen, wenn Clients Objekte im Bucket auflisten können sollen.
  • Die Berechtigung allUsers entfernen.
  • Optional: Die Berechtigung allAuthenticatedUsers entfernen.

Wenn Sie die Berechtigungen eines Cloud Storage-Bucket ändern möchten, benötigen Sie die Rolle „Storage-Administrator“ (roles/storage.admin).

Das Media CDN-Dienstkonto gehört zum Media CDN-Projekt und wird nicht in der Liste der Dienstkonten Ihres Projekts angezeigt. Das Dienstkonto gewährt nur Zugriff auf Media CDN-Ressourcen in den Projekten, die Sie explizit zulassen.

Sie müssen mindestens eine Media CDN-Ressource erstellen, um die Erstellung des Dienstkontos auszulösen. In den meisten Fällen ist dies die EdgeCacheOrigin-Ressource, die mit Ihrem Cloud Storage-Bucket verbunden ist.

Wenn Sie Media CDN die Berechtigung storage.objects.get für einen Bucket erteilen möchten, weisen Sie dem Dienstkonto die Rolle roles/storage.legacyObjectReader oder eine benutzerdefinierte Rolle zu, die diese Berechtigung enthält:

gcloud storage buckets add-iam-policy-binding gs://BUCKET \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-mediaedgefill. \
    --role=roles/storage.legacyObjectReader

Ersetzen Sie Folgendes:

  • BUCKET: Der Name des Buckets
  • PROJECT_NUMBER: die Nummer des Projekts, das Ihre Media CDN-Ressourcen enthält.

Bevor Sie den öffentlichen Zugriff auf einen vorhandenen Storage-Bucket entfernen, der als Produktionsursprung verwendet wird, sollten Sie mindestens 10 Minuten warten, bis die Konfiguration wirksam wird.

Verwenden Sie den Befehl gcloud storage buckets remove-iam-policy-binding, um die Berechtigungen zu entfernen, die der Rolle allUsers für den angegebenen Bucket gewährt wurden. Wenn der Bucket beispielsweise allUsers die Rolle objectViewer gewährt, entfernen Sie die Gewährung mit dem folgenden Befehl:

gcloud storage buckets remove-iam-policy-binding gs://BUCKET \
    --member=allUsers --role=roles/storage.objectViewer

Wenn Sie prüfen möchten, ob der öffentliche Zugriff entfernt wurde, öffnen Sie ein Inkognitofenster im Browser und versuchen Sie, mit https://storage.googleapis.com/BUCKET/object.ext auf ein Bucket-Objekt zuzugreifen.

Wenn Sie EdgeCacheService-Ressourcen in einem Projekt Zugriff auf einen Cloud Storage-Bucket in einem anderen Projekt gewähren möchten, können Sie dem Media CDN-Dienstkonto in diesem Projekt Zugriff auf den Storage-Bucket gewähren.

Prüfen Sie dazu, ob PROJECT_NUMBER in service-PROJECT_NUMBER@gcp-sa-mediaedgefill. die Projektnummer des Projekts mit den EdgeCacheService-Ressourcen ist, die Zugriff benötigen. Sie können dies für mehrere Projekte wiederholen, insbesondere wenn einige davon unterschiedliche Media CDN-Umgebungen (z. B. Entwicklung, Staging oder Produktion) enthalten und ein separates Projekt Ihre Video- oder Medien-Assets enthält.

Sie können den Zugriff auf Ihren Cloud Storage-Ursprung schützen, ohne signierte Anfragen für diese Route zu aktivieren.

Die Konfiguration von privatem Cloud Storage verhindert nicht, dass von Media CDN direkt auf Ihre im Cache gespeicherten Inhalte zugegriffen wird. Informationen darüber, wie Sie signierte Anfragen an einzelne Nutzer senden können, finden Sie unter signierte Anfragen.

Externen Application Load Balancer als Ursprung konfigurieren

Wenn Sie eine aktive Systemdiagnose, Round Robin- oder lastenabhängiges Steuern über Compute Engine-, GKE- oder lokale Ursprünge hinweg benötigen, können Sie einen externen Application Load Balancer als Ursprung konfigurieren.

Auf diese Weise können Sie (beispielsweise) Ihre Livestreaming-Verpacker hinter Media CDN oder eine Gruppe von Envoy-Proxys konfigurieren, die von Cloud Service Mesh verwaltet werden, um eine Verbindung zurück zur lokalen Infrastruktur herzustellen.

Mit Load Balancern können Sie Backends für Folgendes konfigurieren:

Eine Architektur, die einen externen Application Load Balancer-Ursprung für die Bereitstellung von Videomanifesten und einen Cloud Storage-Ursprung für die Segmentspeicherung kombiniert, würde folgendermaßen aussehen, wobei zwei Ursprünge verschiedenen Routen zugeordnet werden.

Edge-Cache-Bereitstellung.
Edge-Cache-Bereitstellung (zum Vergrößern klicken)

Zum Konfigurieren eines externen Application Load Balancers als Ursprung müssen Sie eine Ursprungsressource erstellen, wobei die IP-Adresse oder der öffentliche Hostname auf die Weiterleitungsregeln Ihres Load Balancers verweist. Ein öffentlicher Hostname (Domainname) wird bevorzugt, da dieser für ein SSL-(TLS-)Zertifikat und für moderne HTTP-Versionen (HTTP/2 und HTTP/3) erforderlich ist.

Außerdem müssen Sie Folgendes bestätigen:

  • Ihr Load Balancer hat eine Route, die mit dem Hostnamen übereinstimmt, der für Ihre EdgeCacheService-Ressource verwendet wird, oder Sie haben eine urlRewrite.hostRewrite für Routen konfiguriert, bei denen Ihr Load Balancer als Ursprung konfiguriert ist.
  • Ihr Load Balancer verfügt über ein öffentlich vertrauenswürdiges SSL-(TLS-)Zertifikat, das für diese Hostnamen konfiguriert ist.

Wenn beispielsweise der öffentliche Domainname, der auf die Weiterleitungsregel Ihres Load Balancers verweist, origin-packager.example.com lautet, dann müssen Sie einen Ursprung erstellen, bei dem die originAddress auf diesen Namen festgelegt ist.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Media CDN auf.

    Zum Media CDN

  2. Klicken Sie auf den Tab Ursprung.

  3. Klicken Sie auf Ursprung erstellen.

  4. Geben Sie einen Namen für den Ursprung ein. Beispiel: load-balancer-origin.

  5. Optional: Geben Sie eine Beschreibung ein.

  6. Wählen Sie für die Ursprungsadresse die Option FQDN oder IP-Adresse angeben aus.

  7. Geben Sie den FQDN oder die IP-Adresse für Ihren Google Cloud -Load-Balancer ein.

  8. Optional: Wählen Sie einen Failover-Ursprung aus, der für den Fall versucht wird, dass dieser Ursprung nicht mehr erreichbar ist. Sie können dieses Feld später aktualisieren.

  9. Wählen Sie Wiederholungsbedingungen aus.

  10. Wählen Sie unter Maximale Anzahl von Versuchen die maximale Anzahl von Versuchen aus, um den Cache aus diesem Ursprung zu füllen.

  11. Optional: Geben Sie die folgenden Zeitüberschreitungswerte an:

    1. Wählen Sie für Verbindungszeitlimit die maximale Dauer aus, die auf den Aufbau der Ursprungsverbindung gewartet werden soll.
    2. Wählen Sie für Antwortzeitlimit die maximale Dauer aus, die für den Abschluss einer Antwort zulässig sein soll.
    3. Wählen Sie für Lesezeitlimit die maximale Dauer aus, die zwischen Lesevorgängen einer einzelnen HTTP-Verbindung oder eines Streams gewartet werden soll.
  12. Optional: Klicken Sie auf Label hinzufügen und geben Sie ein oder mehrere Schlüssel/Wert-Paare an.

  13. Klicken Sie auf Ursprung erstellen.

gcloud

Führen Sie folgenden gcloud edge-cache origins create-Befehl aus:

gcloud edge-cache origins create LB_ORIGIN \
    --origin-address=LB_ADDRESS

Ersetzen Sie Folgendes:

  • LB_ORIGIN: der Name des Ursprungs
  • LB_ADDRESS: der FQDN oder die IP-Adresse, z. B. origin-packager.example.com

Wenn Sie die IP-Adresse Ihrer Weiterleitungsregel als Ursprungsadresse verwenden oder an Ihren Load Balancer kein SSL-Zertifikat angehängt ist, können Sie das Protokoll auf HTTP setzen, um ein Fallback auf unverschlüsselte Verbindungen auszuführen. Wir empfehlen, dies nur für die Entwicklung oder zum Testen zu tun.

Region für flexiblen Schutz konfigurieren

Sie können eine Region für den flexiblen Schutz konfigurieren, wenn Sie einen Ursprung erstellen oder aktualisieren.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Media CDN auf.

    Zum Media CDN

  2. Klicken Sie auf den Tab Ursprung.

  3. Klicken Sie auf den Namen des Ursprungs, den Sie aktualisieren möchten.

  4. Klicken Sie auf den Button Bearbeiten, um in den Bearbeitungsmodus zu wechseln.

  5. Wählen Sie im Abschnitt Ursprungseinstellungen für Ursprungsschutz die Option Flexibler Schutz (benutzerdefiniert) aus. Die nächstgelegene Region wird automatisch ausgewählt. Wenn die nächstgelegene Region nicht in der Liste verfügbar ist, wählen Sie manuell einen Wert aus der Liste der verfügbaren Regionen aus. Gültige Werte sind africa-south1, europe-west3, me-central1 und us-east5.

  6. Klicken Sie auf Ursprung aktualisieren, um die Änderungen zu speichern.

Wenn Sie die Abschirmung auf den Standard-Ursprungsschutz zurücksetzen möchten, aktualisieren Sie den Ursprung und wählen Sie Ursprungsschutz (Standardeinstellung) aus.

gcloud

Verwenden Sie den gcloud edge-cache origins update-Befehl, um die flexible Abschirmung für eine Region in einem vorhandenen Ursprung zu konfigurieren:

gcloud edge-cache origins update ORIGIN \
    --origin-address=ADDRESS \
    --flex-shielding=REGION

Ersetzen Sie Folgendes:

  • ORIGIN: der Name des Ursprungs
  • ADDRESS: die Adresse des Ursprungs
  • REGION: die Region für die Abschirmung des Ursprungs. Gültige Werte sind africa-south1, europe-west3, me-central1 und us-east5. Wenn Sie die Abschirmung auf die Standard-Ursprungsabschirmung zurücksetzen möchten, führen Sie denselben Befehl aus, nachdem Sie die Option flex-shielding auf „leer“ gesetzt haben.

yaml

Wenn Sie die Abschirmung des Ursprungs für eine Region in einem vorhandenen Ursprung konfigurieren möchten, fügen Sie der Ressourcenkonfiguration EdgeCacheOrigin einen Abschnitt flexShielding hinzu:

name: ORIGIN
originAddress: ADDRESS
# ... Other fields
flexShielding:
  flexShieldingRegions:
    - REGION
# ... Other fields

Ersetzen Sie Folgendes:

  • ORIGIN: der Name des Ursprungs
  • ADDRESS: die Adresse des Ursprungs
  • REGION: die Region für die Abschirmung des Ursprungs. Gültige Werte sind africa-south1, europe-west3, me-central1 und us-east5.

Wenn Sie die Origin Shielding-Einstellung auf die Standardeinstellung zurücksetzen möchten, entfernen Sie den Abschnitt flexShielding.

Ursprungs-Failover konfigurieren

In den folgenden Abschnitten wird beschrieben, wie Sie das Failover-Verhalten für Ursprünge konfigurieren.

Ursprungs-Failover ohne Folgen der Weiterleitung

Im Folgenden ist eine grundlegende Failover-EdgeCacheOrigin-Konfiguration aufgeführt:

name: FAILOVER_ORIGIN
originAddress: FAILOVER_DOMAIN_NAME

Media CDN wiederholt den primären Ursprung der Route maximal dreimal, bevor ein Failover-Ursprung versucht wird. In dieser Konfiguration probiert Media CDN, nachdem der primäre Ursprung dreimal versucht wurde zu erreichen, eine einzelne Anfrage mit FAILOVER_ORIGIN. Wenn der Failover-Ursprung ebenfalls nicht erfolgreich antwortet, gibt Media CDN entweder die gesamte Ursprungsantwort oder, wenn kein Statuscode empfangen wird, eine HTTP-502 Bad Gateway-Antwort zurück.

Die Latenz beim Füllen des Cache steigt mit der Anzahl der Wiederholungsversuche und Failover-Ereignisse. Das Erhöhen der Ursprungs-Zeitlimitwerte (z. B. connectTimeout) wirkt sich weiter auf die Cache-Füllungslatenz aus, weil dadurch die Zeit erhöht wird, die mit dem Warten auf die Antwort eines überlasteten oder ausgelasteten Ursprungsservers verbracht wird.

Das folgende Beispiel zeigt eine Konfiguration, die Füllungsanfragen an MY_ORIGIN sendet. Die Konfiguration bewirkt, dass Media CDN bei Verbindungsfehlern (wie DNS-, TCP- oder TLS-Fehlern), HTTP-5xx-Antworten vom Ursprung oder HTTP-404 Not Found-Antworten Wiederholungsversuche unternimmt. Nach zwei Versuchen wird ein Failover zu FAILOVER_ORIGIN durchgeführt.

Es werden insgesamt maximal vier Versuche über Ihre konfigurierten Ursprünge hinweg unternommen: der ursprüngliche Versuch plus bis zu drei Wiederholungsversuche. Sie können einen maxAttempts-Wert pro Ursprung konfigurieren, um zu bestimmen, wie viele Wiederholungsversuche ausgeführt werden, bevor ein Failover durchgeführt wird.

name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2 # the number of attempts to make before trying the failoverOrigin
failoverOrigin: FAILOVER_ORIGIN
# what conditions trigger a retry or failover
retryConditions:
- CONNECT_FAILURE
- HTTP_5xx # any HTTP 5xx response
- NOT_FOUND # retry on a HTTP 404
timeout:
  maxAttemptsTimeout: 10s # set a deadline for all retries and failover

Ursprungs-Failover mit Folgen von Weiterleitungen

Angenommen, Sie haben die folgenden EdgeCacheOrigin-Ressourcen konfiguriert und die Routen Ihrer EdgeCacheService-Ressource sind so konfiguriert, dass PrimaryOrigin für die Cache-Füllung verwendet wird:

name: PrimaryOrigin
originAddress: "primary.example.com"
maxAttempts: 2
failoverOrigin: "SecondaryOrigin"
retryConditions: [CONNECT_FAILURE]
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]
name: SecondaryOrigin
originAddress: "secondary.example.com"
maxAttempts: 3
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]

In diesem Beispiel liest Media CDN, wenn es eine Cache-Füllung durchführt, die Konfiguration der PrimaryOrigin und reagiert entsprechend.

Angenommen, Media CDN stellt als Versuch Nr. 1, den Ursprung zu kontaktieren, eine Verbindung zu primary.example.com her. Wenn primary.example.com eine erfolgreiche Antwort zurückgibt, verwendet Media CDN diese Antwort für die Cache-Füllung.

Angenommen weiter, primary.example.com gibt einen HTTP-302 Found Redirect an Location: b.example.com zurück. Als Versuch Nr. 2, den Ursprung zu kontaktieren, folgt Media CDN der Weiterleitung zu b.example.com. In diesem Fall führt Media CDN Folgendes aus:

  • Wenn b.example.com eine erfolgreiche Antwort zurückgibt, verwendet Media CDN diese Antwort für die Cache-Füllung.
  • Wenn b.example.com eine Weiterleitung oder eine Fehlerantwort zurückgibt, erfolgt ein Failover von Media CDN auf den konfigurierten SecondaryOrigin. Das liegt daran, dass PrimaryOrigin in diesem Beispiel für zwei maxAttempts konfiguriert ist.

Wenn Media CDN ein Failover zu SecondaryOrigin ausführt, verwendet Media CDN die SecondaryOrigin-Konfiguration und versucht, eine Verbindung zu secondary.example.com herzustellen. Dies ist Versuch Nr. 1, den Ursprung zu kontaktieren, und Versuch Nr. 3 insgesamt.

In diesem Fall führt Media CDN Folgendes aus:

  • Wenn secondary.example.com eine erfolgreiche Antwort zurückgibt, verwendet Media CDN diese Antwort für die Cache-Füllung.
  • Wenn secondary.example.com einen HTTP-302 Found Redirect an Location: c.example.com zurückgibt, versucht Media CDN, c.example.com zu kontaktieren. In diesem Beispiel ist dies Versuch Nr. 2 für SecondaryOrigin und Versuch Nr. 4 insgesamt.

Wenn der Versuch, c.example.com zu kontaktieren, eine erfolgreiche Antwort zurückgibt, verwendet Media CDN diese Antwort für die Cache-Füllung. Wenn der Versuch eine Weiterleitung zurückgibt, für dessen Folgen Media CDN konfiguriert ist, gibt Media CDN den HTTP-Statuscode 502 Bad Gateway zurück, da die maximale Anzahl von Versuchen zur Kontaktaufnahme mit einem Ursprung erschöpft ist. Media CDN führt unabhängig von EdgeCacheOrigin-Konfigurationen höchstens vier Versuche über alle Ursprünge hinweg durch. Wenn Media CDN schließlich bei der Kontaktaufnahme mit c.example.com fehlschlägt, gibt Media CDN entweder eine 504 Gateway Timeout- oder eine 502 Bad Gateway-Antwort zurück.

Wenn Sie eine Systemdiagnose, Round Robin- oder lastenabhängiges Steuern über Ursprünge hinweg benötigen, können Sie einen externen Application Load Balancer als primären Ursprung konfigurieren.

Folgen von Ursprungsweiterleitungen konfigurieren

Media CDN unterstützt das Folgen von Weiterleitungen, die von Ihrem Ursprung intern während der Cache-Füllung zurückgegeben werden, anstatt Weiterleitungsantworten direkt an den Client zurückzugeben. Wenn Media CDN so konfiguriert ist, dass es Ursprungsweiterleitungen folgt, ruft Media CDN Inhalte vom Weiterleitungsstandort ab, bevor die weitergeleitete Antwort an den Client im Cache gespeichert und zurückgegeben wird. Media CDN folgt Weiterleitungen über Domains hinweg.

Als Best Practice sollten Sie die Ursprungsweiterleitung nur für Ursprünge konfigurieren, denen Sie vertrauen und die Sie kontrollieren. Sie müssen jedem Ursprung in einer Weiterleitungskette vertrauen, da jeder Ursprung Inhalte erzeugt, die von Ihrem EdgeCacheService bereitgestellt werden.

Fügen Sie die folgende Konfiguration zu Ihrer EdgeCacheOrigin-Ressource hinzu, um das Folgen von Ursprungsweiterleitungen zu aktivieren:

name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]

Media CDN verwendet das in den Weiterleitungen angegebene Protokoll, um alle Server zu erreichen. Prüfen Sie, ob alle Server, an die Media CDN weitergeleitet werden könnte, die erforderlichen Protokolle unterstützen. Speziell wenn das Protokoll auf HTTPS, HTTP/2 oder HTTP/3 gesetzt ist, führt Media CDN kein Fallback auf HTTP/1.1-Verbindungen aus, um unsicheren Weiterleitungen zu folgen. Der Host-Header, der an den weitergeleiteten Ursprung gesendet wird, stimmt mit der weitergeleiteten URL überein. Media CDN folgt einer einzelnen Weiterleitung pro EdgeCacheOrigin-Versuch, bevor die endgültige Antwort zurückgegeben oder Wiederholungs- oder Failover-Bedingungen ausgewertet werden.

Mit der Einstellung redirectConditions wird festgelegt, welche HTTP-Antwortcodes dazu führen, dass Media CDN einer Weiterleitung für jeden Ursprung folgt.

Bedingung Beschreibung
MOVED_PERMANENTLY Weiterleitung für Antwortcode HTTP 301 folgen
FOUND Weiterleitung für Antwortcode HTTP 302 folgen
SEE_OTHER Weiterleitung für Antwortcode HTTP 303 folgen
TEMPORARY_REDIRECT Weiterleitung für Antwortcode HTTP 307 folgen
PERMANENT_REDIRECT Weiterleitung für Antwortcode HTTP 308 folgen

Ursprungsspezifische Host-Umschreibungen oder Header-Änderungen konfigurieren

Wenn Ihr Ursprung eine ursprungsspezifische Host-Umschreibung oder Header-Änderung erfordert, verwenden Sie das folgende originOverrideAction-Konfigurationsbeispiel, um sie festzulegen:

name: FAILOVER_ORIGIN
originAddress: FAILOVER_ORIGIN_HOST"
originOverrideAction:
  urlRewrite:
    hostRewrite: FAILOVER_ORIGIN_HOST"
  headerAction:
    requestHeadersToAdd:
    - headerName: "Authorization"
      headerValue: "AUTH-KEY"
      replace: true

Die Einstellung originOverrideAction.hostRewrite hat Vorrang vor allen vorhandenen Header-Umschreibungen, die für Routen konfiguriert sind, die auf diesen Ursprung verweisen.

Sie können mit requestHeadersToAdd eindeutige Header pro Ursprung verwenden, die von diesem bestimmten Ursprung angefordert werden. Ein häufiger Anwendungsfall ist das Hinzufügen statischer Authorization-Header. Da die Header-Manipulationen während der Ursprungsanfrage ausgeführt werden, ersetzen Header, die pro Ursprung hinzugefügt werden, entweder vorhandene Header desselben Feldnamens oder sie werden diesen angefügt. Standardmäßig fügt Media CDN an vorhandene Header an. Wenn Sie vorhandene Header ersetzen möchten, setzen Sie headerAction.replace auf true.

Für ursprungsspezifische Headeränderungen werden nur statische Headerwerte verwendet. Dynamische Header-Variablen wie {client_region} werden nicht unterstützt.

Informationen zum Festlegen von Anfrageheadern pro Route finden Sie unter Benutzerdefinierte Header festlegen.

Fehlerbehebung bei Ursprüngen

Wenn sich ein Ursprung nicht wie erwartet verhält, lesen Sie die Informationen zur Fehlerbehebung bei Ursprüngen.

Nächste Schritte