Configuración y despliegue

Descubre cómo se empaqueta y ejecuta Lender: forma del contenedor, dependencias, variables de entorno, modos multi-tenant y ruta de posting al ledger.

Lender es un único servicio Go, empaquetado como contenedor y configurado por completo mediante variables de entorno. Esta página es la referencia del operador: qué se ejecuta, de qué depende, los ajustes que importan y cómo se comportan la tenancy y el enrutamiento al ledger.

​

El contenedor

---

Lender se construye desde un Dockerfile multi-etapa — un builder Go Alpine que produce un binario estático, copiado a un runtime distroless nonroot — y escucha en el puerto 8080. Se entrega como una imagen de contenedor que despliegas en tu clúster de con el tooling de ciclo de vida estándar de la plataforma; esta página no asume ningún empaquetado particular más allá de la imagen.

Sondas operativas:

Endpoint	Propósito
GET /health	Liveness.
GET /readyz	Readiness de dependencias.
GET /version	Metadatos de build y versión.

​

Dependencias

---

Dependencia	Rol
PostgreSQL 17	Almacén de datos primario, con soporte primario/réplica y aislamiento schema-por-tenant en modo multi-tenant.
Valkey 8 (compatible con Redis)	Caché, rate limiting y la caché de credenciales M2M.
RabbitMQ	Transporte del publicador de eventos, impulsado por un dispatcher de outbox transaccional.
RedPanda	Backbone de streaming para el catálogo de eventos del ciclo de vida (vía la librería de streaming de Lerian).
Midaz	El de partida doble, alcanzado a través del SDK oficial. Lender se autentica vía Access Manager con credenciales máquina-a-máquina (M2M) por tenant, obtenidas de AWS Secrets Manager y cacheadas en Valkey.
Casdoor	Proveedor de identidad que respalda la autorización de rutas (vía la librería de auth de Lerian).
Systemplane	Plano de configuración en tiempo de ejecución, montado bajo /api/v1/systemplane.

​

Superficie de configuración

---

La configuración es enteramente por entorno. Las claves de abajo son un subconjunto curado — las que moldean el comportamiento — no la lista completa.

Grupo	Clave	Qué controla
App	ENV_NAME, LOG_LEVEL, DEPLOYMENT_MODE, SERVER_ADDRESS	Nombre de entorno, verbosidad de logs, modo de despliegue y dirección de escucha.
Tenancy	MULTI_TENANT_ENABLED, DEFAULT_TENANT_ID	Alternar entre modos single- y multi-tenant, y el tenant usado en single-tenant.
Tenancy (MT)	MULTI_TENANT_MAX_TENANT_POOLS, MULTI_TENANT_CIRCUIT_BREAKER_THRESHOLD	Techo de pools de conexión por tenant y punto de disparo del circuit breaker.
Postgres	POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_NAME, POSTGRES_SSLMODE, MIGRATIONS_PATH	Conexión a la base primaria y migraciones.
Caché	REDIS_HOST, REDIS_PASSWORD, M2M_CREDENTIAL_CACHE_TTL_SEC	Conexión a Valkey y cuánto se cachean las credenciales M2M.
Mensajería	RABBITMQ_ENABLED, RABBITMQ_HOST, OUTBOX_DISPATCH_INTERVAL_SEC	Transporte RabbitMQ y la cadencia del dispatcher del outbox. El outbox de PostgreSQL siempre se inicializa; no tiene flag de habilitación.
Streaming	STREAMING_ENABLED, STREAMING_BROKERS, STREAMING_TLS_ENABLED	Toggle de streaming de eventos, direcciones de brokers y TLS.
Auth	PLUGIN_AUTH_ENABLED, AUTH_M2M_INVERSION_ENABLED	Autorización de rutas y el gate de inversión M2M requerido para BYOC.
Seguridad de proxy	TLS_TERMINATED_UPSTREAM, TRUST_PROXY_ENABLED, TRUSTED_PROXIES	Terminación TLS upstream y la lista restrictiva de proxies confiables que exige en despliegues endurecidos.
Consignado	CONSIGNADO_ENABLED	Tiene true como valor por defecto. Usa false solo para desmontar intencionalmente la ruta de contratación; el servicing de contratos existentes sigue disponible. Cuando lo deshabilites, deja también apagados CONSUMER_CONSIGNADO_AVERBACAO_CONFIRMED_ENABLED y CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED; el arranque rechaza esa configuración contradictoria. Consulta Consignado privado.
Ledger M2M	AWS_REGION	Región del Secrets Manager que guarda las credenciales de Midaz por tenant.
Observabilidad	ENABLE_TELEMETRY, OTEL_EXPORTER_OTLP_ENDPOINT	Toggle de telemetría y endpoint del colector OTLP.
Límites	RATE_LIMIT_ENABLED	Rate limiting de peticiones. Siempre activo con ENV_NAME=production.
Docs	SWAGGER_ENABLED	Sirve el documento OpenAPI y la UI de referencia de la API. Siempre inactivo con ENV_NAME=production.

​

Modos multi-tenant

---

Lender corre en uno de dos modos:

• Single-tenant — un tenant (DEFAULT_TENANT_ID), un esquema de base de datos y una organización de ledger y ledger fijados en tiempo de construcción usados como default de posting.
• Multi-tenant (MULTI_TENANT_ENABLED=true) — persistencia schema-por-tenant, un pool de clientes de Midaz por tenant y eventos y postings de alcance por tenant. En este modo no hay default de ledger por entorno: el destino de ledger viene por transacción del perfil contable del producto.

​

Posting al ledger y enrutamiento fail-closed

---

Un posting llega al ledger a través de una intención de posting durable y un relay asíncrono — la ruta completa está en Lender en la plataforma. La propiedad operativamente importante: el enrutamiento falla cerrado. Un posting se contabiliza en la organización de ledger y el ledger resueltos desde el perfil contable (single-tenant cae de vuelta al default por entorno); si ninguno resuelve un destino no vacío, Lender se niega a contabilizar en lugar de contabilizar en un ledger vacío o equivocado. En modo multi-tenant, un producto sin perfil contable por lo tanto no puede hacer posting — que es la salvaguarda buscada.

​

Próximos pasos

---

Lender en la plataforma

La ruta de posting, el catálogo de eventos y el aislamiento de tenants en detalle.