Plug-ins verwalten

Auf dieser Seite wird beschrieben, wie Sie Plugins, die mit Service Extensions erstellt wurden, aufrufen, bearbeiten und löschen können.

Die Funktion „Plug-ins“ befindet sich für Media CDN im Vorschaumodus.

Eine Produktübersicht finden Sie unter Übersicht über Diensterweiterungen.

Plug‑ins ansehen

In diesem Abschnitt wird beschrieben, wie Sie Plug-ins und Plug-in-Versionen aufrufen können, die mit Service Extensions erstellt wurden.

Plug-ins auflisten

So listen Sie die Plug-ins in Ihrem Projekt auf:

Console

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

   Zu den Diensterweiterungen

2. Klicken Sie auf den Tab Plugins.

   Eine Liste der Plug-ins wird in einer sortierbaren Tabelle mit den folgenden Informationen angezeigt:

   • Status: Der Status des Plug-ins. Wenn kein Dienst angehängt ist, ist der Wert Not attached. Wenn ein Dienst mit einem Plug‑in verknüpft ist, lautet der Wert Attached.
   • Name: Der Name des Plug-ins.
   • Hauptversion: Die aktive Version des Plug‑ins.
   • Produkt: Das Google Cloud Produkt, dem das Plug-in zugeordnet ist.
   • Typ: Der Typ der Erweiterung.
   • Bereich: Der Bereich des Plug‑ins.
   • Region: Die Region, wenn der Plug-in-Bereich Regional ist.
   • Wird verwendet von: Eine oder mehrere Erweiterungen, denen das Plug-in zugeordnet ist.
   • Zuletzt geändert: Die Uhrzeit, zu der das Plug-in zuletzt geändert wurde.
   • Labels: Die dem Plug-in hinzugefügten Labels.

3. Optional: So filtern Sie die Liste:

   1. Klicken Sie neben Tabelle filtern, um eine Liste der Attribute aufzurufen.

   2. Wählen Sie eine Property aus der Liste aus.

      Der Name der Eigenschaft, gefolgt von einem Doppelpunkt, wird neben dem Label Filtertabelle angezeigt.

   3. Fügen Sie ein Leerzeichen neben dem Doppelpunkt ein, um eine Liste mit Werten aufzurufen, die der Property entsprechen, und wählen Sie dann einen Wert aus der Liste aus.

   4. Optional: Geben Sie den Operator OR zwischen Property-Wert-Paaren ein, um kombinierte Filter anzugeben.

4. Optional: Wenn Sie weitere Vorgänge mit einem ausgewählten Plug-in ausführen möchten, klicken Sie auf Weitere Aktionen und wählen Sie eine Option aus:

   • Wenn Sie das Plug-in bearbeiten möchten, klicken Sie auf Bearbeiten.
   • Wenn Sie das Plug-in löschen möchten, klicken Sie auf Löschen.
   • Klicken Sie auf Im Log-Explorer ansehen, um den Log-Explorer zu öffnen. Dort können Sie Logdaten zum Plug-in abrufen, ansehen und analysieren.
   • Klicken Sie auf Monitoring ansehen, um die Seite Monitoring von Dienst-Extensions zu öffnen.

gcloud

Führen Sie den Befehl gcloud service-extensions wasm-plugins list aus:

gcloud service-extensions wasm-plugins list \
    --location=LOCATION

Ersetzen Sie LOCATION durch den Speicherort des Plug-ins, entweder global oder eine Region.

Die Plug-ins in Ihrem Projekt sind in einer Tabelle mit den folgenden Informationen aufgeführt:

• Name: der Name des Plug-ins
• Beschreibung: die Beschreibung des Plug-ins
• Hauptversion: Die aktive Version des Plug‑ins
• Aktualisierungszeit: Der Zeitpunkt, zu dem das Plug-in zuletzt geändert wurde.

Details eines Plug‑ins ansehen

Verwenden Sie eine der folgenden Methoden, um die Details eines Plug-ins aufzurufen:

Console

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

   Zu den Diensterweiterungen

2. Klicken Sie auf den Tab Plugins.

3. Klicken Sie auf den Namen des Plug-ins, für das Sie Details aufrufen möchten.

   Die Seite Details für das Plug-in wird geöffnet. Die Seite enthält die folgenden Abschnitte:

   • Grundlegende Informationen: In diesem Abschnitt werden grundlegende Details zum Plug-in angezeigt, darunter das Google Cloud Produkt, dem das Plug-in zugeordnet ist, der Load-Balancer-Typ, der Erweiterungstyp, die Erweiterungen, die das Plug-in verwenden, der Plug-in-Bereich, die Zeitstempel für die Erstellung und Änderung des Plug-ins, die Größe des Plug-ins, Labels und, falls die Protokollierung aktiviert ist, die Protokollierungs-Stichprobenrate und die Mindestprotokollierungsstufe.

   • Versionen: In diesem Bereich werden Details zu Plug-in-Versionen angezeigt, darunter die Version des Plug-ins, der Erstellungszeitstempel, eine angegebene Beschreibung, der URI und die Digests für das Image sowie die Plug-in-Konfigurationsdatei oder das Image und die zugehörigen Digests.

     Sie können auf die Bild-URL klicken, um die zugehörigen Details aufzurufen.

gcloud

Führen Sie den gcloud service-extensions wasm-plugins describe-Befehl aus, um die Details eines Plug-ins aufzurufen:

 gcloud service-extensions wasm-plugins describe WASM_PLUGIN \
     --location=LOCATION

Ersetzen Sie Folgendes:

• WASM_PLUGIN: der Name des Plug-ins
• LOCATION: Der Standort des Plug-ins als global oder eine Region

Die folgenden Details zum Plug-in werden angezeigt:

• Der Name des Plug-ins
• Die Zeitstempel für die Erstellung und Änderung des Plug‑ins
• Die Labels
• Die Log-Abtastrate (wenn das Logging aktiviert ist)

Verwenden Sie den Befehl gcloud service-extensions wasm-plugin-versions list, um die Versionen für ein Plug-in aufzulisten:

 gcloud service-extensions wasm-plugin-versions list WASM_PLUGIN \
     --location=LOCATION

Ersetzen Sie Folgendes:

• WASM_PLUGIN: der Name des Plug-ins
• LOCATION: Der Standort des Plug-ins als global oder eine Region

Die Versionen des angegebenen Plug-ins werden in einer Tabelle mit dem Namen des Plug-ins aufgeführt.

Wenn Sie die Details einer Plugin-Version aufrufen möchten, verwenden Sie den Befehl gcloud service-extensions wasm-plugin-versions describe:

 gcloud service-extensions wasm-plugin-versions describe WASM_PLUGIN_VERSION \
     --location=LOCATION

Ersetzen Sie Folgendes:

• WASM_PLUGIN_VERSION: die Hauptversion des Plugins
• LOCATION: Der Standort des Plug-ins als global oder eine Region

Die folgenden Details zur Plugin-Version werden angezeigt:

• Der Versionsname
• Zeitstempel der Erstellung
• Eine Beschreibung, falls sie eingegeben wurde
• Der URI und die Digests für das Image
• Die Plug‑in-Konfigurationsdatei oder das Plug‑in-Konfigurationsimage und die zugehörigen Digests

Plug-ins bearbeiten

In diesem Abschnitt wird beschrieben, wie Sie mit Service Extensions erstellte Plug-ins bearbeiten können.

Plug‑in bearbeiten

So bearbeiten Sie ein Plug-in:

Console

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

   Zu den Diensterweiterungen

2. Klicken Sie auf den Tab Plugins.

3. Klicken Sie für das Plug-in, das Sie bearbeiten möchten, auf das Dreipunkt-Menü Weitere Aktionen und wählen Sie dann Bearbeiten aus.

   Klicken Sie alternativ auf den Namen des Plug-ins und dann auf der Seite Details auf Bearbeiten.

   Auf der Seite Plug-in bearbeiten kann der Name des Plug-ins nicht bearbeitet werden. Sie können weitere Details bearbeiten.

4. Nehmen Sie die erforderlichen Änderungen vor.

   Informationen zu den meisten Feldern finden Sie unter Plugin erstellen.

   Informationen zum Abschnitt Versionen finden Sie unter Neue Version eines Plug-ins hinzufügen.

5. Klicken Sie auf Plug-in aktualisieren.

gcloud

Führen Sie den Befehl gcloud service-extensions wasm-plugins update aus:

gcloud service-extensions wasm-plugins update WASM_PLUGIN \
   --location=LOCATION \
   --description=PLUGIN_DESCRIPTION \
   --labels=[LABELS,...]

Ersetzen Sie Folgendes:

• WASM_PLUGIN: der Name des Plug-ins
• LOCATION: Der Standort des Plug-ins als global oder eine Region
• PLUGIN_DESCRIPTION: die Beschreibung des Plugins
• LABELS: Labels in Form von durch Kommas getrennten Schlüssel/Wert-Paaren

Neue Version eines Plug-ins hinzufügen

Sie können eine neue Version des Plug-in-Codes erstellen und sie dann als neue Version des Plug-ins hinzufügen.

So fügen Sie eine neue Version eines Plug-ins hinzu:

Console

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

   Zu den Diensterweiterungen

2. Klicken Sie auf den Tab Plugins.

3. Klicken Sie auf Bearbeiten.

4. Klicken Sie im Abschnitt Versionen auf Version hinzufügen.

5. Geben Sie im Bereich Version hinzufügen die Details für die Plugin-Version an.

6. Optional: Klicken Sie das Kästchen Als Hauptkonto festlegen an.

   Sie können diese Version auch später als Hauptversion festlegen.

7. Klicken Sie auf Hinzufügen.

8. Klicken Sie auf Plug-in aktualisieren.

gcloud

Führen Sie den Befehl gcloud service-extensions wasm-plugins update aus:

 gcloud service-extensions wasm-plugins update WASM_PLUGIN \
     --location=LOCATION \
     --image=IMAGE \
     --main-version=MAIN_VERSION \
     --plugin-config=PLUGIN_CONFIG | --plugin-config-file=PLUGIN_CONFIG_FILE | --plugin-config-uri=PLUGIN_CONFIG_URI

Ersetzen Sie Folgendes:

• WASM_PLUGIN: die ID oder der voll qualifizierte Name des Plug-ins
• LOCATION: Der Standort des Plug-ins als global oder eine Region
• IMAGE: Der URI des neuen Wasm-Moduls, das im Artifact Registry-Repository gespeichert ist.
• MAIN_VERSION: Die ID der zu erstellenden und als Hauptversion (oder Bereitstellungsversion) festzulegenden Plugin-Version.
• PLUGIN_CONFIG, PLUGIN_CONFIG_FILE oder PLUGIN_CONFIG_URI: die optionale Konfigurationsdatei, die inline als Text, als lokale Datei oder als Bild in Artifact Registry angegeben werden kann.

Hinweis :Wenn Sie eine neue Plug-in-Version erstellen möchten, ohne sie als Hauptversion festzulegen, verwenden Sie den Befehl gcloud service-extensions wasm-plugins create.

Hauptversion eines Plug‑ins ändern

So ändern Sie die Hauptversion eines Plug-ins:

Console

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

   Zu den Diensterweiterungen

2. Klicken Sie auf den Tab Plugins.

3. Klicken Sie auf Bearbeiten.

4. Wählen Sie im Bereich Versionen eine inaktive Version aus und klicken Sie dann auf Als Hauptversion festlegen.

   Alternativ können Sie beim Erstellen einer neuen Version des Plugins festlegen, dass die Version die Hauptversion sein soll.

5. Klicken Sie auf Plug-in aktualisieren.

gcloud

Führen Sie den Befehl gcloud service-extensions wasm-plugins update aus:

 gcloud service-extensions wasm-plugins update \
     --location=LOCATION \
     --main-version=WASM_PLUGIN_VERSION

Ersetzen Sie Folgendes:

• LOCATION: Der Standort des Plug-ins als global oder eine Region
• WASM_PLUGIN_VERSION: der Name der Hauptversion des Plug-ins

Es kann einige Minuten dauern, bis die neue Plugin-Version an allen Standorten verfügbar ist. Die Anzahl der Minuten kann je nach Standort variieren, da das Plug-in nicht gleichzeitig an allen Standorten bereitgestellt wird.

Hinweis :Wenn Sie ein Rollback für ein Plug-in durchführen möchten, legen Sie eine frühere Version als Hauptversion fest.

Plug-ins löschen

In diesem Abschnitt wird beschrieben, wie Sie Plug-ins und Plug-in-Versionen löschen, die mit Service Extensions erstellt wurden.

Plug-in löschen

So löschen Sie ein Plug-in:

Console

1. Rufen Sie die Seite Diensterweiterungen auf.

   Zu den Diensterweiterungen

2. Klicken Sie auf den Tab Plugins.

3. Klicken Sie für das Plug-in, das Sie löschen möchten, auf die Schaltfläche Weitere Aktionen und wählen Sie dann Löschen aus.

   Alternativ können Sie auf den Namen des Plug-ins und dann auf der Seite Details auf die Schaltfläche Löschen klicken.

   Plug-ins, die von einer Erweiterung verwendet werden, können nicht gelöscht werden. Wenn Sie ein solches Plug-in löschen möchten, müssen Sie zuerst die Erweiterung ändern, um das Plug-in zu entfernen, oder die Erweiterung löschen.

4. Bestätigen Sie den Vorgang im Bestätigungsfeld, indem Sie auf Löschen klicken.

gcloud

1. Entfernen Sie die Verweise auf das Plug-in aus der Dienstkonfiguration und importieren Sie die YAML-Konfigurationsdatei dann noch einmal.

   Weitere Informationen finden Sie unter Cloud Load Balancing-Plug-ins und Traffic-Plug-ins konfigurieren sowie Media CDN-Plug-ins.

2. Führen Sie den Befehl gcloud service-extensions wasm-plugins delete aus:

   gcloud service-extensions wasm-plugins delete WASM_PLUGIN \
       --location=LOCATION
   

   Ersetzen Sie Folgendes:

   • WASM_PLUGIN: der Name des Plug-ins
   • LOCATION: Der Standort des Plug-ins als global oder eine Region

Wenn Sie ein Plug‑in löschen, werden auch die zugehörigen Plug‑in-Ressourcen gelöscht.

Plug-in-Version löschen

So löschen Sie eine Version eines Plug-ins:

Console

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

   Zu den Diensterweiterungen

2. Klicken Sie auf den Tab Plugins.

3. Wählen Sie das Plugin aus, das Sie bearbeiten möchten, und wechseln Sie in den Bearbeitungsmodus.

4. Wählen Sie im Bereich Versionen die Kästchen für die Versionen aus, die Sie löschen möchten, und klicken Sie dann auf Löschen.

5. Klicken Sie auf Plug-in aktualisieren.

gcloud

Führen Sie den Befehl gcloud service-extensions wasm-plugin-versions delete aus:

 gcloud service-extensions wasm-plugin-versions delete WASM_PLUGIN_VERSION \
     --location=LOCATION

Ersetzen Sie Folgendes:

• WASM_PLUGIN_VERSION: Der Name einer Plugin-Version, die nicht als Hauptversion verwendet wird.
• LOCATION: Der Standort des Plug-ins als global oder eine Region

Wenn eine Version als Hauptversion festgelegt ist, also die Hauptversion (aktiv), können Sie sie erst löschen, nachdem Sie eine andere Version als Hauptversion festgelegt haben.

Nächste Schritte

• Informationen zum Erstellen von Plug-ins
• Weitere Informationen finden Sie unter Übersicht über Diensterweiterungen.