Pase la configuración mediante variables de entorno

Codificar de forma fija una ruta de modelo o una clave de API la dejará integrada en la imagen para siempre. En su lugar, páselas como environment variables durante la ejecución.

Use os.getenv para leer una variable con un valor predeterminado razonable. Así, su código se adapta a cada entorno sin modificaciones.

La instrucción ENV del Dockerfile establece un valor predeterminado integrado en la imagen. Es útil para configuraciones no confidenciales que cambian rara vez.

Anule cualquier valor con -e en docker run. Así, la misma imagen puede servir en staging o producción con configuraciones diferentes.

Mantenga muchas variables organizadas en un archivo y cárguelo con --env-file. El comando de ejecución seguirá siendo corto y fácil de leer.

Mantenga los archivos secretos fuera de Git y de la imagen. Añada su .env a .gitignore y .dockerignore para evitar filtraciones.

Los secretos reales, como las contraseñas de bases de datos, deben proceder de un vault o del gestor de secretos de su plataforma e inyectarse únicamente durante la ejecución.

Compruebe las variables obligatorias cuando se inicie la aplicación y haga que falle de forma explícita si falta alguna. Un fallo claro es mejor que una predicción incorrecta silenciosa.

La regla twelve-factor indica que la configuración debe almacenarse en el entorno. Esto mantiene una imagen portable en cualquier destino de implementación.

Herramientas como pydantic-settings leen las variables de entorno en un objeto de configuración tipado y validan los tipos y valores predeterminados en un único lugar claro.

La ventaja: compile once y ejecute esa misma imagen exacta en desarrollo, staging y producción; cambie únicamente las variables que inyecte.

Ha leído la configuración con os.getenv, ha establecido valores predeterminados mediante ENV, los ha anulado con -e y --env-file, y ha mantenido los secretos fuera. Una imagen portable. ✅