Skip to main content
La configuración declarativa (blueprints) es la nueva generación de la configuración de entornos: con control de versiones, combinable y con actualizaciones automáticas. Esta guía te explica cómo migrar desde el asistente interactivo clásico.

​
¿Por qué migrar?

Con el asistente de configuración clásico, el entorno de Devin es una instantánea configurada manualmente que puede desincronizarse con el tiempo. Las dependencias se quedan obsoletas, los cambios de configuración requieren volver a ejecutar el asistente y no hay historial de versiones. La configuración declarativa resuelve esto:
  • Actualizaciones automáticas: los blueprints se reconstruyen cuando cambia tu repositorio, por lo que las dependencias se mantienen actualizadas
  • Con control de versiones: la configuración de tu entorno se guarda junto con tu código, con historial completo
  • Componible: los blueprints de Enterprise, organización y repositorio se combinan por capas de forma ordenada
  • Reproducible: cada compilación produce el mismo resultado a partir del mismo blueprint
  • Sesiones más rápidas: las instantáneas se precompilan con los repositorios clonados y las dependencias instaladas, por lo que las sesiones empiezan listas para trabajar
Te recomendamos migrar a la configuración declarativa cuando estés listo. Mientras tanto, tu configuración clásica seguirá funcionando.

​
Antes de empezar

Busca un banner en la página Machine Configuration (la página de configuración clásica) que diga “Switch to Devin’s new v2 environment”. Si lo ves, tu organización cumple los requisitos.Si no ves el banner, la configuración declarativa todavía no está habilitada para tu organización. Se está implementando gradualmente. Ponte en contacto con el administrador de tu empresa o con soporte.
La migración requiere permisos de admin de la organización (ManageOrgSettings). Si no eres admin de la organización, verás el mensaje “Admin access required” en la página de migración.
Sí. Tu instantánea actual se conserva por completo. Puedes revertir el cambio en cualquier momento y tu organización volverá de inmediato a la instantánea anterior. No se pierde nada.

​
Pasos de migración

​
1. Ve a la página de migración

Ve a Settings > Environment migration o haz clic en Get started en el banner que aparece en la página Machine Configuration.

​
2. Activa la configuración declarativa

Haz clic en Habilitar para la organización. Esto hace que tu organización use instantáneas basadas en blueprints para las sesiones nuevas.
Esto no afecta a tu instantánea actual. Se conserva por si necesitas revertir el cambio.

​
3. Deja que Devin genere tus blueprints

Devin hace el trabajo por ti. Haz clic en Iniciar migración y selecciona los repositorios que quieras migrar primero. No tienes que migrarlo todo de una vez. Empieza con los repositorios que más uses. Cuando inicias la migración, Devin crea dos sesiones:
  • Una sesión principal que se ejecuta en el nuevo entorno declarativo y genera los blueprints
  • Una sesión auxiliar que se ejecuta en tu instantánea actual, que Devin usa para inspeccionar lo que está instalado en este momento (versiones de lenguaje, paquetes del sistema, servicios en ejecución, etc.)
Devin examina tu instantánea actual, determina qué herramientas y dependencias están instaladas y genera la configuración de blueprint equivalente. Los resultados aparecen en tu página de Configuración de Environment.
Tu instantánea actual es una “caja negra” de todo lo que has ido configurando con el tiempo. Devin inspecciona esa instantánea, cataloga lo que está instalado y lo convierte automáticamente en un blueprint reproducible.

​
4. Revisa y ajusta

Después de que Devin genere los blueprints:
  1. Ve a Settings > Configuración de Environment para revisar lo que se generó
  2. Comprueba el estado de la compilación. Busca Success.
  3. Inicia una sesión de prueba para verificar que todo funcione:
    • Confirma que los repos estén clonados y que las dependencias estén instaladas
    • Intenta ejecutar tus comandos de lint, pruebas y compilación
    • Verifica que cualquier herramienta o runtime personalizado esté disponible
Si falta algo, edita el blueprint directamente. Puedes agregar pasos de initialize, comandos de maintenance o entradas de Knowledge.

​
Revertir

Si algo no funciona, puedes revertir el cambio en cualquier momento:
  1. Ve a Settings > Environment migration
  2. Haz clic en Revert to classic setup
  3. Tu organización vuelve inmediatamente a usar la instantánea anterior
Tu instantánea actual se conserva por completo. No se pierde nada. Puedes intentar la migración de nuevo cuando estés listo.

​
Equivalencia entre los pasos de configuración clásicos y los blueprints

Si prefieres escribir tu blueprint manualmente (o quieres comprender esta equivalencia), así es como corresponden los pasos del asistente clásico:
Paso de configuración clásicoEquivalente en blueprintNotas
Git pullAutomáticoLos blueprints gestionan git clone y git pull automáticamente
SecretsPanel de Secrets en la UISe configura en Settings > Configuración de Environment
Instalar dependenciasinitializeConfiguración única: entornos de ejecución, paquetes del sistema, herramientas globales
Mantenimiento de dependenciasmaintenanceConfiguración recurrente por sesión: npm install, pip install, etc.
Lintknowledge (name: lint)Solo como referencia; no se ejecuta durante las compilaciones
Testknowledge (name: test)Solo como referencia; no se ejecuta durante las compilaciones
Ejecutar la appknowledge (name: dev-server)Solo como referencia; no se ejecuta durante las compilaciones
Notas adicionalesknowledgeEntradas libres para Devin

​
Ejemplo

Configuración clásica:
  • Instalar dependencias: nvm use 20 && npm install
  • Actualizar dependencias: npm install
  • Lint: npm run lint
  • Ejecutar pruebas: npm test
  • Ejecutar la aplicación: npm run dev
Blueprint equivalente: 
initialize: |
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  source ~/.bashrc
  nvm install 20

maintenance: |
  npm install

knowledge:
  - name: lint
    contents: npm run lint
  - name: test
    contents: npm test
  - name: dev-server
    contents: npm run dev

​
Solución de problemas

Consulta los logs de compilación para identificar el error específico. Causas comunes:
  • Un comando que funcionaba en el terminal de configuración clásica no funciona en el contexto de compilación (p. ej., prompts interactivos que requieren flags -y)
  • Faltan secrets (asegúrate de que estén configurados en el panel de secrets del editor de blueprints)
  • Compara los comandos de tu blueprint con los comandos originales para detectar diferencias
Asegúrate de que la sección maintenance incluya los mismos comandos de instalación de dependencias que el paso clásico mantenimiento de dependencias. Comandos como npm install o pip install -r requirements.txt deben ir en maintenance, no en initialize.
Verifica que la sección knowledge tenga elementos llamados lint y test con los comandos correctos. Devin busca estos nombres al verificar su trabajo.
Si tu configuración clásica modificaba ~/.bashrc, ~/.profile u otro archivo de configuración del shell, mueve esos cambios a initialize:
initialize: |
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  echo 'export NODE_ENV=development' >> ~/.bashrc
Los blueprints gestionan git clone automáticamente durante las compilaciones. Si los repos no se están clonando, verifica que estén agregados en la página de Configuración de Environment y que Devin tenga acceso a través de tu integración con Git.