Requisitos previos: Esta guía asume que estás familiarizado con la configuración declarativa de entornos. Consulta configuración declarativa de Environment para obtener una introducción.
La jerarquía del blueprint
La configuración de Environment de Devin sigue una jerarquía de tres niveles. Cada nivel se basa en el anterior:
La relación es acumulativa: los blueprints de la organización y del repositorio se basan en el blueprint de Enterprise; no lo reemplazan. Durante cada compilación, el blueprint de Enterprise se ejecuta primero y establece la línea de base. Luego se ejecuta el blueprint de la organización, agregando la configuración específica del equipo. Por último, se ejecuta el blueprint de cada repositorio con la configuración específica del proyecto.
Consulta Ámbito del blueprint para ver cómo se relacionan los blueprints de la organización y del repositorio.
Configurar el blueprint de Enterprise
Ve a Enterprise Settings > Environments y abre la pestaña Blueprint para definir el blueprint de Enterprise. Usa el mismo formato que los blueprints de org y repositorio, con seccionesinitialize, maintenance y knowledge. Los blueprints de Enterprise y de org también admiten una sección post-build para comandos que se ejecutan después de clonar y configurar todos los repositorios.
El blueprint de Enterprise se ejecuta primero en cada compilación, antes que los blueprints de org y repositorio. Esto significa que las herramientas y los entornos de ejecución instalados a nivel de Enterprise están disponibles para todos los blueprints posteriores.
Qué incluir en el blueprint Enterprise
El blueprint Enterprise es para las herramientas y la configuración que toda organización necesita. Casos de uso habituales:Entornos de ejecución estándar de lenguajes
Fija las versiones de lenguaje en toda la organización para que todos los equipos trabajen con el mismo conjunto de herramientas:Herramientas de seguridad y análisis de cumplimiento
Instala los escáneres y las herramientas de auditoría que todos los proyectos deben usar:Herramientas y utilidades internas de la CLI
Distribuye herramientas específicas de la empresa a cada Environment:Configuración compartida de registros de paquetes
Configura los gestores de paquetes para que apunten a tus registros internos:Configuración del proxy y los certificados corporativos
Instala certificados de la CA corporativa y configura los ajustes del proxy:Cómo interactúan los niveles
Durante una compilación, los pasos de cada nivel se ejecutan en una secuencia fija. El resultado de los niveles anteriores está disponible para los posteriores. Las herramientas instaladas en el nivel Enterprise están listas para usarse en los blueprints de la org y el repositorio sin necesidad de reinstalarlas. Una compilación crea una nueva instantánea en este orden:post-build se ejecutan después de que cada repositorio se haya clonado y configurado, por lo que pueden validar el Environment ya montado por completo. Un código de salida distinto de cero en un paso de post-build hace fallar la compilación y no se produce ninguna instantánea. Consulta post-build en la referencia de blueprint.
Los niveles son acumulativos: los blueprints de repositorio pueden usar herramientas instaladas por el org o por el blueprint de Enterprise. Los niveles inferiores no pueden sobrescribir lo que configuró un nivel superior. Las compilaciones suelen tardar entre 5 y 15 minutos. Los comandos individuales superan el tiempo de espera después de 3 horas.
Los elementos de knowledge de todos los niveles se recopilan y se ponen a disposición de Devin. Si varios niveles definen un elemento de knowledge con el mismo nombre, se incluyen todos. No se sobrescriben entre sí.
Secretos de Enterprise
Los administradores de Enterprise pueden definir secretos a nivel Enterprise. Estos secretos están disponibles como variables de entorno durante cada compilación y cada sesión en todas las organizaciones, tanto en los pasos de blueprint de Enterprise como en los de org y repositorio, salvo que estén marcados como solo para compilación. Usa secretos de Enterprise para credenciales que se comparten en toda la empresa:- Tokens de registros internos de paquetes
- Autenticación del proxy corporativo
- Claves de API compartidas para servicios internos
- Claves de licencia para herramientas Enterprise
Gestionar secretos de Enterprise requiere el permiso ManageAccountResources.
Secretos de Enterprise solo para compilación
Al agregar un secreto de Enterprise, activa solo para compilación para restringirlo al environment setup. Un secret solo de compilación está disponible únicamente para los pasos de los blueprints de enterprise y de org durante las compilaciones de instantánea. Se elimina antes de clonar los repositorios, por lo que ni los pasos del blueprint del repo ni los pasospost-build pueden leerlo, y nunca está disponible en las sesiones de Devin. Los secrets marcados de esta forma muestran un badge solo para compilación en la lista de secrets.
Reconstrucciones a nivel Enterprise
Los administradores de Enterprise pueden activar una reconstrucción que se aplica en cascada a todas las organizaciones. Esto resulta útil cuando:- Actualizas el blueprint de Enterprise (p. ej., actualizas Python de 3.11 a 3.12)
- Rotas un secreto de Enterprise
- Necesitas actualizar todos los Environments después de un parche de seguridad
Las reconstrucciones a nivel Enterprise respetan la cola de compilación de cada org. Si una org ya tiene una compilación en curso, la reconstrucción activada a nivel Enterprise se encola detrás de ella. Si ya hay una compilación en cola, se cancela
y se reemplaza por la activada a nivel Enterprise.
Gestión del despliegue en todas las organizaciones
La página Despliegue ofrece visibilidad a nivel Enterprise del estado de los entornos y la cobertura de blueprints de cada organización. Úsela para identificar organizaciones sin blueprint o con compilaciones fallidas u obsoletas. Consulte Estado del despliegue para obtener información sobre el playbook de adopción gradual de blueprints y directrices sobre el estado de las compilaciones.Páginas relacionadas
- Escenarios: crecimiento con ACME Corp — ejemplos prácticos para elegir un nivel a medida que la empresa crece
- Estado del despliegue
- Mejores prácticas
- Referencia de blueprint
- Configuración declarativa de Environment