Variables de entorno

Referencia de todas las variables de entorno utilizadas por Flowker, organizadas por categoría.

Esta referencia lista todas las variables de entorno utilizadas por Flowker. Las variables marcadas como obligatorias causarán que el servidor falle al iniciar si no están definidas.

Servidor

Variable	Descripción	Por defecto	Obligatoria
ENV_NAME	Nombre del entorno (dev/staging/production)	development	No
SERVER_ADDRESS	Dirección de bind del servidor	:4021	No
CORS_ALLOWED_ORIGINS	Orígenes CORS permitidos	*	No

Autenticación

Variable	Descripción	Por defecto	Obligatoria
API_KEY	Clave de API para autenticación vía header X-API-Key	—	Sí (si API_KEY_ENABLED=true)
API_KEY_ENABLED	Habilitar autenticación por clave de API	false	No
PLUGIN_AUTH_ENABLED	Habilitar autenticación mediante el plugin de Access Manager como alternativa a la API Key	false	No
PLUGIN_AUTH_ADDRESS	Dirección gRPC del servicio Access Manager	—	Sí (si PLUGIN_AUTH_ENABLED=true)

Base de datos (MongoDB)

Variable	Descripción	Por defecto	Obligatoria
MONGO_URI	URI de conexión de MongoDB	—	Sí
MONGO_DB_NAME	Nombre de la base de datos MongoDB	flowker	No
MONGO_TLS_CA_CERT	Certificado CA en formato PEM codificado en Base64 para conexiones TLS (p. ej., AWS DocumentDB)	—	No
MONGO_MAX_POOL_SIZE	Tamaño máximo del pool de conexiones de MongoDB	10	No

Base de datos de auditoría (PostgreSQL)

Variable	Descripción	Por defecto	Obligatoria
AUDIT_DB_HOST	Host de la base de datos de auditoría	—	Sí (fatal si falta)
AUDIT_DB_PORT	Puerto de la base de datos de auditoría	5432	No
AUDIT_DB_USER	Usuario de la base de datos de auditoría. Por defecto es flowker_audit si no se establece.	flowker_audit	No
AUDIT_DB_PASSWORD	Contraseña de la base de datos de auditoría. Por defecto es flowker_audit si no se establece.	flowker_audit	No
AUDIT_DB_NAME	Nombre de la base de datos de auditoría	flowker_audit	No
AUDIT_DB_SSL_MODE	Modo SSL para la conexión con la base de auditoría	disable	No
AUDIT_MIGRATIONS_PATH	Ruta a los archivos de migración de la base de auditoría	/migrations	No

Observabilidad

Variable	Descripción	Por defecto	Obligatoria
ENABLE_TELEMETRY	Habilitar instrumentación OpenTelemetry	false	No
OTEL_EXPORTER_OTLP_ENDPOINT	Endpoint del exportador OTLP	—	Sí (si ENABLE_TELEMETRY=true)
OTEL_RESOURCE_SERVICE_NAME	Nombre del servicio para telemetría	flowker	No
OTEL_RESOURCE_SERVICE_VERSION	Versión del servicio para telemetría	—	No
OTEL_RESOURCE_DEPLOYMENT_ENVIRONMENT	Etiqueta de entorno de despliegue	—	No
OTEL_LIBRARY_NAME	Nombre de la biblioteca de instrumentación	—	No
SKIP_LIB_COMMONS_TELEMETRY	Omitir telemetría de la biblioteca commons	false	No
LOG_LEVEL	Nivel de log (debug/info/warn/error)	debug	No

Seguridad

Variable	Descripción	Por defecto	Obligatoria
SSRF_ALLOW_PRIVATE	Permitir llamadas HTTP de executors a IPs privadas	false	No
FAULT_INJECTION_ENABLED	Habilitar inyección de fallos para pruebas	false	No

Swagger

Variable	Descripción	Por defecto	Obligatoria
SWAGGER_TITLE	Título de la UI de Swagger	varía	No
SWAGGER_DESCRIPTION	Descripción de la UI de Swagger	varía	No
SWAGGER_VERSION	Versión de la API en Swagger	varía	No
SWAGGER_HOST	Host de Swagger	varía	No
SWAGGER_BASE_PATH	Base path de Swagger	varía	No
SWAGGER_SCHEMES	Esquemas de URL de Swagger	varía	No