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é des plug-ins est disponible en version preview pour Media CDN.

Pour obtenir une présentation du produit, consultez la page 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.

Répertorier les plug-ins

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

Console

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

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plug-ins.

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

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

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

    1. Cliquez sur à côté de Filter table (Filtrer le tableau) pour afficher une liste de propriétés.

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

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

    3. Insérez un espace à côté des deux-points pour afficher une liste de 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 gcloud service-extensions wasm-plugins list commande :

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

Remplacez LOCATION par l'emplacement du plug-in, qui peut être global ou une région.

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

  • Name (Nom) : nom du plug-in
  • Description (Description) : description du plug-in
  • Main version (Version principale) : version active du plug-in
  • Update time (Heure de mise à jour) : date et 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 Google Cloud console, accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plug-ins.

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

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

    • Basic information (Informations de base) : cette section affiche des informations de base sur le plug-in, y compris le Google Cloud produit 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 horodatages 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, l'horodatage 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 gcloud service-extensions wasm-plugins describe commande :

 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, qui peut être global ou une région

Les détails suivants concernant le plug-in s'affichent :

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

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

 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, qui peut être global ou une région

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

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

 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, qui peut être global ou une région

Les détails suivants concernant la version du plug-in s'affichent :

  • Nom de la version
  • Horodatage de création
  • Description, si elle a été saisie
  • URI et condensés de l'image
  • Fichier de configuration ou image du plug-in et 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 Google Cloud console, accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plug-ins.

  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 Details (Détails), cliquer sur Edit (Modifier).

    Sur la page Edit plugin (Modifier le plug-in), le nom du plug-in n'est pas modifiable. Vous pouvez modifier d'autres détails.

  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 Update plugin (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, qui peut être 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, procédez comme suit :

Console

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

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plug-ins.

  3. Cliquez sur Edit (Modifier).

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

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

  6. Facultatif : Cochez la case Set as main (Définir comme version principale).

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

  7. Cliquez sur Add (Ajouter).

  8. Cliquez sur Update plugin (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 :

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 Google Cloud console, accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plug-ins.

  3. Cliquez sur le bouton Edit (Modifier).

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

    Vous pouvez également définir la version comme version principale lors de la création d’une version du plug-in,

  5. Cliquez sur Update plugin (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, qui peut être 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 dans 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 dans 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 Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plug-ins.

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

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

    Vous ne pouvez pas supprimer les plug-ins utilisés par une extension. Pour supprimer un plug-in de ce type, vous devez d'abord modifier l'extension pour supprimer le plug-in ou supprimer l'extension.

  4. Dans la boîte de message de confirmation, confirmez l'opération en cliquant sur Delete (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 Configurer les plug-ins de routage et de trafic Cloud Load Balancing et les plug-ins Media CDN.

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

    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, qui peut être global ou 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 Google Cloud console, accédez à la page Extensions de service.

    Accéder aux extensions de service

  2. Cliquez sur l'onglet Plug-ins.

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

  4. Dans la section Versions, cochez les cases des versions que vous souhaitez supprimer, puis cliquez sur Delete (Supprimer).

  5. Cliquez sur Update plugin (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, qui peut être global ou une région

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

Étape suivante