Erste Schritte

Auf dieser Seite erfahren Sie, wie Sie die Bildoptimierung von Cloud CDN verwenden. Außerdem wird erklärt, wie Sie die Bildoptimierung konfigurieren und welche unterstützten Vorgänge es gibt. Beispiele sind ebenfalls enthalten.

Vorbereitung

Damit die Bildoptimierung von Cloud CDN funktioniert, müssen die folgenden Voraussetzungen erfüllt sein:

  • Die Cloud CDN-Cache-Richtlinie muss für die URL-Route oder den zugehörigen Backend-Dienst oder -Bucket aktiviert sein. Die Bildoptimierungsfunktion muss für diese URL-Zuordnungsroute aktiv sein.

  • Die Bildoptimierung wird nur für globale externe Application Load Balancer unterstützt. Klassische Application Load Balancer werden nicht unterstützt.

  • Die Clientanfrage muss einen Accept-Header enthalten, der angibt, dass sie Bildinhalte empfangen kann, z. B. image/webp, image/avif, image/* oder */*.

  • Der Ursprungsserver muss mit dem Statuscode HTTP 200 und einem unterstützten Content-Type-Header für Bilder antworten.

  • Der Abfrageparameter imop muss in der URL enthalten sein und einen oder mehrere gültige Transformationsvorgänge enthalten.

Bildoptimierung konfigurieren

Wenn Sie die Bildoptimierung verwenden möchten, müssen Sie Cloud CDN für die entsprechende Route, den Backend-Dienst oder den Backend-Bucket aktivieren.

gcloud

Sie müssen Ihrer YAML-Datei Konfigurationen hinzufügen und sie in die URL-Zuordnung importieren, da Bildoptimierungsrichtlinien im Objekt `routeAction` definiert werden.

Exportieren Sie Ihre vorhandene URL-Zuordnungskonfiguration in eine lokale YAML-Datei:

gcloud beta compute url-maps export YOUR_URL_MAP_NAME \
    --global \
    --destination my-url-map.yaml

Bearbeiten Sie die Datei my-url-map.yaml in einem Texteditor und fügen Sie das Feld cachePolicy zu den ausgewählten Abschnitten routeAction oder defaultRouteAction hinzu.

name: image-matcher
routeRules:
  --description: ImageOptimizationService
    matchRules:
       --prefixMatch: /images/
    priority: 1
    routeAction:
       imageOptimizationPolicy:
         queryParameterInterpretation: ENABLED

Aktualisierte URL-Zuordnung importieren

gcloud beta compute url-maps import YOUR_URL_MAP_NAME \
    --global \
    --source my-url-map.yaml

Unterstützte Bildformate

Die Bildoptimierung von Cloud CDN unterstützt bestimmte Eingabe- und Ausgabeformate, die auf der Anfragekonfiguration und den Headern für den Ursprungs-Content-Type basieren.

Unterstützte Eingabeformate

Die folgenden Formate werden als Eingabe von Ihrem Ursprungsserver unterstützt:

  • HEIF
  • ICO
  • BMP
  • JP2K (JPEG 2000)

Unterstützte Ausgabeformate

Cloud CDN Edge kann optimierte Bild derivate in den folgenden Formaten verarbeiten, im Cache speichern und bereitstellen:

  • JPEG
  • GIF
  • PNG
  • TIFF
  • WEBP
  • AVIF
  • BRUNSLI

Unterstützte Ursprungs-Content-Types

Die Bildoptimierung wird versucht, wenn Ihr Ursprungsserver mit einem der folgenden Content-Type-Header antwortet:

  • image/jpeg
  • image/png
  • image/webp
  • image/gif
  • image/bmp
  • image/tiff
  • image/avif
  • image/heif
  • image/jp2
  • image/x-j (brunsli)
  • text/ico, image/ico, image/icon, application/ico, image/x-icon oder image/vnd.microsoft.icon

URL für die Bildtransformation

Wenn Sie dynamische Bildtransformationen durchführen möchten, fügen Sie den Abfrageparameter imop zu Ihrer Bild-URL hinzu. Dieser Parameter enthält einen Transformationsstring, der aus einem oder mehreren Vorgängen besteht, die nacheinander angewendet werden.

Für den Transformationsstring gelten die folgenden Formatierungsregeln:

  • Trennen Sie die einzelnen Vorgänge durch ein Semikolon (;).
  • Trennen Sie die internen Parameter innerhalb der einzelnen Vorgänge durch ein Komma (,).
  • In einem einzelnen Abfragestring kann nur ein Vorgang eines bestimmten Typs enthalten sein.

Die Basissyntax hat die folgende Struktur:

?imop=[OPERATION_1];[OPERATION_2];...[OPERATION_N]

Wenn Sie mehrere Aktionen gleichzeitig auf ein Bild anwenden möchten, hängen Sie einen verketteten Parameterstring an die Bild-URL an. Wenn Sie beispielsweise die Breite eines Bildes auf 800 Pixel festlegen, die Komprimierungsqualität auf 85 setzen und das Format in WebP konvertieren möchten, hängen Sie den Parameterstring an.

Beispiel:

https://www.example.com/image.jpg?imop=Resize,width=800;Compress,quality=85;Convert,format=webp;

Richtlinienstruktur

Die Bildoptimierungsrichtlinie dient als Wrapper für die Kernkonfiguration und enthält alle Eigenschaften, die für die Funktionalität der Bildoptimierungsfunktion relevant sind.

Name

Beschreibung

Konfiguration

queryParameterInterpretation

Enum-Wert, der bestimmt, ob der Abfrageparameter für die Bild optimierung in der Datenebene interpretiert wird.

Erforderlich. Wenn die Option auf DISABLED gesetzt ist, werden Abfrageparameter für Transformation von der Richtlinie ignoriert. Dadurch wird diese Funktion deaktiviert. Wenn die Option auf ENABLED gesetzt ist, wird diese Funktion aktiviert.

Richtlinienabhängigkeiten und -validierung

Die Bildoptimierungsrichtlinie ist von der Cloud CDN-Cache-Richtlinie abhängig. Damit diese Funktion funktioniert, muss eine Cache-Richtlinie explizit an einer der folgenden Stellen festgelegt werden:

  • Dieselbe URL-Zuordnungsroute, auf der die Bildoptimierungsrichtlinie konfiguriert wird.

  • Ein Backend-Dienst oder Backend-Bucket, der mit dieser Route verknüpft ist.

Die Bildoptimierungsrichtlinie wird ausschließlich in Verbindung mit der aktiven zugrunde liegenden Cache-Richtlinie angewendet.

Regeln für die Reihenfolge der Bildoptimierung

Die im Abfrageparameter imop aufgeführten Vorgänge werden von links nach rechts verarbeitet, mit Ausnahme der folgenden absoluten Systemüberschreibungen:

  • Die Vorgänge metadata und scale werden immer zuerst ausgeführt.
  • Die Vorgänge canvas werden immer zuletzt ausgeführt.

Alle Eingabe-Assets werden automatisch normalisiert, bevor diese Transformationen ausgeführt werden. EXIF-Ausrichtungsmarker und ICC-Farbprofile werden direkt auf die Bildpixel angewendet, bevor Metadaten entfernt werden. So bleibt die Koordinatenintegrität für nachfolgende strukturelle Aktionen erhalten.

Nächste Schritte