Variables de entorno¶

tai-api no lee ningún .env, ni la API generada ni el CLI: las variables tienen que estar en el entorno del proceso. Para desarrollo, lo cómodo es exportarlas desde la shell o con direnv.

La API¶

Variable	Qué es	Por defecto
`MAIN_DATABASE_URL`	La base de datos. En realidad, la variable que declare el `datasource()` de cada schema	—
`SECRET_KEY`	Firma los tokens en modo Database —sin ella la API no arranca— y cifra las columnas `encrypt=True`. El nombre se cambia con `secret_key_name`	—
`API_DOCS_PWD`	La contraseña de `/docs` (usuario `admin`)	`admin`, con un aviso al arrancar
`RBAC_ENABLED`	La autorización. La fijan los puntos de entrada: `__main__.py` la enciende y `__dev__.py`, el de `tai-api dev`, la apaga (`tai-api dev --auth` arranca `__main__.py`)	—
`PORT`	El puerto del contenedor	`80`
`TZ`	La zona horaria del contenedor	`Europe/Madrid`

Keycloak¶

Variable	Qué es	Por defecto
`MAIN_KEYCLOAK_URL`	La URL de Keycloak. Admite `usuario:contraseña@` para el administrador	—
`KEYCLOAK_API_CLIENT_SECRET`	El secreto del cliente de la API. Firma también la cookie del login por redirección	—
`KEYCLOAK_ADMIN_USERNAME` · `KEYCLOAK_ADMIN_PASSWORD`	El administrador, si no va en la URL	—
`KEYCLOAK_PUBLIC_URL`	La URL con la que los navegadores ven Keycloak, si no es la misma: es el emisor de los tokens	la de `MAIN_KEYCLOAK_URL`
`KEYCLOAK_API_CLIENT` · `KEYCLOAK_APP_CLIENT`	Los nombres de los clientes	`api` · `app`
`KEYCLOAK_VERIFY_SSL`	`false` para no verificar el certificado (solo desarrollo)	`true`
`KEYCLOAK_TIMEOUT`	Segundos por petición a Keycloak	`10`
`PUBLIC_URL`	La URL de la API que ve el navegador, con su `/api`. La necesita el login por redirección	—

El CLI¶

Variable	Quién la usa	Qué es
`VIRTUAL_ENV`	`install`	Tiene que haber un entorno virtual activo
`ADMIN_PWD`	`tai-sql push -s auth --with-feed`	La contraseña del usuario `admin` (modo Database). Sin ella, `admin`
Las de Keycloak	`rbac push`	Las mismas que la API

El contenedor¶

Variable	Qué es
`WEBSITES_ENABLE_APP_SERVICE_STORAGE`	La pone Azure App Service; con `true`, el contenedor arranca SSH en el 2222
`AZURE_ENV`	`true` para arrancar SSH fuera de Azure

El frontend¶

Variable	Qué es
`API_URL`	Adónde reenvía el proxy `/api` de Vite. Se lee al arrancar el servidor, no al compilar. Ver Despliegue del frontend

Lo que no es una variable¶

ROOT_PATH, ALLOWED_ORIGINS y VERSION son constantes de <paquete>/config.py. Ver Configuración.