Ingeniería
Cómo definir un contrato de despliegue para aplicaciones generadas por IA
El código generado por IA sigue necesitando un contrato: compílalo, inícialo, configúralo, compruébalo y dirige el tráfico a la versión exacta que revisaste.
El modelo puede escribir código rápidamente. Un contrato de despliegue explica cómo ese código se convierte en un entorno de ejecución reproducible.
Un contrato de despliegue responde a cinco preguntas
Un proyecto generado puede tener buena lógica de aplicación y aun así ser imposible de ejecutar de forma coherente. El contrato de despliegue cubre esa carencia al definir los comandos, el entorno de ejecución, las dependencias, el comportamiento de salud y la ruta.
Mantén esas respuestas cerca del código fuente. Si la aplicación necesita una base de datos, una cola, una caché o una clave privada de un proveedor, esa dependencia debe ser visible antes del despliegue.
- —¿Cómo se compila la aplicación desde una copia limpia del repositorio?
- —¿Cómo comienza el proceso de producción?
- —¿Qué puerto y ruta de salud demuestran que está listo?
- —¿Qué secretos y servicios gestionados son necesarios?
- —¿Qué versión recibe tráfico público?
El código generado no debe ocultar las operaciones
Las herramientas de IA suelen elegir valores predeterminados prácticos. Esto ayuda a explorar, pero los desarrolladores deben comprobar que el servidor escucha en el host correcto, que las migraciones se ejecutan con seguridad y que las credenciales se referencian en lugar de guardarse en commits.
El contrato también permite que los revisores detecten cambios arriesgados. Un nuevo comando de inicio, ruta de salud, dependencia de recursos o ruta pública puede cambiar la disponibilidad aunque el diff de la aplicación parezca pequeño.
name: worker-api
build_cmd: go build -o /app/server ./cmd/server
start_cmd: /app/server
runtime:
name: go@1.25
port: 8080
health_path: /healthz
requires:
- db
- queueUsa vistas previas para probar el contrato
Una vista previa debe probar los mismos supuestos de compilación e inicio que usará el despliegue. Si la aplicación no escucha en el puerto configurado, no puede leer un secreto necesario o indica que está saludable mientras su base de datos es inaccesible, corrígelo antes de promoverla.
Ese es el propósito de conectar los espacios de trabajo basados en código fuente con el despliegue. El desarrollador puede pedir un cambio al agente, ejecutar la vista previa, inspeccionar registros, ajustar el manifiesto y desplegar la versión que superó las pruebas.
Provoca una vez el fallo de cada límite
Ejecuta la compilación desde una copia limpia del repositorio, inicia el proceso con el puerto público ocupado, elimina un secreto necesario y deja inaccesible la dependencia de salud. Cada fallo debe estar acotado, ser visible en los registros y permitir un reintento seguro.
Por último, restaura la dependencia y promueve únicamente la revisión que haya superado las pruebas. Un contrato de despliegue es útil cuando predice tanto el funcionamiento saludable como la forma de mantener una versión incompleta apartada del tráfico.