Administra complementos

En esta página, se describe cómo puedes ver, editar y borrar complementos creados con Extensiones del servicio.

La función de complementos está en versión preliminar para Media CDN.

Para obtener una descripción general del producto, consulta la Descripción general de las Extensiones del servicio.

Cómo ver complementos

En esta sección, se describe cómo puedes ver los complementos y las versiones de complementos creados con Extensiones del servicio.

Cómo enumerar complementos

Para enumerar los complementos de tu proyecto, sigue estos pasos:

Console

  1. En la Google Cloud consola, ve a la página Extensiones del servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

    Aparecerá una lista de los complementos en una tabla ordenable con la siguiente información:

    • Estado: El estado del complemento. Si no se adjunta un servicio, el valor es Not attached. Si se adjunta un servicio con un complemento, el valor es Attached.
    • Nombre: El nombre del complemento.
    • Versión principal: La versión activa del complemento.
    • Producto: El Google Cloud producto al que se adjunta el complemento.
    • Tipo: El tipo de extensión.
    • Alcance: El alcance del complemento.
    • Región: La región cuando el alcance del complemento es Regional.
    • En uso por: Una o más extensiones a las que está asociado el complemento.
    • Última modificación: La hora en la que se modificó el complemento por última vez.
    • Etiquetas: Las etiquetas agregadas al complemento.

  3. Opcional: Para filtrar la lista, haz lo siguiente:

    1. Haz clic en junto a Filtrar tabla para ver una lista de propiedades.

    2. En la lista, selecciona una propiedad.

      El nombre de la propiedad, seguido de dos puntos, aparece junto a la etiqueta Filtrar tabla.

    3. Inserta un espacio junto a los dos puntos para ver una lista de valores que coincidan con la propiedad y, luego, selecciona un valor de la lista.

    4. Opcional: Ingresa el operador OR entre los pares clave-valor para especificar filtros combinados.

  4. Opcional: Para realizar otras operaciones con un complemento seleccionado, haz clic en Más acciones y, luego, selecciona una opción:

gcloud

Ejecuta el gcloud service-extensions wasm-plugins list comando:

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

Reemplaza LOCATION por la ubicación del complemento como global o una región.

Los complementos de tu proyecto se enumeran en una tabla que contiene la siguiente información:

  • Nombre: El nombre del complemento
  • Descripción: La descripción del complemento
  • Versión principal: La versión activa del complemento
  • Hora de actualización: La hora en la que se modificó el complemento por última vez

Cómo ver los detalles de un complemento

Para ver los detalles de un complemento, usa uno de los siguientes métodos:

Console

  1. En la Google Cloud consola de, ve a la página Extensiones del servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Haz clic en el nombre del complemento del que deseas ver los detalles.

    Se abrirá la página Detalles del complemento. La página tiene las siguientes secciones:

    • Información básica: En esta sección, se muestran detalles básicos sobre el complemento, incluido el Google Cloud producto al que se adjunta el complemento, el tipo de balanceador de cargas, el tipo de extensión, las extensiones que usan el complemento, el alcance del complemento, las marcas de tiempo de creación y modificación del complemento, el tamaño del complemento, etiquetas y, si el registro está habilitado, la tasa de muestreo del registro y el nivel mínimo de registro.

    • Versiones: En esta sección, se muestran detalles sobre las versiones del complemento, incluida la versión del complemento, la marca de tiempo de creación, cualquier descripción que se haya especificado, el URI y los resúmenes de la imagen, y el archivo de configuración o la imagen del complemento y los resúmenes relacionados.

      Puedes hacer clic en la URL de la imagen para ver sus detalles.

gcloud

Para ver los detalles de un complemento, ejecuta el gcloud service-extensions wasm-plugins describe comando:

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

Reemplaza lo siguiente:

  • WASM_PLUGIN: El nombre del complemento
  • LOCATION: La ubicación del complemento como global o una región

Se muestran los siguientes detalles sobre el complemento:

  • El nombre del complemento
  • Las marcas de tiempo de creación y modificación del complemento
  • Las etiquetas
  • La tasa de muestreo del registro (si el registro está habilitado)

Para enumerar las versiones de un complemento, usa el gcloud service-extensions wasm-plugin-versions list comando:

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

Reemplaza lo siguiente:

  • WASM_PLUGIN: El nombre del complemento
  • LOCATION: La ubicación del complemento como global o una región

Las versiones del complemento especificado se enumeran en una tabla con el nombre del complemento.

Para ver los detalles de una versión de complemento, usa el gcloud service-extensions wasm-plugin-versions describe comando:

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

Reemplaza lo siguiente:

  • WASM_PLUGIN_VERSION: La versión principal del complemento
  • LOCATION: La ubicación del complemento como global o una región

Se muestran los siguientes detalles sobre la versión del complemento:

  • El nombre de la versión
  • La marca de tiempo de creación
  • Una descripción, si se ingresó
  • El URI y los resúmenes de la imagen
  • El archivo de configuración o la imagen del complemento y los resúmenes relacionados

Cómo editar complementos

En esta sección, se describe cómo puedes editar complementos creados con Service Extensions.

Cómo editar un complemento

Para editar un complemento, sigue estos pasos:

Console

  1. En la Google Cloud consola, ve a la página Extensiones del servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Para el complemento que deseas editar, haz clic en Más acciones y, luego, selecciona Editar.

    Como alternativa, haz clic en el nombre del complemento y, luego, en la página Detalles, haz clic en Editar.

    En la página Editar complemento, el nombre del complemento no se puede editar. Puedes editar otros detalles.

  4. Realiza los cambios necesarios.

    Para obtener información sobre la mayoría de los campos, consulta Crea un complemento.

    Para obtener información sobre la sección Versiones, consulta Agrega una versión nueva de un complemento.

  5. Haz clic en Actualizar complemento.

gcloud

Ejecuta el comando gcloud service-extensions wasm-plugins update:

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

Reemplaza lo siguiente:

  • WASM_PLUGIN: El nombre del complemento
  • LOCATION: La ubicación del complemento como global o una región
  • PLUGIN_DESCRIPTION: La descripción del complemento
  • LABELS: Etiquetas en forma de pares clave-valor separados por comas

Cómo agregar una versión nueva de un complemento

Puedes crear una versión nueva del código del complemento y, luego, agregarla como una versión nueva del complemento.

Para agregar una versión nueva de un complemento, sigue estos pasos:

Console

  1. En la Google Cloud consola, ve a la página Extensiones del servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Haz clic en Editar.

  4. En la sección Versiones, haz clic en Agregar versión.

  5. En el panel Agregar versión, especifica los detalles de la versión del complemento.

  6. Opcional: Selecciona la casilla de verificación Establecer como principal.

    También puedes establecer esta versión como la versión principal más adelante.

  7. Haz clic en Agregar.

  8. Haz clic en Actualizar complemento.

gcloud

Ejecuta el comando 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

Reemplaza lo siguiente:

Cómo cambiar la versión principal de un complemento

Para cambiar la versión principal de un complemento, sigue estos pasos:

Console

  1. En la Google Cloud consola de, ve a la página Extensiones del servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Haz clic en el botón Editar.

  4. En la sección Versiones , selecciona una versión inactiva y, luego, haz clic en Establecer como principal.

    Como alternativa, mientras creas una versión nueva del complemento, puedes optar por establecer la versión como la versión principal.

  5. Haz clic en Actualizar complemento.

gcloud

Ejecuta el comando gcloud service-extensions wasm-plugins update:

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

Reemplaza lo siguiente:

  • LOCATION: La ubicación del complemento como global o una región
  • WASM_PLUGIN_VERSION: El nombre de la versión principal del complemento

Es posible que la nueva versión del complemento tarde unos minutos en distribuirse en todas las ubicaciones. La cantidad de minutos puede variar según la ubicación, ya que el complemento no se entrega a todas las ubicaciones de forma simultánea.

Cómo borrar complementos

En esta sección, se describe cómo puedes borrar complementos y versiones de complementos creados con Extensiones del servicio.

Cómo borrar un complemento

Para borrar un complemento, sigue estos pasos:

Console

  1. Ve a la página Extensiones del servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Para el complemento que deseas borrar, haz clic en el botón Más acciones y, luego, selecciona Borrar.

    Como alternativa, haz clic en el nombre del complemento y, luego, en el botón Borrar en la página Detalles.

    No se pueden borrar los complementos que usa una extensión. Para borrar un complemento de este tipo, primero modifica la extensión para quitar el complemento o borrar la extensión.

  4. En el cuadro de mensaje de confirmación, confirma la operación haciendo clic en Borrar.

gcloud

  1. Quita las referencias al complemento de la configuración del servicio y, luego, vuelve a importar el archivo YAML de configuración.

    Para obtener más información, consulta cómo configurar los complementos de ruta y tráfico de Cloud Load Balancing y los complementos de Media CDN.

  2. Ejecuta el gcloud service-extensions wasm-plugins delete comando:

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

    Reemplaza lo siguiente:

    • WASM_PLUGIN: El nombre del complemento
    • LOCATION: La ubicación del complemento como global o una región

Si borras un complemento, también se borrarán los recursos relacionados con el complemento.

Cómo borrar una versión de un complemento

Para borrar una versión de un complemento, sigue estos pasos:

Console

  1. En la Google Cloud consola de, ve a la página Extensiones del servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Selecciona el complemento que deseas editar y cambia al modo de edición.

  4. En la sección Versiones , selecciona las casillas de verificación de las versiones que deseas borrar y, luego, haz clic en Borrar.

  5. Haz clic en Actualizar complemento.

gcloud

Ejecuta el comando gcloud service-extensions wasm-plugin-versions delete:

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

Reemplaza lo siguiente:

  • WASM_PLUGIN_VERSION: El nombre de una versión del complemento que no se usa como la versión principal
  • LOCATION: La ubicación del complemento como global o una región

Si una versión se establece como la versión principal, que es la versión principal (activa) versión, solo puedes borrarla después de establecer otra versión como la versión principal.

¿Qué sigue?