Despliegues progresivos

paquete estable bundle estable en lugar de entregar una versión separada objetivo de lanzamiento hacia un conjunto controlado de dispositivos. Es útil cuando deseas una validación de producción real sin cambiar todo el canal de una vez.

Configura el objetivo de lanzamiento, porcentaje, duración de caché y política de pausa automática desde la pestaña de información del canal.

Cómo funcionan los lanzamientos progresivos

Cada canal puede tener dos enlaces de paquetes:

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

A una implementación le necesita un paquete estable. En la consola, asigna el paquete estable antes de elegir el objetivo; con el API público, un canal existente puede suministrar version y rolloutVersion en la misma solicitud POST. Capgo toma una decisión aleatoria para cada dispositivo elegible, luego la almacena utilizando una hash del ID del dispositivo y el ID de la implementación. Eso hace que el grupo cohesivo sea pegajoso durante la configuración de duración de caché en lugar de cambiar en cada verificación de actualización.

No pegajoso significa no permanente

La duración de caché de decisión de implementación por defecto es 30 días. Después de que expira, un dispositivo puede ser seleccionado nuevamente. Cambiar el objetivo de la implementación crea un nuevo ID de implementación y comienza un nuevo grupo cohesivo. Puedes configurar la duración de caché desde 60 segundos hasta 365 días.

Cambios porcentuales

Capgo preserva las decisiones existentes cuando puede:

• Aumentar un porcentaje — dispositivos ya seleccionados siguen seleccionados; solo un subconjunto aleatorio de dispositivos previamente no seleccionados se agrega.
• Disminuir un porcentaje — un conjunto 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, lo reviertan o cambien el objetivo.
• Pausar — detiene a los 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 actualizaciones utilizan la versión estable.

Ejecutar un lanzamiento

1. Subir y asignar una versión probada como la versión estable del canal.
2. Subir la versión candidata sin reemplazar la versión estable.
3. Abrir el canal’s Información pantalla, establecer al candidato como el Objetivo, elegir un pequeño porcentaje, y habilitar el lanzamiento.
4. Monitorear el lanzamiento en Observar, Insights de registro, y la historia del canal. Aumentar el porcentaje solo después de que la cohorte esté sana.
5. Cuando esté listo, promover el objetivo a establecido. Si no está sano, pausarlo o volverlo a poner.

CLI ejemplo

Iniciar un lanzamiento para el 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 configurar la carga como un objetivo de lanzamiento en un paso cuando el canal ya tiene un paquete estable:

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

Consulte la documentación completa del canal CLI y paquete CLI de referencia para cada opción de lanzamiento.

Pausar, retroceder o promover

Acción	¿Qué hace?
Pausar	Detiene a nuevos dispositivos de entrar en el lanzamiento. Los dispositivos ya en el objetivo habilitado permanecen allí.
Reanudar	Permite a nuevos dispositivos elegibles entrar de nuevo.
Deshabilitar	Detiene la resolución del objetivo de lanzamiento y utiliza el paquete estable.
Rehacer	Elimina el objetivo, deshabilita la implementación, resetea el porcentaje a 0% y devuelve los dispositivos a estable.
Promover	Hace que el objetivo de la implementación apunte al paquete estable, luego elimina el estado de implementación.

Utiliza una acción de terminal a la vez:

# 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

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

Política de pausa automática

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

La pausa automática está deshabilitada por defecto. Configura estos campos en el canal’s Información pulsa o con channel set:

• Tasa de fallos de umbral en base puntos (500 = 5%). Se requiere un umbral para que se active la política.
• Ventana en minutos (por defecto: 60).
• Confianza entre 0 y 1 (por defecto: 0.95).
• Número mínimo de intentos y fallos obligatorios, para evitar actuar sobre muestras diminutas.
• Tiempo de espera en minutos (por defecto: 60), que previene acciones repetidas.
• Acción: pause, rollback, o notify.

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

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

Puedes gestionar la misma característica a través de Canales Públicos API o la consola:

1. Abra una aplicación, luego Canales.
2. Seleccione el canal.
3. Abra Información.
4. Use el Despliegue progresivo sección para elegir el objetivo, porcentaje, duración de caché y política de pausa automática.

Para la configuración de canalización general y precedencia de dispositivo, consulte Canales. Para la recuperación de paquetes de emergencia fuera de un lanzamiento progresivo, consulte Revertir una actualización en vivo.