Administra complementos

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

La función de complementos está en vista previa para Media CDN.

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

Cómo ver los complementos

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

Enumera complementos

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

Console

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

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

    Aparecerá una lista de los complementos en una tabla que se puede ordenar con la siguiente información:

    • Estado: Es el estado del complemento. Si no hay un servicio adjunto, el valor es Not attached. Si un servicio está conectado con un complemento, el valor es Attached.
    • Nombre: Es el nombre del complemento.
    • Versión principal: Es la versión activa del complemento.
    • Producto: Es el Google Cloud producto al que se adjunta el complemento.
    • Tipo: Es el tipo de extensión.
    • Scope: Es el alcance del complemento.
    • Región: Es la región cuando el alcance del complemento es Regional.
    • En uso por: Una o más extensiones con las que se asocia el complemento.
    • Última modificación: Es la fecha y hora en la que se modificó el complemento por última vez.
    • Etiquetas: Son las etiquetas que se agregaron al complemento.

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

    1. Haz clic 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 Tabla de filtros.

    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 de propiedad y 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 comando gcloud service-extensions wasm-plugins list:

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

Reemplaza LOCATION por la ubicación del complemento, ya sea global o una región.

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

  • Name: El nombre del complemento
  • Descripción: Es la descripción del complemento.
  • Versión principal: Es la versión activa del complemento.
  • Hora de actualización: Es 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 consola de Google Cloud , ve a la página Extensiones de servicio.

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Haz clic en el nombre del complemento del que quieres 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 está adjunto, 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, las etiquetas y, si el registro está habilitado, la frecuencia de muestreo del registro y el nivel de registro mínimo.

    • Versiones: En esta sección, se muestran detalles sobre las versiones del complemento, como 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 comando gcloud service-extensions wasm-plugins describe:

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

Reemplaza lo siguiente:

  • WASM_PLUGIN: el nombre del complemento
  • LOCATION: Es la ubicación del complemento como global o una región.

Se muestran los siguientes detalles sobre el complemento:

  • Nombre del complemento
  • 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 comando gcloud service-extensions wasm-plugin-versions list:

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

Reemplaza lo siguiente:

  • WASM_PLUGIN: el nombre del complemento
  • LOCATION: Es 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 del complemento, usa el comando gcloud service-extensions wasm-plugin-versions describe:

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

Reemplaza lo siguiente:

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

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

  • Nombre de la versión
  • 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 del complemento o la imagen y los resúmenes relacionados

Cómo editar complementos

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

Cómo editar un complemento

Para editar un complemento, sigue estos pasos:

Console

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

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. En 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, no se puede editar el nombre del complemento. 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 Cómo agregar 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: Es 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

Agrega una nueva versión de un complemento

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

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

Console

  1. En la consola de Google Cloud , ve a la página Extensiones de 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 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:

  • WASM_PLUGIN: Es el ID o el nombre completo del complemento.
  • LOCATION: Es la ubicación del complemento como global o una región.
  • IMAGE: Es el URI del nuevo módulo de Wasm almacenado en el repositorio de Artifact Registry.
  • MAIN_VERSION: Es el ID de la versión del complemento que se creará y establecerá como la versión principal (o de entrega).
  • PLUGIN_CONFIG, PLUGIN_CONFIG_FILE o PLUGIN_CONFIG_URI: El archivo de configuración opcional, que se puede especificar intercalado como texto, como un archivo local o como una imagen en Artifact Registry, respectivamente.

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 consola de Google Cloud , ve a la página Extensiones de 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 establecerla 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: Es 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 borrar complementos y versiones de complementos creados con Service Extensions.

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. En 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 de la página Detalles.

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

  4. En el cuadro de mensaje de confirmación, haz clic en Borrar para confirmar la operación.

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 comando gcloud service-extensions wasm-plugins delete:

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

    Reemplaza lo siguiente:

    • WASM_PLUGIN: el nombre del complemento
    • LOCATION: Es la ubicación del complemento como global o una región.

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

Borra una versión de un complemento

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

Console

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

    Ir a Extensiones del servicio

  2. Haz clic en la pestaña Complementos.

  3. Selecciona el complemento que quieres 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: Es el nombre de una versión del complemento que no se usa como la versión principal.
  • LOCATION: Es 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), solo puedes borrarla después de establecer otra versión como la versión principal.

¿Qué sigue?