Gérer les plug-ins

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

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

Pour en savoir plus sur le produit, consultez la 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 de Service Extensions.

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 à Service Extensions

  2. Cliquez sur l'onglet Plugins.

    Une 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 signe deux-points, s'affiche à côté du libellé Filtrer le tableau.

    3. Insérez un espace à côté du signe 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 répertorié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 à Service Extensions

  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 étiquettes et, si la journalisation est activée, le taux d'échantillonnage des journaux et le niveau de journalisation minimal.

    • Versions : cette section affiche des détails 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 condensés de l'image, ainsi que le fichier de configuration ou l'image du plug-in et les condensé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, soit global, soit une région

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

  • Nom du plug-in
  • Les codes temporels de création et de modification du plug-in
  • Les étiquettes
  • Le 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, soit global, soit 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, soit global, soit une région

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

  • Le nom de la version
  • Code temporel de création
  • Une description, si elle a été saisie
  • URI et condensés de l'image
  • Le fichier de configuration ou l'image du plug-in et les condensés associés

Modifier des plug-ins

Cette section explique comment modifier des 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 à Service Extensions

  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 la page Détails, cliquer sur 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, soit global, soit une région
  • PLUGIN_DESCRIPTION : description du plug-in
  • LABELS : étiquettes sous forme de paires clé/valeur séparées par une virgule.

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 nouvelle 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 à Service Extensions

  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 pouvez é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, soit global, soit 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é respectivement de manière intégrée sous forme de texte, de fichier local ou d'image dans Artifact Registry.

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 à Service Extensions

  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 version principale.

    Vous pouvez également choisir de définir la version comme version principale lors de la création d'une nouvelle version du 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 \
     --location=LOCATION \
     --main-version=WASM_PLUGIN_VERSION

Remplacez les éléments suivants :

  • LOCATION : emplacement du plug-in, soit global, soit 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 d'un emplacement à l'autre, car le plug-in n'est pas distribué simultanément à tous les emplacements.

Supprimer des plug-ins

Cette section explique comment supprimer des plug-ins et des 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 Service Extensions.

    Accéder à Service Extensions

  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.

    Les plug-ins utilisés par une extension ne peuvent pas être supprimés. Pour supprimer un tel plug-in, commencez par modifier l'extension pour supprimer le plug-in ou supprimer l'extension.

  4. Dans la boîte de dialogue 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, découvrez comment configurer les plug-ins de route et de trafic Cloud Load Balancing, ainsi que les 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, soit global, soit une région

La suppression d'un plug-in entraîne également la suppression des ressources de plug-in 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 à Service Extensions

  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, soit global, soit 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