Políticas globales de extensión de VM

En este documento, se proporciona una descripción general de las políticas de extensión de VM globales en el Gestor de extensiones de VM. Las políticas de extensiones globales te permiten implementar y administrar extensiones en todas las zonas y regiones de un proyecto, una carpeta o una organización para mantener configuraciones de flota coherentes sin administrar políticas por zona.

Para obtener más información sobre los niveles de jerarquía de las políticas de extensión, consulta Permisos de la jerarquía de recursos.

En el siguiente diagrama, se ilustra cómo las políticas de extensión globales aplican extensiones a las VMs en todas las zonas y regiones a nivel de organización, carpeta y proyecto:

Como se muestra en el diagrama anterior, puedes definir políticas de extensión globales a nivel de la organización, la carpeta o el proyecto. El Gestor de extensiones de VM aplica cada política a las VMs que coinciden en todas las zonas dentro de ese alcance de jerarquía.

Planes de lanzamiento para las políticas globales

Las políticas globales usan planes de lanzamiento para implementar extensiones en zonas y regiones. Un plan de lanzamiento te permite definir el orden y el momento de las actualizaciones para garantizar un lanzamiento gradual y controlado, y minimizar el riesgo de problemas generalizados.

Cuando creas o actualizas una política global, puedes especificar uno de los siguientes planes de lanzamiento:

• Lanzamiento lento. Implementa extensiones de forma gradual en las zonas durante un período predeterminado de cinco días. Usa este plan de lanzamiento para identificar y resolver problemas en las primeras olas de implementación antes de que afecten a toda tu flota.
• Lanzamiento rápido. Implementa extensiones en todas las VMs de destino en todas las zonas y regiones de inmediato. Usa este plan de lanzamiento cuando necesites implementar con rapidez una extensión o un parche en entornos que no sean de producción.

También puedes definir planes de lanzamiento personalizados para especificar las olas de implementación por zona o región, y el tiempo de espera entre olas. Para obtener más información, consulta el método rolloutPlans.insert.

Comportamiento de conflicto de lanzamiento

Cuando creas o actualizas una política de extensión global, puede producirse un conflicto con una política zonal existente en las siguientes situaciones:

• Cuando creas una política global. Si ya existe una política zonal con el mismo nombre en una zona, se produce un conflicto de nombres.
• Cuando actualizas una política global. Si modificas una política zonal existente de forma independiente, por ejemplo, con una llamada a la API zonal, y un lanzamiento posterior de la política global intenta actualizar esa política zonal, se produce un conflicto de contenido.

Para resolver los conflictos de lanzamiento, puedes especificar un comportamiento de conflicto para el lanzamiento. Este parámetro de configuración determina si la política global reemplaza las políticas zonales en conflicto durante un lanzamiento. Puedes especificar uno de los siguientes comportamientos:

• No reemplazar (predeterminado). Si no especificas un comportamiento de conflicto, el lanzamiento de la política global no reemplaza las políticas zonales en conflicto. La configuración de la política zonal tiene prioridad en esa zona.
• Reemplazar. Si estableces el comportamiento de conflicto en overwrite, la política global reemplaza las políticas zonales en conflicto y el Gestor de extensiones de VM aplica la configuración de la política global en esa zona.

Los conflictos de lanzamiento y la prioridad de las políticas son funciones distintas que operan de forma independiente. Para obtener más información sobre la prioridad de las políticas, consulta Prioridad de las políticas y resolución de conflictos.

Para obtener más información sobre la configuración de conflictos de lanzamiento, consulta el parámetro conflictBehavior en el método globalVmExtensionPolicies.insert.

Vuelve a intentar un lanzamiento

Cuando actualizas o borras una política de extensión global, el Gestor de extensiones de VM inicia un nuevo lanzamiento para aplicar los cambios según el plan de lanzamiento. Si un lanzamiento falla o hay nuevas zonas disponibles, puedes reintentar la operación iniciando un nuevo lanzamiento para la misma política.

Cuando vuelvas a intentar una actualización o borres un lanzamiento, debes proporcionar un identificador único universal (UUID) en formato hexadecimal de 32 caracteres (por ejemplo, a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8) para identificar la solicitud de reintento. Puedes usar cualquier generador de UUID estándar para crear este valor.

Vuelve a intentar el lanzamiento de una política de actualización

En la siguiente lista, se describen las situaciones en las que es posible que debas volver a intentar el lanzamiento de una política de actualización:

• Se agregaron zonas nuevas. Si hay nuevas zonas de Google Cloud disponibles después de que implementas una política global, el Gestor de extensiones de VM no aplica automáticamente las políticas existentes a las VMs de las zonas nuevas. Puedes volver a intentar la implementación de la actualización para aplicar la política de extensiones a las VMs de esas zonas.
• Revierte los cambios en la política zonal. Si modificas una política zonal de forma independiente, por ejemplo, con una llamada a la API zonal, puedes volver a intentar un lanzamiento de actualización con conflictBehavior configurado como overwrite. Este parámetro de configuración vuelve a aplicar la configuración de la política global y reemplaza los cambios de la política zonal.
• Lanzamiento interrumpido. Si un lanzamiento anterior falla antes de completarse, puedes iniciar uno nuevo para volver a intentar la actualización.
• Acelera un lanzamiento. Si un lanzamiento en curso progresa con demasiada lentitud, puedes iniciar uno nuevo con un plan FAST_ROLLOUT o un plan de lanzamiento personalizado para acelerar el proceso de actualización.

Para obtener más información, consulta el parámetro retryUuid en el método globalVmExtensionPolicies.update.

Vuelve a intentar el lanzamiento de una política de eliminación

En la siguiente lista, se describen las situaciones en las que es posible que debas volver a intentar implementar una política de eliminación:

• Lanzamiento interrumpido. Si un lanzamiento de eliminación anterior falla antes de completarse, puedes iniciar un lanzamiento nuevo para volver a intentar la eliminación.
• Acelera un lanzamiento. Si un lanzamiento de eliminación en curso avanza con demasiada lentitud, puedes iniciar un lanzamiento nuevo con un plan FAST_ROLLOUT o un plan de lanzamiento personalizado para acelerar el proceso de eliminación.

Para obtener más información, consulta el parámetro retryUuid en el método globalVmExtensionPolicies.delete.

¿Qué sigue?

• Para implementar agentes compatibles en tu flota a nivel de organización, carpeta o proyecto, consulta Instala extensiones de VM creando políticas de extensión.
• Para modificar los parámetros de configuración, cambiar las versiones fijadas o quitar los agentes implementados, consulta Administra extensiones de VM con políticas de extensiones.
• Para inspeccionar el progreso del lanzamiento y el estado de la extensión, consulta Visualiza los detalles y el estado de la extensión de VM.
• Para compilar paneles de Cloud Monitoring y configurar alertas para el estado del agente, la CPU y el uso de memoria, consulta Supervisa las extensiones de VM.