In dieser Kurzanleitung erfahren Sie, wie Sie einen Media CDN-Dienst vor einem Cloud Storage-Bucket einrichten. Sie können diese Konfiguration zum Testen oder als Grundlage für eine Produktionsumgebung verwenden.
Klicken Sie auf Anleitung, um die Schritt-für-Schritt-Anleitung für diese Aufgabe direkt in der Google Cloud Console auszuführen:
Diese Anleitung führt Sie durch die folgenden Verfahren:
- Cloud Storage-Bucket zum Speichern Ihrer Inhalte erstellen
- Aktivieren Sie die erforderlichen Dienste.
- Erstellen Sie eine
EdgeCacheOrigin
-Ressource, um Media CDN mit Ihrem Bucket zu verbinden. - Erstellen Sie eine
EdgeCacheService
-Ressource, um das Anfragenrouting und das Caching für Inhalte im Ursprung zu konfigurieren. - Testen, ob eine Antwort im Cache gespeichert wird.
Hinweise
Sie benötigen Folgendes:
Zugriff auf Media CDN für Ihr aktuelles Projekt.
Die installierte Google Cloud CLI. Verwenden Sie Version 345.0.0 oder höher.
Verwenden Sie bei Bedarf
gcloud version
, um die Version zu prüfen, undgcloud components update
, um die installierte gcloud CLI zu aktualisieren.Die gcloud CLI enthält die Unterbefehlsgruppe
gcloud edge-cache
zum Verwalten von neuen und vorhandenen Media CDN-Konfigurationen.Die IAM-Berechtigungen (Identity and Access Management) zum Erstellen von Media CDN-Ressourcen Media CDN hat die folgenden vordefinierten IAM-Rollen:
roles/networkservices.edgeCacheAdmin
roles/networkservices.edgeCacheUser
roles/networkservices.edgeCacheViewer
Cloud Storage-Bucket erstellen
Media CDN-Inhalte können aus Standorten wie einem Cloud Storage-Bucket, einem Drittanbieter-Speicherort oder einem Load-Balancer stammen.
In dieser Kurzanleitung speichern wir Inhalte in einem Cloud Storage-Bucket.
Erstellen Sie einen öffentlich zugänglichen Cloud Storage-Bucket und nennen Sie ihn
my-bucket
.Wenn Sie Ihren Cloud Storage-Bucket nicht öffentlich zugänglich machen möchten, müssen Sie Media CDN Berechtigungen für den Zugriff auf den Bucket erteilen. Weitere Informationen finden Sie unter Private Cloud Storage-Buckets verwenden.
Laden Sie eine Datei in den Bucket hoch.
Erforderliche Dienste aktivieren
Damit Sie Media CDN-Dienste konfigurieren und bereitstellen können, müssen Sie sowohl die Network Services API als auch die Certificate Manager API für Ihr Projekt aktivieren.
Console
Aktivieren Sie die Network Services API.
Aktivieren Sie die Certificate Manager API.
gcloud
Aktivieren Sie die Network Services API:
gcloud services enable networkservices.googleapis.com
Aktivieren Sie die Certificate Manager API:
gcloud services enable certificatemanager.googleapis.com
Weitere Informationen zum Aktivieren und Deaktivieren von Diensten finden Sie in der Dokumentation zu Service Usage.
EdgeCacheOrigin
-Ressource erstellen
Erstellen Sie einen Ursprung, der auf Ihren Cloud Storage-Bucket verweist.
Console
Rufen Sie in der Google Cloud Console die Seite Media CDN auf.
Klicken Sie auf den Tab Ursprünge.
Klicken Sie auf Ursprung erstellen.
Geben Sie den Namen für den Abreiseort als
cloud-storage-origin
ein.Optional: Geben Sie eine Beschreibung für den Ursprung ein.
Wählen Sie unter Ursprungsadresse die Option Google Cloud Storage-Bucket auswählen aus, suchen Sie den Cloud Storage-Bucket
my-bucket
und klicken Sie dann auf Auswählen.Wenn Sie stattdessen einen externen Ursprung haben, wählen Sie FQDN oder IP-Adresse angeben aus und geben Sie dann den FQDN oder die IP-Adresse ein.
Klicken Sie auf Ursprung erstellen.
Nach etwa 10 Minuten wird die neu erstellte Ressource EdgeCacheOrigin
in der Liste der Ursprünge in Ihrem Projekt auf der Seite Ursprünge angezeigt.
Wenn Sie eine Ursprungsadresse aktualisieren möchten, klicken Sie auf den Ursprung und dann auf
Bearbeiten.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 UrsprungsADDRESS
: der Bucket-Name,gs://my-bucket
Wenn Sie stattdessen einen externen Ursprung haben, ersetzen Sie
ADDRESS
durch den FQDN oder die IP-Adresse.
Verwenden Sie den Befehl gcloud edge-cache origins list
, um den neu erstellten Ursprung aufzurufen.
Verwenden Sie den Befehl gcloud edge-cache origins update
, um die Ursprungsadresse zu aktualisieren.
API
Verwenden Sie die Methode edgeCacheOrigins.create
:
POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheOrigins?edgeCacheOriginId=ORIGIN_ID { "name": "ORIGIN_ID", "originAddress: "ADDRESS" }
Ersetzen Sie Folgendes:
PARENT
: die übergeordnete Ressource im Formatprojects/PROJECT/locations/global
.ORIGIN_ID
: der Kurzname des neuen UrsprungsADDRESS
: der Bucket-Name,gs://my-bucket
Wenn Sie stattdessen einen externen Ursprung haben, ersetzen Sie
ADDRESS
durch den FQDN oder die IP-Adresse.
Verwenden Sie die Methode edgeCacheOrigins.list
, um den neu erstellten Ursprung aufzurufen.
Verwenden Sie zum Aktualisieren der Ursprungsadresse die Methode edgeCacheOrigins.patch
.
Terraform
EdgeCacheService
-Ressource erstellen
Ihre EdgeCacheService
-Ressource konfiguriert die Einstellungen für Routing, Zertifikat und Caching und kann auf EdgeCacheOrigin
-Ressourcen verweisen.
Erstellen Sie eine einfache EdgeCacheService
-Ressource, die folgende Aufgaben erfüllt:
- Speichert alle Antworten von unserem konfigurierten Ursprung eine Stunde im Cache
- Legt einen
x-cache-status
-Antwortheader fest, der den Cache-Status zurückgibt (z. B.HIT
oderMISS
)
Optional können Sie für diesen Dienst einen Domainnamen registrieren.
Console
Rufen Sie in der Google Cloud Console die Seite Media CDN auf.
Klicken Sie auf den Tab Services (Dienste).
Klicken Sie auf Dienst erstellen.
Geben Sie einen eindeutigen Namen für den Dienst ein, z. B.
my-service
, und klicken Sie dann auf Weiter.Klicken Sie im Bereich Routing auf Hostregel hinzufügen und geben Sie dann mindestens einen Hostnamen ein.
Geben Sie für Hosts einen Domainnamen ein, z. B.
web.example.com
.Klicken Sie auf Weiterleitungsregel hinzufügen.
- Geben Sie unter Priority (Priorität) den Wert
1
an. - Klicken Sie auf Übereinstimmungsbedingung hinzufügen, geben Sie für Pfadübereinstimmung den Wert
/
an und klicken Sie dann auf Fertig. - Wählen Sie Von einem Ursprung abrufen und dann den von Ihnen konfigurierten Ursprung aus.
- Klicken Sie auf Add-on-Aktionen.
- Klicken Sie unter Header action (Headeraktion) auf Add an item (Element hinzufügen). Führen Sie anschließend folgende Schritte aus:
- Wählen Sie für Type (Typ) die Option Add Header aus, die hinzugefügt werden sollen.
- Klicken Sie auf Header hinzufügen.
- Geben Sie für Name
x-cache-status
und für Wert{cdn_cache_status}
an. - Klicken Sie auf Fertig.
- Klicken Sie unter Routenaktion auf Element hinzufügen. Führen Sie anschließend folgende Schritte aus:
- Wählen Sie für Typ die Option CDN-Richtlinie aus.
- Wählen Sie für Cache-Modus die Option FORCE_CACHE_ALL aus.
- Klicken Sie auf Fertig.
- Klicken Sie auf Speichern.
- Geben Sie unter Priority (Priorität) den Wert
Klicken Sie auf Dienst erstellen.
Die neu erstellte Ressource EdgeCacheService
wird auf der Seite Dienste in der Liste der Dienste in Ihrem Projekt angezeigt.
gcloud
Erstellen Sie in Cloud Shell mit einem Texteditor eine lokale Datei namens
my-service.yaml
.Eine solche Datei enthält Folgendes:
- Funktionsweise des Routings, indem zuerst der Host und dann der Pfad abgeglichen werden
- Funktionsweise des Cachings – basierend auf dem Cache-Modus und der TTL
- Wie Anfragen und Antworten geändert werden, z. B. durch Einfügen der Variable
cdn_cache_status
in einen Antwortheader
Fügen Sie den folgenden Beispielinhalt in die Datei ein und speichern Sie sie:
name: SERVICE routing: hostRules: - hosts: - DOMAIN pathMatcher: routes pathMatchers: - name: routes routeRules: - priority: 1 matchRules: - prefixMatch: / origin: ORIGIN routeAction: cdnPolicy: cacheMode: CACHE_ALL_STATIC defaultTtl: 3600s headerAction: responseHeadersToAdd: - headerName: "x-cache-status" headerValue: "{cdn_cache_status}"
Ersetzen Sie Folgendes:
SERVICE
ist der Name des Dienstes.DOMAIN
: die Domain für den neuen Dienst
Wenn Sie den Domainnamen angeben, antwortet Media CDN für andere Hosts mit dem Fehler
404
. *ORIGIN
: der Name des zugehörigen UrsprungsVerwenden Sie den Befehl
gcloud edge-cache services import
mit der Datei.yaml
:gcloud edge-cache services import SERVICE \ --source=my-service.yaml
Verwenden Sie den Befehl
gcloud edge-cache services list
, um den neu erstellten Dienst in der Liste derEdgeCacheService
-Ressourcen in Ihrem Projekt aufzurufen.
API
Verwenden Sie die Methode edgeCacheServices.create
:
POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheServices?edgeCacheServiceId=SERVICE_ID { "name": "SERVICE_ID", "routing": { "hostRules": [ { "hosts": ["DOMAIN"], "pathMatcher": "routes" } ], "pathMatchers": [ { "name": "routes", "routeRules": [ { "priority": "1", "matchRules": [ { "prefixMatch": "/" } ], "origin": "ORIGIN", "routeAction": { "cdnPolicy": { "cacheMode": "CACHE_ALL_STATIC", "defaultTtl": "3600s" } } "headerAction": { "responseHeadersToAdd": [ { "headerName": "x-cache-status", "headerValue": "{cdn_cache_status}" } ] }, } ] } ] } }
Ersetzen Sie Folgendes:
PARENT
: die übergeordnete Ressource im Formatprojects/PROJECT/locations/global
.SERVICE_ID
: der Name des DienstesDOMAIN
: die Domain für den neuen DienstWenn Sie den Domainnamen angeben, antwortet Media CDN für andere Hosts mit dem Fehler
404
.ORIGIN_NAME
: der Name des zugehörigen Ursprungs
Mit der Methode edgeCacheServices.list
können Sie den neu erstellten Dienst in der Liste der EdgeCacheService
-Ressourcen in Ihrem Projekt ansehen.
Terraform
Es kann einige Minuten dauern, bis der erste Dienst erstellt ist. Media CDN stellt dedizierte IP-Adressen bereit und überträgt Ihre Konfiguration an Tausende von Edge-Standorten. Nachfolgende Aktualisierungen eines Dienstes, z. B. das Ändern einer Routenkonfiguration oder übereinstimmender Parameter, erfolgen schneller.
IP-Adressen abrufen
So rufen Sie die IP-Adressen für Ihren neu erstellten Dienst auf:
Console
Rufen Sie in der Google Cloud Console die Seite Media CDN auf.
Klicken Sie auf den Tab Services (Dienste).
Die IP-Adressen des Dienstes finden Sie in der Zelle Adressen.
Wenn die Zelle leer ist, aktualisieren Sie den Browser.
gcloud
Führen Sie folgenden gcloud edge-cache services describe
-Befehl aus:
gcloud edge-cache services describe SERVICE
Ersetzen Sie SERVICE durch den Namen des Dienstes.
Die Ausgabe zeigt die IP-Adressen, die Ihrem Dienst zugewiesen wurden:
ipv4Addresses:
IPV4_ADDRESS
ipv6Addresses:
IPV6_ADDRESS
name: projects/my-project/locations/global/edgeCacheServices/SERVICE
...
API
Verwenden Sie die Methode edgeCacheServices.get
:
GET https://networkservices.googleapis.com/v1/SERVICE_NAME
Ersetzen Sie SERVICE_NAME
durch den vollständigen Namen des Dienstes. Verwenden Sie das folgende Format:
projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
Ersetzen Sie SERVICE_ID
durch den Kurznamen des Dienstes.
Zu den abgerufenen Details gehören die IP-Adressen, die dem Dienst zugewiesen sind:
ipv4Addresses:
IPV4_ADDRESS
ipv6Addresses:
IPV6_ADDRESS
Testen, ob eine Antwort im Cache gespeichert wird
Prüfen Sie vor dem Testen des Dienstes, ob an Ihrem Ursprung im Cache speicherbare Inhalte gespeichert sind, damit Media CDN diese abrufen kann.
Um zu testen, ob Ihr Dienst richtig für das Speichern von Inhalten im Cache konfiguriert ist, verwenden Sie das curl
-Befehlszeilentool, um Anfragen zu senden und die Antworten zu prüfen. curl
ist auch in Cloud Shell in der Google Cloud Console verfügbar.
Wenn Sie die EdgeCacheService
mit Ihrer Domain verwenden möchten, können Sie die IP-Adresse von EdgeCacheService
einem Domaineintrag zuweisen. Eine Anleitung finden Sie unter Domain mit Cloud DNS einrichten.
Nachdem Sie Ihre Domain eingerichtet haben, können Sie mit dem folgenden curl
-Befehl auf Ihre Inhalte zugreifen:
curl -svo /dev/null "http://DOMAIN_NAME/FILE_NAME"
Wenn Sie DNS nicht so konfiguriert haben, dass es auf Ihre bereitgestellten IP-Adressen verweist, verwenden Sie die Option resolve
, um die von curl
verwendete Adresse zu überschreiben.
curl -svo /dev/null --resolve DOMAIN_NAME:80:IP_ADDRESS "http://DOMAIN_NAME/FILE_NAME"
Ersetzen Sie Folgendes:
DOMAIN_NAME
: die Hostdomain, die Sie beim Erstellen des Dienstes angegeben habenIP_ADDRESS
: die IP-Adresse des Dienstes, wie sie in der Liste der Dienste in der Spalte Adressen angezeigt wirdFILE_NAME
: Name der Datei, die Sie in den Bucket hochgeladen haben
Beispiel:
curl -svo /dev/null --resolve web.example.com:80:34.104.37.129 "http://web.example.com/file.mp4"
Der Befehl erzeugt anfänglich in etwa folgende Ausgabe mit dem Status miss
, da Media CDN die angeforderten Daten nicht bereits vom Ursprung abgerufen hat:
< HTTP/2 200 OK
...
< x-cache-status: den;miss
...
Wenn Sie dieselbe Anfrage beliebig oft senden, erhalten Sie eine Ausgabe ähnlich der folgenden mit dem Status hit
:
< HTTP/2 200 OK
...
< x-cache-status: den;hit
...
Wenn der Status hit
nicht angezeigt wird, prüfe Folgendes:
- Die Antwort kann im Cache gespeichert werden.
- Der konfigurierte Cache-Modus ermöglicht das Caching der Inhalte.
- Der Ursprung legt keine Cache-Anweisungen fest, die das Caching verhindern. Weitere Informationen finden Sie unter Cache-Konfiguration.
Sie haben jetzt eine einfache EdgeCacheService
-Ressource getestet, die Inhalte global bereitstellen kann. Ein produktionstauglicher Dienst benötigt möglicherweise SSL-Zertifikate (TLS), mehrere Ursprünge und eine Google Cloud Armor-Sicherheitsrichtlinie.
Optional: Bereinigung
Löschen Sie alle Ressourcen, die Sie nicht mehr verwenden möchten.
Console
Rufen Sie in der Google Cloud Console die Seite Media CDN auf.
Klicken Sie auf den Tab Services (Dienste).
Wählen Sie Ihren Dienst aus und klicken Sie auf Löschen.
Klicken Sie auf den Tab Ursprünge.
Wählen Sie den Ursprung aus und klicken Sie auf Löschen.
gcloud
Verwenden Sie zum Auflisten der von Ihnen erstellten Ressourcen die Befehle
gcloud edge-cache origins list
undgcloud edge-cache services list
.Verwenden Sie den Befehl
gcloud edge-cache services delete
, um den Dienst zu löschen:gcloud edge-cache services delete SERVICE
Ersetzen Sie
SERVICE
durch den Namen des Dienstes.Verwenden Sie den Befehl
gcloud edge-cache origins delete
, um den Ursprung zu löschen:gcloud edge-cache origins delete ORIGIN
Ersetzen Sie
ORIGIN
durch den Namen des Ursprungsorts.
API
Verwenden Sie die Methode
edgeCacheServices.list
und die MethodeedgeCacheOrigins.list
, um die von Ihnen erstellten Ressourcen aufzulisten.Verwenden Sie die Methode
edgeCacheServices.delete
, um den Dienst zu löschen:DELETE https://networkservices.googleapis.com/v1/SERVICE_NAME
Ersetzen Sie
SERVICE_NAME
durch den vollständigen Namen des Dienstes. Verwenden Sie das folgende Format:projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
Ersetzen Sie
SERVICE_ID
durch den Kurznamen des Dienstes.Verwenden Sie die Methode
edgeCacheOrigins.delete
, um den Ursprung zu löschen:DELETE https://networkservices.googleapis.com/v1/ORIGIN
Ersetzen Sie
ORIGIN
durch den vollständigen Namen des Ursprungs. Verwenden Sie das folgende Format:projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
Ersetzen Sie
ORIGIN_ID
durch den Kurznamen des Ursprungs.
Wiederholen Sie diesen Vorgang für alle anderen Ressourcen, die Sie erstellt haben und nicht noch einmal verwenden möchten, z. B. den Cloud Storage-Bucket.
Nächste Schritte
- SSL-Zertifikat (TLS) bereitstellen und an den
EdgeCacheService
anhängen. - Mit Cloud Logging Anfragelogs anzeigen
- Signierte Anfragen konfigurieren, um Ihre Inhalte zu schützen.
- Cache-Schlüssel und TTLs optimieren und die Cache-Trefferquoten verbessern.
- Konfigurieren Sie den erweiterten Routenabgleich und erstellen Sie zusätzliche Ursprünge.