Gérer les plug-ins

Cette page explique comment afficher, modifier et supprimer les plug-ins créés à l'aide des extensions de service.

La fonctionnalité de plug-ins est disponible en version preview pour Media CDN.

Pour obtenir une présentation du produit, consultez Présentation des extensions de service.

Afficher les plug-ins

Cette section explique comment afficher les plug-ins et les versions de plug-ins créés à l'aide des extensions de service.

Lister les plug-ins

Pour lister les plug-ins de votre projet, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plugins.

    La liste des plug-ins s'affiche dans un tableau triable contenant les informations suivantes :

    • État : état du plug-in. Si aucun service n'est associé, la valeur est Not attached. Si un service est associé à un plug-in, la valeur est Attached.
    • Nom : nom du plug-in.
    • Version principale : version active du plug-in.
    • Produit : produit Google Cloud auquel le plug-in est associé.
    • Type : type d'extension.
    • Champ d'application : champ d'application du plug-in.
    • Région : région lorsque le champ d'application du plug-in est Regional.
    • Utilisé par : une ou plusieurs extensions auxquelles le plug-in est associé.
    • Dernière modification : date et heure de la dernière modification du plug-in.
    • Libellés : libellés ajoutés au plug-in.

  3. Facultatif : Pour filtrer la liste, procédez comme suit :

    1. Cliquez à côté de Filtrer le tableau pour afficher la liste des propriétés.

    2. Dans la liste, sélectionnez une propriété.

      Le nom de la propriété, suivi d'un deux-points, s'affiche à côté du libellé Filtrer le tableau.

    3. Insérez un espace après le deux-points pour afficher la liste des valeurs correspondant à la propriété, puis sélectionnez une valeur dans la liste.

    4. Facultatif : Saisissez l'opérateur OR entre les paires propriété-valeur pour spécifier des filtres combinés.

  4. (Facultatif) Pour effectuer d'autres opérations avec un plug-in sélectionné, cliquez sur Autres actions, puis sélectionnez une option :

gcloud

Exécutez la commande gcloud service-extensions wasm-plugins list suivante :

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

Remplacez LOCATION par l'emplacement du plug-in, soit global, soit une région.

Les plug-ins de votre projet sont listés dans un tableau contenant les informations suivantes :

  • Name : nom du plug-in
  • Description : description du plug-in
  • Version principale : version active du plug-in
  • Heure de mise à jour : heure de la dernière modification du plug-in

Afficher les détails d'un plug-in

Pour afficher les détails d'un plug-in, utilisez l'une des méthodes suivantes :

Console

  1. Dans la console Google Cloud , accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plugins.

  3. Cliquez sur le nom du plug-in dont vous souhaitez afficher les détails.

    La page Détails du plug-in s'ouvre. La page comporte les sections suivantes :

    • Informations de base : cette section affiche des informations de base sur le plug-in, y compris le produit Google Cloud auquel le plug-in est associé, le type d'équilibreur de charge, le type d'extension, les extensions qui utilisent le plug-in, le champ d'application du plug-in, les codes temporels de création et de modification du plug-in, la taille du plug-in, les libellés et, si la journalisation est activée, le taux d'échantillonnage des journaux et le niveau de journalisation minimal.

    • Versions : cette section affiche des informations sur les versions du plug-in, y compris la version du plug-in, le code temporel de création, toute description spécifiée, l'URI et les résumés de l'image, ainsi que le fichier de configuration ou l'image du plug-in et les résumés associés.

      Vous pouvez cliquer sur l'URL de l'image pour afficher ses détails.

gcloud

Pour afficher les détails d'un plug-in, exécutez la commande gcloud service-extensions wasm-plugins describe :

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

Remplacez les éléments suivants :

  • WASM_PLUGIN : nom du plug-in.
  • LOCATION : emplacement du plug-in (global ou une région)

Les informations suivantes sur le plug-in s'affichent :

  • Nom du plug-in
  • Horodatages de création et de modification du plug-in
  • Les libellés
  • Taux d'échantillonnage des journaux (si la journalisation est activée)

Pour lister les versions d'un plug-in, utilisez la commande gcloud service-extensions wasm-plugin-versions list :

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

Remplacez les éléments suivants :

  • WASM_PLUGIN : nom du plug-in.
  • LOCATION : emplacement du plug-in (global ou une région)

Les versions du plug-in spécifié sont listées dans un tableau portant le nom du plug-in.

Pour afficher les détails d'une version de plug-in, utilisez la commande gcloud service-extensions wasm-plugin-versions describe :

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

Remplacez les éléments suivants :

  • WASM_PLUGIN_VERSION : version principale du plug-in
  • LOCATION : emplacement du plug-in (global ou une région)

Les informations suivantes sur la version du plug-in s'affichent :

  • Nom de la version
  • Date et heure de création
  • Une description, si elle a été saisie
  • URI et résumés de l'image
  • Fichier ou image de configuration du plug-in et condensés associés

Modifier les plug-ins

Cette section explique comment modifier les plug-ins créés à l'aide des extensions de service.

Modifier un plug-in

Pour modifier un plug-in, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plugins.

  3. Pour le plug-in que vous souhaitez modifier, cliquez sur Autres actions, puis sélectionnez Modifier.

    Vous pouvez également cliquer sur le nom du plug-in, puis sur Détails et Modifier.

    Sur la page Modifier le plug-in, le nom du plug-in n'est pas modifiable. Vous pouvez modifier d'autres informations.

  4. Apportez les modifications nécessaires.

    Pour en savoir plus sur la plupart des champs, consultez Créer un plug-in.

    Pour en savoir plus sur la section Versions, consultez Ajouter une version d'un plug-in.

  5. Cliquez sur Mettre à jour le plug-in.

gcloud

Exécutez la commande gcloud service-extensions wasm-plugins update :

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

Remplacez les éléments suivants :

  • WASM_PLUGIN : nom du plug-in.
  • LOCATION : emplacement du plug-in (global ou une région)
  • PLUGIN_DESCRIPTION : description du plug-in
  • LABELS : libellés sous forme de paires clé/valeur séparées par des virgules

Ajouter une version d'un plug-in

Vous pouvez créer une version du code du plug-in, puis l'ajouter en tant que nouvelle version du plug-in.

Pour ajouter une version d'un plug-in :

Console

  1. Dans la console Google Cloud , accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plugins.

  3. Cliquez sur Modifier ().

  4. Dans la section Versions, cliquez sur Ajouter une version.

  5. Dans le volet Ajouter une version, spécifiez les détails de la version du plug-in.

  6. Facultatif : Cochez la case Définir comme principal.

    Vous pourrez également définir cette version comme version principale ultérieurement.

  7. Cliquez sur Ajouter.

  8. Cliquez sur Mettre à jour le plug-in.

gcloud

Exécutez la commande gcloud service-extensions wasm-plugins update :

 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

Remplacez les éléments suivants :

  • WASM_PLUGIN : ID ou nom complet du plug-in
  • LOCATION : emplacement du plug-in (global ou une région)
  • IMAGE : URI du nouveau module Wasm stocké dans le dépôt Artifact Registry.
  • MAIN_VERSION : ID de la version du plug-in à créer et à définir comme version principale (ou de diffusion).
  • PLUGIN_CONFIG, PLUGIN_CONFIG_FILE ou PLUGIN_CONFIG_URI : fichier de configuration facultatif, qui peut être spécifié de manière intégrée sous forme de texte, en tant que fichier local ou en tant qu'image dans Artifact Registry, respectivement.

Modifier la version principale d'un plug-in

Pour modifier la version principale d'un plug-in, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plugins.

  3. Cliquez sur le bouton Modifier.

  4. Dans la section Versions, sélectionnez une version inactive, puis cliquez sur Définir comme principale.

    Vous pouvez également créer une version du plug-in et la définir comme version principale.

  5. Cliquez sur Mettre à jour le plug-in.

gcloud

Exécutez la commande gcloud service-extensions wasm-plugins update :

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

Remplacez les éléments suivants :

  • LOCATION : emplacement du plug-in (global ou une région)
  • WASM_PLUGIN_VERSION : nom de la version principale du plug-in

La distribution de la nouvelle version du plug-in à tous les emplacements peut prendre quelques minutes. Le nombre de minutes peut varier selon les zones géographiques, car le plug-in n'est pas distribué simultanément dans toutes les zones.

Supprimer des plug-ins

Cette section explique comment supprimer les plug-ins et les versions de plug-ins créés à l'aide des extensions de service.

Supprimer un plug-in

Pour supprimer un plug-in, procédez comme suit :

Console

  1. Accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plugins.

  3. Pour le plug-in que vous souhaitez supprimer, cliquez sur le bouton Autres actions, puis sélectionnez Supprimer.

    Vous pouvez également cliquer sur le nom du plug-in, puis sur le bouton Supprimer sur la page Détails.

    Il est impossible de supprimer les plug-ins utilisés par une extension. Pour supprimer un tel plug-in, commencez par modifier l'extension afin de supprimer le plug-in ou supprimez l'extension.

  4. Dans la boîte de message de confirmation, confirmez l'opération en cliquant sur Supprimer.

gcloud

  1. Supprimez les références au plug-in de la configuration du service, puis réimportez le fichier YAML de configuration.

    Pour en savoir plus, consultez la section sur la configuration des plug-ins route et traffic de Cloud Load Balancing, ainsi que des plug-ins Media CDN.

  2. Exécutez la commande gcloud service-extensions wasm-plugins delete :

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

    Remplacez les éléments suivants :

    • WASM_PLUGIN : nom du plug-in.
    • LOCATION : emplacement du plug-in (global ou une région)

La suppression d'un plug-in entraîne également la suppression des ressources associées.

Supprimer une version d'un plug-in

Pour supprimer une version d'un plug-in, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plugins.

  3. Sélectionnez le plug-in que vous souhaitez modifier et passez en mode Édition.

  4. Dans la section Versions, cochez les cases correspondant aux versions que vous souhaitez supprimer, puis cliquez sur Supprimer.

  5. Cliquez sur Mettre à jour le plug-in.

gcloud

Exécutez la commande gcloud service-extensions wasm-plugin-versions delete suivante :

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

Remplacez les éléments suivants :

  • WASM_PLUGIN_VERSION : nom d'une version de plug-in qui n'est pas utilisée comme version principale.
  • LOCATION : emplacement du plug-in (global ou une région)

Si une version est définie comme version principale (active), vous ne pouvez la supprimer qu'après avoir défini une autre version comme version principale.

Étapes suivantes