Media CDN-Dienst einrichten

Console

1. Aktivieren Sie die Network Services API.

   API aktivieren

2. Aktivieren Sie die Certificate Manager API.

   API aktivieren

gcloud

1. Aktivieren Sie die Network Services API:

   gcloud services enable networkservices.googleapis.com
   

2. Aktivieren Sie die Certificate Manager API:

   gcloud services enable certificatemanager.googleapis.com
   

Console

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

   Zum Media CDN

2. Klicken Sie auf den Tab Origins.

3. Klicken Sie auf Ursprung erstellen.

4. Geben Sie cloud-storage-origin als Namen für den Ursprung ein.

5. Optional: Geben Sie eine Beschreibung für den Ursprung ein.

6. 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.

7. Klicken Sie auf Ursprung erstellen.

Nach etwa 10 Minuten wird die neu erstellte EdgeCacheOrigin-Ressource in der Liste der Ursprünge in Ihrem Projekt auf der Seite Origins angezeigt.

Wenn Sie eine Startadresse aktualisieren möchten, klicken Sie auf den Startpunkt und dann auf editBearbeiten.

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, 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 Format projects/PROJECT/locations/global
• ORIGIN_ID: der Kurzname des neuen Ursprungs

• ADDRESS: 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 anzuzeigen.

Verwenden Sie zum Aktualisieren der Herkunftsadresse die Methode edgeCacheOrigins.patch.

Terraform

resource "google_network_services_edge_cache_origin" "default" {
  name           = "cloud-storage-origin"
  origin_address = "gs://my-bucket-${random_id.unique_suffix.hex}"
}

Console

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

   Zum Media CDN

2. Klicken Sie auf den Tab Services (Dienste).

3. Klicken Sie auf Dienst erstellen.

4. Geben Sie einen eindeutigen Namen für den Dienst ein, z. B. my-service, und klicken Sie dann auf Weiter.

5. Klicken Sie im Abschnitt Routing auf Hostregel hinzufügen und geben Sie dann einen oder mehrere Hostdomainnamen ein.

6. Geben Sie für Hosts einen Domainnamen ein, z. B. web.example.com.

7. Klicken Sie auf Weiterleitungsregel hinzufügen.

   1. Geben Sie unter Priority (Priorität) den Wert 1 an.
   2. Klicken Sie auf Übereinstimmungsbedingung hinzufügen, geben Sie für Pfadübereinstimmung den Wert / an und klicken Sie dann auf Fertig.
   3. Wählen Sie Von einem Ursprung abrufen und dann den von Ihnen konfigurierten Ursprung aus.
   4. Klicken Sie auf Add-on-Aktionen.
   5. Klicken Sie unter Header action (Headeraktion) auf Add an item (Element hinzufügen). Führen Sie anschließend folgende Schritte aus:
      1. Wählen Sie für Type (Typ) die Option Add Header aus, die hinzugefügt werden sollen.
      2. Klicken Sie auf Header hinzufügen.
      3. Geben Sie für Name x-cache-status und für Wert {cdn_cache_status} an.
      4. Klicken Sie auf Fertig.
   6. Klicken Sie unter Routenaktion auf Element hinzufügen. Führen Sie anschließend folgende Schritte aus:
      1. Wählen Sie für Typ die Option CDN-Richtlinie aus.
      2. Wählen Sie für Cache-Modus die Option FORCE_CACHE_ALL aus.
      3. Klicken Sie auf Fertig.
   7. Klicken Sie auf Speichern.

8. Klicken Sie auf Dienst erstellen.

Die neu erstellte EdgeCacheService-Ressource wird auf der Seite Dienste in der Liste der Dienste in Ihrem Projekt angezeigt.

gcloud

1. Erstellen Sie in Cloud Shell mit einem Texteditor eine lokale Datei mit dem Namen my-service.yaml.

   Eine solche Datei gibt Folgendes an:

   • So funktioniert das Routing: Zuerst wird der Host und dann der Pfad abgeglichen.
   • So funktioniert das Caching – basierend auf dem Cache-Modus und dem TTL-Wert
   • Wie Anfragen und Antworten geändert werden, z. B. durch Einfügen der Variablen cdn_cache_status in einen Antwortheader

2. 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: Name des Dienstes

   • DOMAIN: die Domain für den neuen Dienst

     Wenn Sie den Domainnamen angeben, antwortet Media CDN mit einem 404-Fehler für andere Hosts.

   • ORIGIN: der Name des zugehörigen Ursprungs

3. Verwenden Sie den gcloud edge-cache services import-Befehl mit der YAML-Datei:

   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 der EdgeCacheService-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 Format projects/PROJECT/locations/global
• SERVICE_ID: der Name des Dienstes

• DOMAIN: die Domain für den neuen Dienst

  Wenn Sie den Domainnamen angeben, antwortet Media CDN mit einem 404-Fehler für andere Hosts.

• ORIGIN_NAME: der Name des zugehörigen Ursprungs

Verwenden Sie die edgeCacheServices.list-Methode, um den neu erstellten Dienst in der Liste der EdgeCacheService-Ressourcen in Ihrem Projekt aufzurufen.

Terraform

resource "google_network_services_edge_cache_service" "default" {
  name = "cloud-media-service"
  routing {
    host_rule {
      hosts        = ["googlecloudexample.com"]
      path_matcher = "routes"
    }
    path_matcher {
      name = "routes"
      route_rule {
        description = "a default route rule, priority=10 (low)"
        priority    = 10
        match_rule {
          prefix_match = "/"
        }
        origin = google_network_services_edge_cache_origin.default.name
        route_action {
          cdn_policy {
            cache_mode  = "CACHE_ALL_STATIC"
            default_ttl = "3600s"
          }
        }
        header_action {
          response_header_to_add {
            header_name  = "x-cache-status"
            header_value = "{cdn_cache_status}"
          }
        }
      }
    }
  }
}

Console

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

   Zum Media CDN

2. Klicken Sie auf den Tab Services (Dienste).

3. Die IP-Adressen Ihres 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 sind:

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.

Die abgerufenen Details enthalten die dem Dienst zugewiesenen IP-Adressen:

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS

Console

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

   Zum Media CDN

2. Klicken Sie auf den Tab Services (Dienste).

3. Wählen Sie Ihren Dienst aus und klicken Sie auf Löschen.

4. Klicken Sie auf den Tab Origins.

5. Wählen Sie den Ursprung aus und klicken Sie auf Löschen.

gcloud

1. Verwenden Sie den Befehl gcloud edge-cache origins list und den Befehl gcloud edge-cache services list, um die erstellten Ressourcen aufzulisten.

2. Verwenden Sie zum Löschen des Dienstes den Befehl gcloud edge-cache services delete:

   gcloud edge-cache services delete SERVICE
   

   Ersetzen Sie SERVICE durch den Namen des Dienstes.

3. Verwenden Sie zum Löschen des Ursprungs den Befehl gcloud edge-cache origins delete:

   gcloud edge-cache origins delete ORIGIN
   

   Ersetzen Sie ORIGIN durch den Namen des Ursprungs.

API

1. Verwenden Sie die Methode edgeCacheServices.list und die Methode edgeCacheOrigins.list, um die von Ihnen erstellten Ressourcen aufzulisten.

2. Verwenden Sie zum Löschen des Dienstes die Methode edgeCacheServices.delete:

   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.

3. Verwenden Sie zum Löschen des Ursprungs die Methode edgeCacheOrigins.delete:

   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.