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 versión preliminar 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 los 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 Plugins.

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

   • Estado: Es el estado del complemento. Si no se adjunta un servicio, el valor es Not attached. Si un servicio se adjunta 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 producto de Google Cloud al que se adjunta el complemento.
   • Tipo: Es el tipo de extensión.
   • Alcance: 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 está asociado el complemento.
   • Última modificación: Es la hora en la que se modificó el complemento por última vez.
   • Etiquetas: Son las etiquetas que se agregan 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 Filtrar tabla.

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

   4. Opcional: Ingresa el operador OR entre los pares propiedad-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:

   • Para editar el complemento, haz clic en Editar.
   • Para borrar el complemento, haz clic en Borrar.
   • Para abrir el Explorador de registros, que puedes usar para recuperar, ver y analizar datos de registro sobre el complemento, haz clic en Ver en el Explorador de registros.
   • Para abrir la página Supervisión de extensiones de servicio, haz clic en Ver supervisió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 tiene la siguiente información:

• Nombre: Es el nombre del complemento.
• Description: 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.

Consulta 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 producto de Google Cloud 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, las etiquetas y, si el registro está habilitado, la tasa de muestreo de registros 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 comando gcloud service-extensions wasm-plugins describe:

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

Reemplaza lo siguiente:

• WASM_PLUGIN: Es el nombre del complemento.
• LOCATION: Es la ubicación del complemento, ya sea 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 de registros (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: Es el nombre del complemento.
• LOCATION: Es la ubicación del complemento, ya sea 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 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, ya sea 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 los complementos creados con Service Extensions.

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 Plugins.

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 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: Es el nombre del complemento.
• LOCATION: Es la ubicación del complemento, ya sea global o una región.
• PLUGIN_DESCRIPTION: Es la descripción del complemento.
• LABELS: Son etiquetas en forma de pares clave-valor separados por comas.

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

   Ir a Extensiones del servicio

2. Haz clic en la pestaña Plugins.

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: el ID o el nombre completamente calificado del complemento
• LOCATION: Es la ubicación del complemento, ya sea 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 de forma intercalada como texto, como un archivo local o como una imagen en Artifact Registry, respectivamente.

Nota: Para crear una versión nueva del complemento sin establecerla como la versión principal, usa el comando gcloud service-extensions wasm-plugins create.

Cambia 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 Plugins.

3. Haz clic en el botón Editar.

4. En la sección Versiones, selecciona una versión que esté 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, ya sea global o una región.
• WASM_PLUGIN_VERSION: Es 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.

Nota: Para revertir un complemento, establece una versión anterior como la principal.

Borra complementos

En esta sección, se describe cómo borrar complementos y versiones de complementos creados con Service Extensions.

Borra 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 Plugins.

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 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, así como 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: Es el nombre del complemento.
   • LOCATION: Es la ubicación del complemento, ya sea global o una región.

Cuando borras un complemento, también se borran los recursos relacionados.

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 Plugins.

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, ya sea global o una región.

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

¿Qué sigue?

• Obtén más información para crear complementos.
• Consulta la descripción general de las extensiones de servicio.