El componente ack-onepilot actualiza automáticamente los agentes de Application Real-Time Monitoring Service (ARMS) en clústeres de Kubernetes. Cuando necesite validar una nueva versión del agente antes de un despliegue amplio, o mantener una versión específica por estabilidad, fije el agente a una versión concreta en lugar de aceptar las actualizaciones automáticas.
Elija un método según la versión de ack-onepilot en su clúster:
|
Task |
Method |
ack-onepilot version |
|
Fijar una versión específica del agente (autoservicio) |
V3.0.17 o posterior |
|
|
Desplegar una versión primero en un subconjunto de instancias |
V3.3.0 o posterior |
|
|
Fijar una versión cuando el autoservicio no está disponible |
Anterior a V3.0.17 |
Especificar una versión del agente
Obligatorio: ack-onepilot V3.0.17 o posterior. Para comprobar la versión, vaya a la Container Service Management Console, haga clic en Add-ons, busque ack-onepilot y compruebe su versión. Si hay una actualización disponible, haga clic en Upgrade.
Este es el enfoque recomendado para controlar las versiones de los agentes. Hay tres métodos disponibles. Si utiliza tanto el Método 1 como el Método 2, o bien el Método 1 y el Método 3, la versión especificada por el Método 2 o el Método 3 tiene prioridad sobre el Método 1.
Paso 1: Encontrar la versión objetivo del agente
Inicie sesión en la consola de ARMS.
En el panel de navegación izquierdo, seleccione .
Anote el número de versión que va a utilizar. Seleccione la última versión estable, a menos que su entorno requiera una versión específica.
En la pestaña Agent Online Status, registre la versión actual del agente de cada aplicación. Esta versión servirá como objetivo de reversión si surgen problemas.
Paso 2: Aplicar la versión
Elija uno de los siguientes métodos.
Método 1: Etiqueta YAML
Añada la etiqueta aliyun.com/agent-version al archivo YAML de la aplicación:
metadata:
labels:
aliyun.com/agent-version: "<agent-version>"Reemplace <agent-version> con el número de versión obtenido en el Paso 1.
Después de guardar el archivo y hacer clic en Update, la aplicación se reinicia automáticamente para aplicar la versión especificada.
Esta etiqueta se aplica únicamente a la aplicación actual. Repita este paso para cada aplicación que requiera fijar la versión.
Método 2: Consola de EDAS
Al desplegar una aplicación en un clúster de Kubernetes mediante la consola de Enterprise Distributed Application Service (EDAS), especifique la versión del agente en la sección Monitoring and Governance Configurations dentro de la pestaña Advanced Settings.
Para ajustar las versiones de agente disponibles en EDAS, contacte al soporte técnico de EDAS.
Método 3: API de EDAS
Al crear o desplegar una aplicación mediante la API de EDAS, establezca el parámetro CustomAgentVersion en la operación InsertK8sApplication o DeployK8sApplication.
Paso 3: Verificar y desplegar
Aplique la versión primero a una aplicación de prueba.
Valide que la aplicación funciona correctamente con la nueva versión del agente.
Una vez completada la validación, repita el Paso 2 para las aplicaciones restantes.
Si la nueva versión del agente causa problemas, cambie la etiqueta o el parámetro a la versión anterior registrada en el Paso 1 para realizar la reversión.
Habilitar la actualización progresiva
Obligatorio: ack-onepilot V3.3.0 o posterior. La carga de trabajo de la aplicación debe tener tres o más réplicas.
La actualización progresiva le permite validar una nueva versión del agente en un pequeño subconjunto de instancias antes de que llegue a toda la carga de trabajo.
Añada ambas etiquetas al YAML de la aplicación:
metadata:
labels:
aliyun.com/agent-version: "<agent-version>"
aliyun.com/enable-progressive-update: "true"Cuando vuelve a desplegar una carga de trabajo de tipo Deployment o StatefulSet en un clúster de ACK con la actualización progresiva habilitada, solo una o dos instancias reciben la versión del agente especificada. Las instancias restantes conservan su versión actual.
Limitaciones
La actualización progresiva requiere como mínimo tres réplicas. Si la carga de trabajo tiene menos de tres réplicas, ninguna instancia se actualizará a la versión especificada, incluso si la etiqueta está configurada. En este caso, no habilite la actualización progresiva para dicha carga de trabajo.
La actualización progresiva solo se aplica a cargas de trabajo de tipo Deployment y StatefulSet.
Contactar al soporte técnico para fijar una versión
Utilice este método si ack-onepilot es anterior a V3.0.17 o si su entorno requiere modificaciones manuales de YAML. Este enfoque utiliza el bloqueo de versiones para migrar agentes desde versiones obsoletas o sin soporte a la más reciente.
Seleccione una aplicación de prueba. Contacte a ARMS technical support para bloquear el agente en la versión objetivo.
Reinicie la aplicación de prueba y valide la nueva versión del agente.
Una vez completada la validación, contacte a ARMS technical support para actualizar la versión bloqueada en los clústeres restantes por lotes.
Reinicie las aplicaciones de cada lote para aplicar la actualización.
Mejores prácticas
Validar antes del despliegue amplio: Fije la nueva versión en una sola aplicación de prueba primero. Confirme el funcionamiento normal antes de actualizar las aplicaciones restantes.
Usar la actualización progresiva para cargas de trabajo en producción: En cargas de trabajo con tres o más réplicas, habilite la actualización progresiva para limitar el radio de impacto durante los cambios de versión.
Registrar las versiones actuales antes de realizar cambios: Antes de fijar una nueva versión, anote la versión actual del agente en la pestaña Agent Online Status para poder revertir rápidamente.
Mantener ack-onepilot actualizado: Actualice ack-onepilot a V3.0.17 o posterior para acceder al fijado de versiones por autoservicio, o a V3.3.0 o posterior para la actualización progresiva, sin depender del soporte técnico.