Erste Schritte

Auf dieser Seite erfahren Sie, wie Sie die Bildoptimierung von Cloud CDN verwenden. Außerdem finden Sie Informationen zur Konfiguration der Bildoptimierung und eine Liste der unterstützten Vorgänge mit Beispielen.

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 und die Bildoptimierungsfunktion muss für diese URL-Zuordnungsroute aktiv sein.

  • Die Bildoptimierung wird nur für globale externe Application Load Balancer unterstützt. Der klassische Application Load Balancer wird 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

Für die Bildoptimierung muss das Caching aktiviert sein. Konfigurieren Sie mindestens eine der folgenden Optionen:

  • Backend-basiertes Caching: Achten Sie darauf, dass das Kästchen Cloud CDN aktivieren für das Backend angeklickt ist.

  • Caching auf URL-Zuordnungsebene: Achten Sie darauf, dass eine Cache-Richtlinie auf der URL-Zuordnungsebene für den spezifischen Pfad konfiguriert ist, für den Sie die Bildoptimierung aktivieren möchten.

gcloud

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

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 imageOptimizationPolicy hinzu zu den ausgewählten Abschnitten routeAction oder defaultRouteAction.

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

Console

  1. Rufen Sie in der Console von Google Cloud die Seite Load Balancing auf.

    Zur Seite „Load-Balancing“

  2. Klicken Sie auf den Namen Ihres globalen externen Application Load Balancers.
  3. Klicken Sie auf Bearbeiten .
  4. Rufen Sie den Tab Backend-Konfiguration auf.
  5. Caching konfigurieren:Für die Bildoptimierung muss das Caching aktiviert sein, damit die Konfiguration gespeichert werden kann. Wählen Sie eine der folgenden Optionen aus und konfigurieren Sie sie, damit die Bildoptimierung funktioniert.
    • Backend-basiert:Achten Sie darauf, dass in den Konfigurationen des Backend-Dienstes die Option Cloud CDN aktivieren ausgewählt ist.
    • **URL-Zuordnungsebene**
      1. Rufen Sie Routingregeln auf und wählen Sie Erweiterte Host- und Pfadregel aus.
      2. Definieren Sie eine Cache-Richtlinie auf URL-Zuordnungsebene für die Route, auf der Sie die Bildoptimierung aktivieren.

Wählen Sie je nach Routingarchitektur eine der Routingregeln aus:

So verwenden Sie die Standardroutingregel:

  1. Wählen Sie im Abschnitt Host- und Pfadregeln unter Aktion die Option Traffic an ein einzelnes Backend weiterleiten aus und wählen Sie dann ein Backend aus der Liste aus.
  2. Maximieren Sie den Abschnitt Bildoptimierung (standardmäßig minimiert).
  3. Klicken Sie das Kästchen Bildoptimierung aktivieren an.

So verwenden Sie die benutzerdefinierte Routingregel:

  1. Wählen Sie im Abschnitt Host- und Pfadregeln die Option Host- und Pfadregel hinzufügen aus.
  2. Geben Sie im Feld Hosts ein Sternchen (*) ein, um alle Hostnamen abzugleichen.
  3. Definieren Sie Ihre Konfiguration im YAML-Editor im Abschnitt Pfadabgleich.
  4. Klicken Sie unter dem YAML-Editor auf Codeanleitung , um eine Anleitung zum Code zu erhalten.
  5. Kopieren Sie das Snippet und fügen Sie es in den YAML-Editor ein.
  6. Aktualisieren Sie die Platzhalterwerte.

Konfigurationen überprüfen

  1. Überprüfen Sie Ihre Konfigurationen.
  2. Klicken Sie auf Fertig , um den Untereditor zu schließen.
  3. Klicken Sie auf Aktualisieren , um Ihre Konfigurationen zu speichern.

Unterstützte Bildformate

Die Bildoptimierung von Cloud CDN unterstützt eine Vielzahl von Eingabeformaten von Ihrem Ursprungsserver. Die meisten Formate können für die Verarbeitung und Ausgabe verwendet werden. Einige Formate sind jedoch nur für die Eingabe geeignet und können nicht als Zielausgabeformate verwendet werden.

Die folgenden Bildformate werden von Ihrem Ursprungsserver unterstützt:

Format Content-Type-Header Eingabe/Ausgabe Anwendungsfall
gif image/gif Eingabe und Ausgabe Standardformat für animierte und statische Bilder. Animierte Frames können mit dem Freeze Vorgang extrahiert werden.
png image/png Eingabe und Ausgabe Verlustfreies Format, ideal für Transparenz, Logos und digitale Kunst.
webp image/webp Eingabe und Ausgabe Modernes, weboptimiertes Format mit verlustbehafteter und verlustfreier Komprimierung.
jpeg image/jpeg Eingabe und Ausgabe Standardformat für Fotos.
brunsli image/x-j Eingabe und Ausgabe Hocheffizientes, verlustfreies JPEG-Repacking-Format.
tiff image/tiff Eingabe und Ausgabe Tagbasiertes Rasterformat in hoher Qualität.
avif image/avif Eingabe und Ausgabe Hocheffizientes Bildformat der nächsten Generation.
bmp image/bmp Nur Eingabe Kann nicht als Ausgabeformat angegeben werden. Mit in WEBP oder JPEG konvertieren unter Verwendung von ?imop=Convert,format=webp.
ico text/ico, image/ico, image/icon, application/ico, image/x-icon, image/vnd.microsoft.icon Nur Eingabe Symbolcontainerformat. Kann nicht exportiert werden. Konvertieren Sie es für die Bereitstellung in ein unterstütztes Ausgabeformat.
jp2k image/jp2 Nur Eingabe JPEG 2000-Format. Muss explizit mit einem Convert Vorgang konvertiert werden.
heif image/heif Nur Eingabe Hocheffizientes Bildformat. Muss vor der Edge-Bereitstellung konvertiert werden.

URL für die Bildtransformation

Wenn Sie dynamische Bildtransformationen ausführen möchten, fügen Sie den Abfrageparameter imop 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 und diese Funktion wird 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