View a markdown version of this page

Production-ready CloudFront Konfiguration für MediaTailor - AWS Elemental MediaTailor
Three-origin ArchitekturRangfolge und Konfiguration des Cache-Verhaltens

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.

Production-ready CloudFront Konfiguration für MediaTailor

Diese CloudFront Verteilungskonfiguration bietet alles, was Sie für die Bereitstellung von MediaTailor Inhalten mit serverseitiger Anzeigeneinblendung in großem Umfang benötigen. Kopieren Sie diese Konfiguration und passen Sie sie an Ihre spezifischen Ursprünge und Anforderungen an.

Was erreicht diese Konfiguration

Diese Konfiguration sorgt für eine produktionsbereite CloudFront Distribution, die alle MediaTailor Anforderungstypen mit optimaler Zwischenspeicherung und Leistung verarbeitet. Sie umfasst drei Ursprünge (Ihre Inhalte, MediaTailor Segmente und MediaTailor Manifeste) mit vier Cache-Verhaltensweisen, die Anfragen korrekt weiterleiten und Inhalte entsprechend zwischenspeichern.

Wann sollte diese Konfiguration verwendet werden

Dieses Setup ist ideal für Live-Streaming, Video-on-Demand und Hybrid-Workflows, die eine serverseitige Anzeigenschaltung erfordern.

Three-origin Architektur

MediaTailor verwendet ein Architekturmuster mit drei Ursprüngen, um die Bereitstellung von Inhalten und die Leistung der Anzeigeneinblendung zu optimieren. Jeder Ursprung dient einem bestimmten Zweck im Workflow zur Anzeigeneinfügung:

Herkunft Ihrer Inhalte

Dies ist die wahre Herkunft Ihrer Inhalte, aus denen Feeds stammen MediaTailor. Dies könnte beispielsweise AWS Elemental MediaPackage V2 oder ein anderer Service zur Bereitstellung von Inhalten sein. Dieser Origin stellt Ihren ursprünglichen Inhalt vor der Anzeigenschaltung bereit. Allgemeine Beispiele sind:

  • MediaPackage V2-Verpackungskonfigurationen

  • Third-party Netzwerke zur Bereitstellung von Inhalten

  • On-premises Streaming-Server

  • Amazon S3 S3-Buckets mit statischem Inhalt

MediaTailor Herkunft der Segmente

Dieser Ursprung verwendet den Hostnamen segments.mediatailor.region.amazonaws.com und stellt die eigentlichen Anzeigensegmente bereit, nachdem sie MediaTailor codiert wurden. Dies sind die Videosegmente, die die Werbung enthalten. Dieser Ursprung behandelt:

  • Transkodierte Anzeigensegmente im gleichen Format wie Ihre Inhalte

  • Anfragen wurden anhand des /segment/* Pfadmusters umgeleitet

  • Anzeigensegmente, die für die serverseitige Anzeigeneinfügung verarbeitet wurden

MediaTailor manifestiert Herkunft

Dieser Ursprung verwendet den Hostnamen manifests.mediatailor.region.amazonaws.com und kann als regionaler Hostname für Wiedergabekonfigurationen in der angegebenen AWS Region verwendet werden. MediaTailor wählt basierend auf dem Pfad in der Anfrage die richtige Wiedergabekonfiguration aus. Dieser Ursprung bietet:

  • Personalisierte HLS- und DASH-Manifeste mit zuschauerspezifischer Anzeigeneinblendung

  • Server-guided Manifeste zur Anzeigeneinfügung (SGAI) für zwischenspeicherbare Inhalte

  • Ad-Tracking und Beacon-Verarbeitung für serverseitige Berichterstattung

Mit dem ursprünglichen Hostnamen können Sie mehrere Wiedergabekonfigurationen verwendenmanifests.mediatailor.region.amazonaws.com, die mit derselben CloudFront Distribution funktionieren, sofern sie sich in der angegebenen Region befinden und Sie den Namen der Wiedergabekonfiguration in den Anforderungspfad aufnehmen. Beispiel:

  • https://your-distribution.cloudfront.net/v1/master/playback-config-1/manifest.m3u8

  • https://your-distribution.cloudfront.net/v1/master/playback-config-2/manifest.m3u8

Wählen Sie die Richtlinien für ursprüngliche Anfragen auf Grundlage des Inhaltstyps aus, um Cache-Poisoning zu verhindern und gleichzeitig die einwandfreie Funktionalität sicherzustellen. Der Hauptunterschied besteht zwischen Inhalten, die zwischengespeichert werden können, und Inhalten, die nicht zwischengespeichert werden können:

  • Manifeste (nicht zwischenspeicherbar): Wird verwendet, um alle Header AllViewer weiterzuleiten, die für dynamische Inhalte benötigt werden. Da Manifeste nicht zwischengespeichert werden, besteht kein Risiko einer Cache-Vergiftung.

  • Segmente (zwischenspeicherbar): Wird None für eine optimale Leistung verwendet.

  • S3-Ursprünge: CORS-S3Origin Für Amazon S3 S3-Buckets verwenden

  • MediaPackage Ursprünge: Wird CORS-S3Origin für MediaPackage V2-Endpunkte verwendet

Origin-Tabelle mit den Spalten für den Namen, die Domäne, den Pfad, den Typ, die Shield Region und den Zugriff.

Rangfolge und Konfiguration des Cache-Verhaltens

MediaTailor erfordert spezielle Konfigurationen für das Cache-Verhalten, um verschiedene Arten von Anfragen richtig verarbeiten zu können. Der Vorrang von Cache-Verhalten ist von entscheidender Bedeutung, da CDNs sie der Reihe nach verarbeiten (vom kleinsten zum größten) und das Verhalten für das erste passende Pfadmuster verwenden. Für die Problembehandlung ist es wichtig, diese Rangfolge zu verstehen:

  • Priorität 0: Die meisten spezifischen Muster (like/tm/*) werden zuerst bewertet

  • Höhere Prioritätszahlen: Weniger spezifische Muster werden der Reihe nach bewertet

  • Standardverhalten: Fängt alle Anfragen ab, die nicht mit anderen Mustern übereinstimmen

Wenn sich Anfragen nicht wie erwartet verhalten, überprüfen Sie, ob sich Ihre Pfadmuster nicht unbeabsichtigt überschneiden.

Verhaltenstabelle mit Rangfolge, Pfadmustern, Ursprungsgruppen und Richtlinienkonfigurationen.

Priorität 0: Pfadverhalten von Anzeigensegmenten

Dieses Verhalten verarbeitet die umgeleiteten Anfragen aus dem Segmentpfadverhalten und bedient die eigentlichen Anzeigensegmente. CloudFront wendet das folgende Verhalten auf alle Anfragen mit einem /tm/* Pfadmuster an. Dies ist das Verhalten mit der höchsten Priorität, da die Bereitstellung von Anzeigensegmenten für eine unterbrechungsfreie Wiedergabe entscheidend ist.

  • Pfadmuster: /tm/*

    Beispiel-URLs, die diesem Muster entsprechen:

    • https://your-distribution.cloudfront.net/tm/ad-segment-001.ts

    • https://your-distribution.cloudfront.net/tm/transcoded-ad.m4s

  • Herkunft: Der Ursprung, den Sie mit der segments.mediatailor.region.amazonaws.com Domain erstellt haben.

    Dies ist MediaTailorSegmentsim Beispiel im vorherigen Abschnitt zu Ursprüngen der Fall.

  • Cache-Richtlinie: Managed-CachingOptimized

    Einzelheiten darüber, was in der CloudFront verwalteten Cache-Richtlinie enthalten ist, finden Sie CachingOptimizedim CloudFront Benutzerhandbuch. Sie können dieselben Einstellungen auch aus der verwalteten Richtlinie in Ihrem CDN eines Drittanbieters verwenden.

  • Richtlinie für Origin-Anfragen: None

  • Richtlinie für Antwort-Header: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Einzelheiten darüber, was in der Richtlinie für Antwort-Header enthalten ist, finden Sie CORS-with-preflight-and-SecurityHeadersPolicyim CloudFront Benutzerhandbuch.

Anpassung dieser Einstellungen an andere CDNs

Wenn Sie ein anderes CDN als verwenden CloudFront, suchen Sie nach entsprechenden Einstellungen, die Folgendes bewirken.

Abgleich von Pfadmustern

Konfigurieren Sie ein bestimmtes Verhalten für das /tm/* Pfadmuster zur Verarbeitung von MediaTailor Anzeigensegmenten

Konfiguration des Cache-Schlüssels

Nehmen Sie den Origin Header in Ihren Cache-Schlüssel auf, um sicherzustellen, dass Antworten für unterschiedliche Ursprünge getrennt zwischengespeichert werden

Header-Weiterleitung

Leitet den Origin Header und andere CORS-related Header an den Ursprung weiter

Verwaltung des Antwort-Headers

Konfigurieren Sie Ihr CDN so, dass der Access-Control-Allow-Origin Header in Antworten vorhanden ist

Die spezifische Terminologie und die Konfigurationsoptionen variieren je nach CDN-Anbieter, die zugrunde liegenden Prinzipien bleiben jedoch dieselben.

Priorität 1: Verhalten beim Einfügen von Server-guided Anzeigen

Dieses Verhalten verarbeitet Anfragen MediaTailor Überblick und Implementierung der servergesteuerten Anzeigeneinfügung (SGAI), wenn Kunden den geführten Modus konfigurieren, der zwischenspeicherbare Manifeste bereitstellt. CloudFront wendet das folgende Verhalten auf alle Anfragen mit einem /v1/i-media/* Pfadmuster an. SGAI ermöglicht eine bessere Caching-Leistung, da die Manifeste nicht betrachterspezifisch sind.

  • Pfadmuster: /v1/i-media/* (iMedia-Pfad für SGAI)

    Beispiel-URLs, die diesem Muster entsprechen:

    • https://your-distribution.cloudfront.net/v1/i-media/your-config/manifest.m3u8

    • https://your-distribution.cloudfront.net/v1/i-media/your-config/playlist.mpd

  • Herkunft: Der Ursprung, den Sie mit der manifests.mediatailor.region.amazonaws.com Domain erstellt haben.

    Dies ist MediaTailorManifestsim Beispiel im vorherigen Abschnitt zu Ursprüngen der Fall.

  • Cache-Richtlinie: Managed-CachingOptimized

    Einzelheiten darüber, was in der CloudFront verwalteten Cache-Richtlinie enthalten ist, finden Sie CachingOptimizedim CloudFront Benutzerhandbuch. Sie können dieselben Einstellungen auch aus der verwalteten Richtlinie in Ihrem CDN eines Drittanbieters verwenden.

  • Richtlinie für Origin-Anfragen: None

  • Richtlinie für Antwort-Header: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Einzelheiten darüber, was in der Richtlinie für Antwort-Header enthalten ist, finden Sie CORS-with-preflight-and-SecurityHeadersPolicyim CloudFront Benutzerhandbuch.

Priorität 2: Personalisiertes Manifestverhalten

Dieses Verhalten verarbeitet personalisierte Manifestanfragen. CloudFront wendet die folgenden Verhaltensweisen auf alle Anfragen mit einem /v1/* Pfadmuster an. CloudFront wendet die folgenden Verhaltensweisen an und speichert keine personalisierten Manifeste im Cache, da sie betrachterspezifische URLs für Anzeigeninhalte enthalten. Dieses Verhalten gilt für alle Anfragen, die ein /v1/* Pfadmuster haben. Dies ist die MediaTailor Kernfunktion, bei der jeder Zuschauer ein einzigartiges Manifest mit personalisierter Anzeigeneinblendung erhält.

  • Pfadmuster: /v1/* ( MediaTailor Standard-V1-Anfragen)

    Beispiel-URLs, die diesem Muster entsprechen:

    • https://your-distribution.cloudfront.net/v1/master/your-config/manifest.m3u8

    • https://your-distribution.cloudfront.net/v1/dash/your-config/manifest.mpd

  • Herkunft: Der Ursprung, den Sie mit der manifests.mediatailor.region.amazonaws.com Domain erstellt haben.

    Dies ist MediaTailorManifestsim Beispiel im vorherigen Abschnitt zu Ursprüngen der Fall.

  • Cache-Richtlinie: Managed-CachingDisabled

    Einzelheiten darüber, was in der Cache-Richtlinie enthalten ist, finden Sie CachingDisabledim CloudFront Benutzerhandbuch.

  • Richtlinie für Origin-Anfragen: AllViewer

    Verwenden Sie bei personalisierten Manifesten die AllViewer Richtlinie, um alle Header weiterzuleiten, die für dynamische Inhalte benötigt werden.

  • Richtlinie für Antwort-Header: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Einzelheiten darüber, was in der Richtlinie für Antwort-Header enthalten ist, finden Sie CORS-with-preflight-and-SecurityHeadersPolicyim CloudFront Benutzerhandbuch.

Accept-Encoding Kopfzeile

Wir empfehlen, dass dein CDN den Accept-Encoding Header vor Zuschauern bewahrt. Dieser Header enthält MediaTailor Anweisungen zum Komprimieren personalisierter Manifeste.

In CloudFront beinhaltet die AllViewerAndCloudFrontHeaders Quellanforderungsrichtlinie die Weiterleitung des Accept-Encoding Headers durch den Betrachter. Wenn Sie ein anderes CDN verwenden, stellen Sie sicher, dass dieser Header beibehalten wird.

Im Folgenden wird beschrieben, wie mit dem Header MediaTailor umgegangen wird. Accept-Encoding

  • Ältere Geräte: Ältere Smart-TVs, die Gzip nicht unterstützen, senden den Accept-Encoding Header nicht und geben daher unkomprimierte MediaTailor Manifeste zurück

  • Moderne Geräte: iPhones, Chrome-Browser und andere moderne Clients senden den Accept-Encoding Header, sodass Manifeste vor der Auslieferung komprimiert MediaTailor werden können

Priorität 3: Verhalten des Server-side Beacon-Pfads

Dieses Verhalten verarbeitet Anfragen an MediaTailor , die zu Weiterleitungen für führen. Server-side Nachverfolgung Diese Anfragen sind für das Tracking von Beacons unerlässlich, daher muss jede Anfrage von MediaTailor bearbeitet werden. CloudFront wendet das folgende Verhalten auf alle Anfragen mit einem /segment/* Pfadmuster an.

  • Pfadmuster: /segment/*

    Beispiel-URLs, die diesem Muster entsprechen:

    • https://your-distribution.cloudfront.net/segment/tracking-beacon-123

    • https://your-distribution.cloudfront.net/segment/ad-request-456.ts

  • Herkunft: Der Ursprung, den Sie mit der manifests.mediatailor.region.amazonaws.com Domain erstellt haben.

    Dies ist MediaTailorManifestsim Beispiel im vorherigen Abschnitt zu Ursprüngen der Fall.

  • Cache-Richtlinie: Managed-CachingDisabled

    Einzelheiten darüber, was in der Cache-Richtlinie enthalten ist, finden Sie CachingDisabledim CloudFront Benutzerhandbuch.

  • Richtlinie für Origin-Anfragen: AllViewer

    Verwenden Sie bei serverseitigen Beacon-Anfragen die AllViewer Richtlinie, um alle Header weiterzuleiten, die für die Nachverfolgung benötigt werden. Da diese Anfragen nicht zwischengespeichert werden, besteht kein Risiko einer Cache-Vergiftung.

  • Richtlinie für Antwort-Header: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Einzelheiten darüber, was in der Richtlinie für Antwort-Header enthalten ist, finden Sie CORS-with-preflight-and-SecurityHeadersPolicyim CloudFront Benutzerhandbuch.

Bei der MediaTailor Verarbeitung dieser Anfragen wird eine 302-Umleitungsantwort mit einem Pfad zurückgegeben, der auf die tatsächliche Segmentposition verweist. Eine Anfrage an /segment/ad123.ts könnte beispielsweise /tm/encoded-ad-segment.ts auf den Ursprung des Segments umgeleitet werden.

Priorität 4: Verhalten beim Herkunftspfad des Inhalts

Wenn der Anforderungspfad keinem der anderen Muster entspricht, wird das Standardverhalten CloudFront angewendet. Bei diesem Verhalten werden Anfragen direkt an den Inhaltsursprung gesendet, ohne dass sie von dort verarbeitet MediaTailor werden. Dies ermöglicht bei Bedarf direkten Zugriff auf Ihren Inhaltsursprung (z. B. MediaPackage V2). CloudFront wendet das folgende Verhalten auf alle Anfragen an, die keines der vorherigen Pfadmuster enthalten.

  • Pfadmuster: (*)

  • Herkunft: Der Ursprung, den Sie mit der Domain für die Herkunft Ihrer Inhalte erstellt haben.

    Dies ist ContentOriginim Beispiel im vorherigen Abschnitt zu Ursprüngen der Fall.

  • Cache-Richtlinie: Managed-CachingOptimized

    Einzelheiten darüber, was in der CloudFront verwalteten Cache-Richtlinie enthalten ist, finden Sie CachingOptimizedim CloudFront Benutzerhandbuch. Sie können dieselben Einstellungen auch aus der verwalteten Richtlinie in Ihrem CDN eines Drittanbieters verwenden.

    Anmerkung

    Für HLS-Implementierungen mit niedriger Latenz sollten Sie erwägen, anstelle der Standardrichtlinie eine benutzerdefinierte Caching-Richtlinie mit HLS-Anweisungen (LLH) mit niedriger Latenz zu verwenden. CachingOptimized

  • Richtlinie für Origin-Anfragen: None

  • Richtlinie für Antwort-Header: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Obwohl das Standardverhalten bei der Herkunft von Inhalten in der Regel nicht den gleichen Risiken ausgesetzt ist wie beim Verhalten des Anzeigensegments, wird dennoch empfohlen, die Richtlinie für Managed-CORS-with-preflight-and-SecurityHeadersPolicy Antwortheader zu verwenden und den Origin Header in Ihren Cache-Schlüssel aufzunehmen. Dadurch wird eine konsistente CORS-Verarbeitung für alle Inhaltstypen gewährleistet und potenzielle Wiedergabeprobleme in webbasierten Playern vermieden.

    Bei Inhaltssegmenten bietet die Managed-CachingOptimized Cache-Richtlinie eine gute Leistung, während die Managed-CORS-with-preflight-and-SecurityHeadersPolicy Response-Header-Richtlinie die korrekte CORS-Behandlung gewährleistet. Diese Kombination ermöglicht effizientes Caching bei gleichzeitiger Wahrung der Kompatibilität mit webbasierten Playern, die CORS-Header benötigen.

    Die Anwendung einer konsistenten CORS-Handhabung sowohl für Anzeigensegmente als auch für Inhaltssegmente sorgt für ein zuverlässigeres Wiedergabeerlebnis und vereinfacht die Fehlerbehebung. Ohne die richtige CORS-Konfiguration kann es bei Spielern zu inkonsistentem Verhalten kommen, wenn sie zwischen Inhalten und Anzeigen wechseln.

    Einzelheiten dazu, was in der Richtlinie für Antwort-Header enthalten ist, finden Sie CORS-with-preflight-and-SecurityHeadersPolicyim Benutzerhandbuch. CloudFront