Documentation Index
Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
Use this file to discover all available pages before exploring further.
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 |
