Limitaciones generales

Revisa las restricciones generales que se aplican a todas las configuraciones de implantación progresiva. Estas restricciones garantizan un funcionamiento correcto y evitan conflictos con otras funciones.

• Se requiere el nivel Enterprise: El despliegue progresivo solo está disponible para los usuarios del nivel Enterprise.
• Una tirada por bandera: Sólo se permite un despliegue progresivo por bandera de característica. Puede configurarlo a nivel de bandera o a nivel de regla, pero no ambos a la vez.
• Una estrategia de entrega activa cada vez: Si un experimento se está ejecutando en una bandera, no se puede crear un despliegue progresivo. Del mismo modo, si se está ejecutando un despliegue progresivo, no se puede iniciar un experimento en esa bandera.
• Porcentaje: El porcentaje de despliegue debe estar comprendido entre el 1% y el 100%.

Requisitos API por ámbito de aplicación

La API que utilices dependerá del alcance de tu configuración de implementación progresiva. Selecciona la API adecuada en función del lugar en el que estés configurando la implementación.

• Despliegue progresivo a nivel de banderas: utilice la API de banderas de características para crear y actualizar el despliegue.
• Despliegue progresivo a nivel de reglas: utilice la API de reglas para crear y actualizar el despliegue.
• Detención de un rollout: utilice las API de detención de rollouts para detener un rollout progresivo activo.

Requisitos de configuración por ámbito

Antes de configurar un despliegue progresivo, asegúrate de que tu indicador o regla utilice valores de despliegue explícitos en lugar de valores heredados. Este requisito evita conflictos y garantiza que la implantación progresiva tenga un control total.

• Para el despliegue progresivo a nivel de bandera: Ninguna de las reglas de orientación puede tener un valor rolloutPercentage heredado de la bandera. Todas las reglas de focalización deben utilizar valores de rollout anulados.
• Para el despliegue progresivo a nivel de regla: la regla de destino en la que se añade el despliegue no puede utilizar un valor heredado de la bandera. La regla debe tener su propio valor explícito.

Operaciones bloqueadas durante el despliegue progresivo

Cuando una implementación progresiva se encuentra en estado de ejecución, se bloquean determinadas operaciones para mantener la integridad de la implementación y evitar conflictos.

• Crear otro rollout progresivo: Sólo se permite una tirada progresiva por bandera.
• Iniciar un experimento: Los experimentos no pueden ejecutarse en banderas que ya tengan un despliegue progresivo en marcha.
• Borrar una colección: La eliminación de colecciones se bloquea si alguna bandera de característica asociada tiene un despliegue progresivo en estado de ejecución.
• Actualización o eliminación de un segmento: Las actualizaciones y eliminaciones de segmentos se bloquean si cualquier indicador de función asociado tiene un despliegue progresivo en estado de ejecución.
• Modificación de la configuración del indicador o de la regla: Las actualizaciones de la bandera o de la regla de focalización que utiliza el rollout sólo se permiten cuando el rollout progresivo no se está ejecutando.

Comportamiento del ciclo de vida

Comprender el comportamiento del ciclo de vida te ayuda a gestionar la interacción entre los lanzamientos progresivos y otras funciones. App Configuration mantiene una separación estricta entre las estrategias de implementación.

• Si se está ejecutando un experimento, no se puede crear un despliegue progresivo.
• Si se está ejecutando un despliegue progresivo, no se puede iniciar un experimento en la misma bandera.
• Para detener un rollout, debe utilizar las APIs dedicadas a detener rollouts.

Configuración del despliegue progresivo a nivel de bandera

Para configurar el despliegue progresivo a nivel de bandera:

1. En la consola App Configuration, vaya a Feature flags.
2. Seleccione el entorno que contiene su bandera de características.
3. Haga clic en el indicador de función que desee configurar.
4. En la sección Despliegue de funciones, seleccione Progresivo como tipo de despliegue.
5. Configure los ajustes de despliegue:
   • Duración predefinida: Elija entre las plantillas predefinidas ( 1hr, 12hr, 24hr, 48hr ) o seleccione Personalizado
   • Fases: Definir cada fase con un porcentaje y una duración
   • Programar más tarde (opcional): Active esta opción para especificar una hora de inicio en UTC para el despliegue. Si no se activa, el despliegue comienza inmediatamente.
6. Pulse Guardar.

El despliegue progresivo se iniciará automáticamente a la hora de inicio configurada.

Configuración del despliegue progresivo a nivel de reglas

Para configurar el despliegue progresivo a nivel de reglas de destino:

1. En la consola App Configuration, vaya a Feature flags.
2. Seleccione el entorno que contiene su bandera de características.
3. Haga clic en el indicador de función que desee configurar.
4. En la sección «Segmentación», selecciona la regla que quieras configurar.
5. Asegúrese de que la regla tiene un valor anulado.
6. En la sección Despliegue de la regla, seleccione Progresivo como tipo de despliegue.
7. Configure los ajustes de despliegue:
   • Duración predefinida: Elija entre las plantillas predefinidas ( 1hr, 12hr, 24hr, 48hr ) o seleccione Personalizado
   • Fases: Definir cada fase con un porcentaje y una duración
   • Programar más tarde (opcional): Active esta opción para especificar una hora de inicio en UTC para el despliegue. Si no se activa, el despliegue comienza inmediatamente.
8. Pulse Guardar.

Configuración de fases

Define el porcentaje y la duración de cada fase de tu implantación progresiva. Cada fase consta de dos componentes clave que controlan el avance de la implantación.

Cada fase incluye:

• Porcentaje: El porcentaje de usuarios que recibirán el valor activado (1-100%)
• Duración: Cuánto debe durar esta fase (por ejemplo, " 8h ", " 30m ", " 2d ")

La fase final no requiere duración, ya que representa el estado de finalización.

Ejemplos de fases

Revisa estos ejemplos de configuraciones de fases de implantación progresiva para distintos escenarios.

Ejemplo 1: implantación gradual de 24 horas

{
  "phases": [
    { "percentage": 5, "duration": "6h" },
    { "percentage": 25, "duration": "6h" },
    { "percentage": 50, "duration": "6h" },
    { "percentage": 100, "duration": "6h" }
  ]
}

Ejemplo 2: Puesta en marcha rápida en 1 hora

{
  "phases": [
    { "percentage": 10, "duration": "15m" },
    { "percentage": 50, "duration": "15m" },
    { "percentage": 100, "duration": "30m" }
  ]
}

Ejemplo 3: Un despliegue conservador de 48 horas

{
  "phases": [
    { "percentage": 5, "duration": "12h" },
    { "percentage": 10, "duration": "12h" },
    { "percentage": 25, "duration": "12h" },
    { "percentage": 100, "duration": "12h" }
  ]
}

Dentro de un despliegue

Durante un único proceso de implementación progresiva, « App Configuration » mantiene las asignaciones de cada usuario para garantizar una experiencia estable a lo largo de todas las fases.

• La aleatorización es determinista, según entity_id.
• El mismo entity_id siempre recibe la misma asignación.
• Los usuarios que reciban el valor «habilitado» en la fase 1 seguirán recibiéndolo en las fases posteriores.
• A medida que aumenta el porcentaje, se añaden nuevos usuarios.

En todas las implantaciones

Cuando se inicia una nueva implementación progresiva en el mismo indicador, App Configuration genera una nueva distribución para permitir diferentes patrones de exposición de los usuarios.

• Se genera una nueva distribución aleatoria.
• El mismo « entity_id » puede recibir una misión diferente.
• Esto permite que los distintos grupos de usuarios se incorporen en diferentes ciclos de implementación.