Actualizaciones progresivas

Copia un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

A un lanzamiento progresivo se mantiene un paquete estable de un canal paquete estable en su lugar mientras se entrega un objetivo de lanzamiento separado objetivo de lanzamiento a un conjunto controlado de dispositivos. Es útil cuando deseas una validación de producción real sin cambiar todo el canal de una vez.

Controles de lanzamiento progresivo en un canal Capgo — Configure el objetivo de lanzamiento, porcentaje, duración de caché y política de pausa automática desde la pestaña de información de un canal.

Cómo funcionan los lanzamientos progresivos

Cada canal puede tener dos enlaces de paquete:

paquete estable — el paquete normal asignado al canal.
Objetivo de lanzamiento — el paquete candidato que se libera gradualmente.

Un lanzamiento necesita un paquete estable. En la consola, asigna el paquete estable antes de elegir el objetivo; con el Público API, un canal existente puede proporcionar version y rolloutVersion in the same POST request. Capgo makes a random decision for each eligible device, then caches it using a hash of the device ID and the rollout ID. That makes the cohort sticky for the configured cache duration instead of changing on every update check.

La duración de caché de decisión de lanzamiento predeterminada es de 30 días. Después de que expira, un dispositivo puede ser seleccionado nuevamente. Cambiar el objetivo de lanzamiento crea un nuevo ID de lanzamiento y comienza un nuevo conjunto de cohortes. Puede configurar la duración de caché desde 60 segundos hasta 365 días.

Capgo preserves existing decisions when it can:

__CAPGO_KEEP_0__ preserva las decisiones existentes cuando puede: — dispositivos ya seleccionados permanecen seleccionados; solo se agrega un subconjunto aleatorio de dispositivos previamente no seleccionados.
Disminuir un porcentaje — un subconjunto aleatorio de la cohorte seleccionada regresa a la versión estable.
Establecer el porcentaje en 0% — no se seleccionan nuevos dispositivos. Los dispositivos que ya están ejecutando el objetivo de lanzamiento habilitado continúan recibiendo ese objetivo hasta que lo deshabiliten, retrocedan o cambien el objetivo.
Pausar — detiene a nuevos dispositivos de entrar mientras que los dispositivos que ya están ejecutando el objetivo habilitado siguen con él.
Deshabilitar — detiene la resolución del objetivo de lanzamiento; las comprobaciones de actualizaciones utilizan la versión estable.

Ejecutar un lanzamiento

Cargar y asignar una versión probada como la versión estable del canal.
Subir el paquete candidato sin reemplazar el paquete estable.
Abra la pestaña de Información y establezca el candidato como el Objetivo, elija un pequeño porcentaje y habilite el lanzamiento.
Monitorear el lanzamiento en Observar, Insights de registro, y la historia del canal. Aumente el porcentaje solo después de que la cohorte esté sana.
Cuando esté listo, promueva el objetivo a estable. Si no está sano, paúse o róllalo hacia atrás.

CLI ejemplo

Iniciar un despliegue para paquete 1.3.0 en 5%:

npx @capgo/cli@latest channel set production com.example.app \
  --rollout-bundle 1.3.0 \
  --rollout-percentage 5 \
  --rollout-enable

Aumentarlo sin reseleccionar dispositivos ya seleccionados:

npx @capgo/cli@latest channel set production com.example.app \
  --rollout-percentage 25

El comando de carga de paquetes puede establecer su carga como objetivo de despliegue en un paso cuando el canal ya tenga un paquete estable:

npx @capgo/cli@latest bundle upload com.example.app \
  --path ./dist \
  --channel production \
  --rollout 5

Ver el completo canal CLI referencia y paquete CLI referencia para cada opción de lanzamiento.

Pausar, retroceder o promover

Acción	¿Qué hace
Pausar	Detiene a los nuevos dispositivos de entrar en el lanzamiento. Los dispositivos que ya están en el objetivo habilitado permanecen allí.
Reanudar	Permite que los nuevos dispositivos elegibles entren de nuevo.
Desactivar	Detiene la resolución del objetivo de lanzamiento y utiliza el paquete estable.
Revertir	Elimina el objetivo, desactiva el lanzamiento, resetea el porcentaje a 0% y devuelve los dispositivos a estable.
Promover	Contexto: Página/área: Sitio web de marketing de Capgo. Rol: Título de sección o página. Visto en: página affiliate.astro. Mensaje clave `affiliate_step2_title` (Título de paso 2 de afiliado).

Hace que el objetivo de lanzamiento sea el paquete estable, luego elimina el estado de lanzamiento.

# Stop adding devices while you investigate
npx @capgo/cli@latest channel set production com.example.app --rollout-pause

# Make the candidate stable for everyone
npx @capgo/cli@latest channel set production com.example.app --rollout-promote

# Discard the candidate and return to stable
npx @capgo/cli@latest channel set production com.example.app --rollout-rollback

Copiar a portapapeles

Mantén el paquete objetivo disponible hasta que lo promuevas o lo revertas. Los paquetes vinculados como un paquete estable o objetivo de lanzamiento están protegidos de eliminación.

Capgo puede evaluar una actualización habilitada cada cinco minutos y actuar cuando su señal de falla cruza su umbral. Mide las instalaciones y las fallas para el objetivo de actualización en el canal seleccionado y la ventana de tiempo, y luego utiliza una función de confianza de Wilson en lugar de la tasa de falla bruta sola.

El pausa automático está deshabilitado por defecto. Configura estos campos en la pestaña Información del canal o con channel set:

Umbral de tasa de fallas en puntos base (%). Un umbral es necesario para que la política active.500 Ventana
en minutos (por defecto: 60). Confianza
entre y 0 y 1 (por defecto:) 0.95).
Intentos y fallos mínimos opcionales, para evitar actuar sobre muestras pequeñas.
Tiempo de espera en minutos (por defecto: 60), que impide acciones repetidas.
Acción: pause, rollback, o notify.

pause detiene la exposición a nuevos lanzamientos, rollback limpia el objetivo y regresa a estable, y notify envía una alerta de lanzamiento sin cambiar la entrega de lanzamientos.

npx @capgo/cli@latest channel set production com.example.app \
  --auto-pause-enabled \
  --auto-pause-failure-rate-bps 500 \
  --auto-pause-window-minutes 60 \
  --auto-pause-confidence 0.95 \
  --auto-pause-min-attempts 100 \
  --auto-pause-min-failures 5 \
  --auto-pause-action pause \
  --auto-pause-cooldown-minutes 120

API y controles de panel de control

Puede gestionar la misma característica a través de Canales Públicos API o el panel:

Abra una aplicación, luego Canales.
contexto: nombre de característica de canales de Capgo. Página/área: página de marketing de soluciones de Capgo. Rol: etiqueta de IU corta o elemento de navegación. Visto en: página soluciones/white-label.astro. Clave de mensaje `solutions_white_label_visual_cell2_value` (Valor de celda visual de soluciones White Label).
Seleccione el canal. Abrir.
Información Utilice el Sección de lanzamiento progresivo para elegir el objetivo, el porcentaje, la duración de la caché y la política de pausa automática.

Para la configuración de canal de routing general y precedencia de dispositivo, consulte CanalesPara la recuperación de paquetes de emergencia fuera de un despliegue progresivo, consulte Revertir un actualización en vivo.