Saltar al contenido principal
Migrar una empresa de la configuración clásica de Environment a la configuración declarativa supone un cambio importante. La página de Rollout ofrece a los administradores de Enterprise un control granular sobre esta transición. Puedes habilitar blueprints para algunas orgs piloto, ampliar el rollout a tu propio ritmo y revertirlo al instante si algo sale mal.

​
Estados de despliegue de Enterprise

Enterprise tiene tres estados principales que controlan cómo están disponibles los blueprints para las organizaciones:
EstadoQué significaEfecto en las organizaciones
DisabledLos blueprints no están habilitados para EnterpriseNinguna organización ve las páginas de Environment. Todas las organizaciones usan la configuración clásica.
Default OffLos blueprints están disponibles, pero no son la opción predeterminadaEl Admin de Enterprise puede habilitarlos de forma individual para cada organización. Las organizaciones nuevas comienzan con la configuración clásica.
Default OnLos blueprints son la opción predeterminada para todas las organizacionesTodas las organizaciones usan blueprints, salvo que se cambien explícitamente a la configuración clásica. Las organizaciones nuevas comienzan con blueprints.
Las transiciones se producen en orden: Disabled → Default Off → Default On. También puedes volver atrás (Default On → Default Off) para ralentizar el despliegue.

​
Detalles de Desactivado de forma predeterminada

En el estado Desactivado de forma predeterminada, las organizaciones que no se hayan incorporado siguen usando la configuración clásica y no ven ningún cambio en su experiencia. El administrador de la empresa puede incorporar organizaciones individuales desde la página Rollout. Solo esas organizaciones pasan a la configuración declarativa. Hay una opción adicional: Mostrar aviso de migración a todas las organizaciones. Cuando está habilitada, los administradores de organizaciones que todavía usan la configuración clásica ven un aviso en su página de Configuración de la máquina que los anima a migrar a la configuración declarativa. Esto no cambia su configuración ni les da acceso a todas las páginas de configuración del entorno. Simplemente les informa de que los blueprints están disponibles y les ofrece una forma de incorporarse. Esto es útil para dar visibilidad antes de empezar a migrar organizaciones. Cuando esta opción está deshabilitada, las organizaciones que no se hayan incorporado explícitamente no ven nada nuevo. Su experiencia no cambia.

​
Anulaciones por organización

Los administradores de Enterprise pueden anular el estado de implementación para organizaciones individuales desde la página Rollout:
  • En Default Off: Incluye determinadas organizaciones en blueprints. Estas organizaciones pasan de la configuración clásica a la configuración declarativa de inmediato.
  • En Default On: Excluye determinadas organizaciones de blueprints para que vuelvan a la configuración clásica. Estas organizaciones continúan usando su configuración clásica.
Las anulaciones son persistentes. Se mantienen aunque cambie el estado de Enterprise. Si incluyes una organización en blueprints durante la fase Default Off, seguirá en blueprints cuando pases a Default On.

​
Anulaciones automáticas de classic

Al pasar de Predeterminado desactivado a Predeterminado activado, un mecanismo de seguridad evita interrupciones: cualquier organización que actualmente use la configuración classic y tenga repositorios configurados recibe automáticamente una anulación explícita de classic. Esto significa que la transición no cambia nada para las organizaciones que están usando activamente la configuración classic. Siguen igual hasta que las migres explícitamente. Las organizaciones sin repositorios (o las organizaciones que ya usan blueprints) no se ven afectadas por esta protección. La mejor manera de abordar esto es crear y validar tu configuración de forma aislada antes de ponerla a disposición de los administradores de la org. No hagas una migración de golpe. Empieza de forma controlada, verifica y luego amplía.

​
Fase 1: Compilar y verificar de forma aislada (Desactivado de forma predeterminada)

Empieza con la empresa en modo Desactivado de forma predeterminada. Las orgs no pueden activarlo por sí solas, así que tienes control total.
  1. Habilita los blueprints a nivel de empresa pasando de Desactivado a Desactivado de forma predeterminada.
  2. Crea una org de prueba dedicada para probar la configuración del entorno. Esta org existe únicamente para validar tus blueprints.
  3. Habilita la configuración declarativa solo para esta org de prueba (mediante una anulación específica por org en la página Rollout).
  4. Configura el blueprint de tu empresa: instala todos los entornos de ejecución compartidos, herramientas de seguridad, certificados corporativos, CLI internas, ajustes de proxy y autenticación en el registry. Esta es la capa base que heredará cada org.
  5. Configura un blueprint de org para la org de prueba con cualquier herramienta a nivel de org o configuración del registry.
  6. Agrega blueprints de repositorio para un conjunto representativo de repositorios. Elige repos que cubran tus stacks tecnológicos más comunes.
  7. Verifica de extremo a extremo: inicia sesiones de Devin en estos repos y confirma que todo funcione. Los repos deben clonarse, las dependencias deben instalarse, los comandos de lint/test/build deben ejecutarse correctamente y todas las herramientas deben estar en las versiones esperadas.
No te limites a comprobar que las compilaciones se completan correctamente. Una compilación exitosa no siempre significa que el entorno funcione. Pueden pasarse por alto una entrada faltante en PATH, una versión incorrecta de una herramienta o la falta de autenticación en el registry. Verifica siempre ejecutando una sesión real de Devin.

​
Fase 2: Habilitar la adopción opcional para los admins de la org

Una vez que hayas confirmado que tu pila de blueprints enterprise → org → repo se compone correctamente y genera entornos funcionales:
  1. Comunica internamente a los admins de la org que la configuración declarativa ya está disponible y lista para usarse.
  2. Habilita el aviso de migración: activa “Show migration nudge to all organizations” para que los admins de la org con la configuración clásica vean un aviso que los anime a migrar.
  3. Los admins de la org ya pueden migrar sus propias organizaciones. Como el blueprint enterprise ya proporciona la capa base (runtimes, herramientas, certificados y registries), los admins de la org solo tienen que configurar lo específico de su equipo y sus repos.
Cada admin de la org puede usar el asistente de migración para simplificar este proceso. Devin puede inspeccionar la instantánea actual de la org y generar automáticamente una configuración de blueprint equivalente. Consulta Migración a la configuración declarativa para ver el flujo paso a paso. Crea una biblioteca de blueprints de plantilla para tus stacks tecnológicos más comunes (Node.js, Python, Java, Go y monorepos multilenguaje) y compártelos internamente para que los admins de la org no tengan que empezar desde cero. La biblioteca de plantillas es una buena base.

​
Fase 3: Ampliar y depurar

  1. Pasa a Activado de forma predeterminada cuando la mayoría de las organizaciones usen blueprints. Las organizaciones que usaban la configuración clásica con repos reciben excepciones clásicas automáticas, así que para ellas no cambia nada.
  2. Las nuevas organizaciones creadas a partir de este momento empiezan con blueprints de forma predeterminada.
  3. Supervisa la página Rollout para ver el estado de las compilaciones en todas las organizaciones. Filtra por “Classic” para ver quiénes aún no han migrado.
  4. Trabaja con los admins de las organizaciones restantes para migrar a las que faltan. El asistente de migración hace que este proceso sea sencillo.
  5. Elimina las excepciones clásicas una vez que todas las organizaciones estén verificadas en blueprints.
La configuración clásica siempre se conserva. No se elimina nada cuando una organización cambia a blueprints. Si algo sale mal, los admins de Enterprise pueden volver a cambiar al instante cualquier organización a la configuración clásica desde la página Rollout.

​
Reversión

Las cosas no siempre salen según lo previsto. El sistema de despliegue admite la reversión en todos los niveles.

​
Reversión por org

Los administradores de Enterprise pueden hacer que cualquier org vuelva a la configuración clásica desde la página Rollout:
  • La org vuelve de inmediato a usar su instantánea de configuración clásica.
  • La configuración clásica se conserva. No se pierde nada cuando una org cambia a blueprints, así que volver atrás es seguro.
  • Las sesiones activas no se ven afectadas. El cambio entra en vigor en la siguiente sesión.

​
Reversión a nivel Enterprise

Los administradores de Enterprise pueden pasar de Activado de forma predeterminada a Desactivado de forma predeterminada:
  • Las organizaciones que tenían anulaciones explícitas de blueprints las conservan. Siguen usando blueprints.
  • Las organizaciones que usaban blueprints de forma predeterminada (sin anulaciones) vuelven a la configuración clásica.
  • Esta es una operación segura. No se pierde ningún dato de configuración en ninguno de los dos sentidos.
La reversión no elimina los blueprints ni las configuraciones clásicas. Ambos se conservan independientemente de qué modo esté activo, por lo que puede alternar entre ellos sin perder trabajo.

​
Supervisión del estado del rollout

La página Rollout ofrece un panel para hacer seguimiento del progreso de la migración en tu empresa.

​
Fila de KPI

En la parte superior de la página, las métricas de resumen ofrecen una visión rápida del estado del despliegue:
  • Organizaciones con blueprints: Número de organizaciones que actualmente usan blueprints
  • Porcentaje de despliegue: Porcentaje de organizaciones con blueprints sobre el total
  • Estado general de la compilación: Estado agregado de las compilaciones en las organizaciones con blueprints

​
Tabla por organización

Debajo de los KPI, una tabla detallada muestra cada organización:
ColumnaDescripción
OrganizationNombre de la organización
StateModo actual: Blueprints o Classic
OverrideSi el estado de la organización es una sobrescritura explícita o el valor predeterminado de Enterprise
Classic reposNúmero de repositorios con configuración clásica
Blueprint reposNúmero de repositorios con blueprints
Latest buildEstado de la compilación más reciente (Success, Partial, Failed, etc.)

​
Filtrado

Filtra la tabla por:
  • All: Todas las organizaciones de Enterprise
  • Blueprints: Organizaciones que actualmente usan blueprints
  • Classic: Organizaciones que actualmente usan la configuración clásica
  • Overrides: Organizaciones con anulaciones explícitas del estado (en cualquiera de las dos direcciones)

​
Seguridad frente a la concurrencia

Las transiciones de estado están protegidas frente a cambios simultáneos. Si otro administrador cambia el estado de Enterprise entre que cargas la página y envías tu cambio, la solicitud se rechaza con un error de conflicto. Esto evita sobrescrituras accidentales cuando varios administradores de Enterprise actúan al mismo tiempo. Si tu cambio se rechaza, actualiza la página para ver el estado actual y vuelve a enviarlo si aún corresponde.

​
Registro de auditoría

Todas las transiciones de estado del despliegue se registran en los registros de auditoría:
  • Cambios de estado de Enterprise (Desactivado → Predeterminado desactivado, Predeterminado desactivado → Predeterminado activado, etc.)
  • Cambios en las anulaciones por org (la org se incluyó, la org se excluyó, se eliminó la anulación)
  • Qué Admin realizó el cambio y cuándo
Estos registros están disponibles a través de la interfaz estándar de registros de auditoría de tu empresa.