Referencia de Configuración

Wippy se configura mediante archivos .wippy.yaml. Todas las opciones tienen valores por defecto razonables.

Cualquier valor a continuación puede sobrescribirse en el arranque con wippy run --set section.path=value (repetible, tiene prioridad sobre el archivo). Para sobrescribir entradas individuales del registro en lugar de estas secciones de configuración, usa la sección override: o -o — consulta Sobrescribir entradas.

Logger

Controla el codificador del logger zap. Los flags de CLI (-v, -c, -s) sobrescriben el nivel/salida; la única opción controlada por yaml es la codificación.

logger:
  encoding: json

Gestor de Registros

Controla el enrutamiento de registros del runtime. La salida en consola se configura mediante flags de CLI (-v, -c, -s).

logmanager:
  propagate_downstream: true
  stream_to_events: false
  min_level: 0

Ver: Módulo Logger

Profiler

Servidor HTTP de pprof de Go para perfilado de CPU/memoria. Habilitarlo con el flag -p o mediante configuración.

profiler:
  enabled: true
  address: "localhost:6060"

Acceso en http://localhost:6060/debug/pprof/

Seguridad

Comportamiento de seguridad global. Las políticas individuales se definen como entradas security.policy.

security:
  strict_mode: true

Ver: Sistema de Seguridad, Módulo de Seguridad

Registro

Almacenamiento de entradas e historial de versiones. El registro almacena todas las entradas de configuración.

registry:
  history_type: sqlite
  history_path: /var/lib/wippy/registry.db

Ver: Concepto de Registro, Módulo de Registro

Relay

Enrutamiento de mensajes entre procesos a través de nodos.

relay:
  node_name: worker-1

Ver: Modelo de Procesos

Supervisor

Gestión del ciclo de vida de servicios. Controla el buzón de control interno del supervisor utilizado para despachar eventos de ciclo de vida.

supervisor:
  host:
    buffer_size: 2048
    worker_count: 32

Ver: Guía de Supervisión

Runtime de Lua

Caché de la VM de Lua y evaluación de expresiones.

lua:
  proto_cache_size: 60000
  cache:
    enabled: true
    dir: .cache/lua
  type_system:
    enabled: true

Ver: Visión General de Lua

Finder

Caché de búsqueda del registro. Usado internamente para búsquedas de entradas.

finder:
  query_cache_size: 2000

OpenTelemetry

Exportación de trazas distribuidas y métricas via OTLP.

otel:
  enabled: true
  endpoint: "http://jaeger:4318"
  traces_enabled: true
  process:
    trace_lifecycle: true

Las variables de entorno estándar de OTEL (OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_SERVICE_NAME, OTEL_TRACES_SAMPLER_ARG, OTEL_PROPAGATORS, OTEL_SDK_DISABLED) sobrescriben los campos correspondientes.

Ver: Guía de Observabilidad

Apagado

Comportamiento de apagado controlado.

shutdown:
  timeout: 60s

Métricas

Buffer interno de recolección de métricas.

metrics:
  buffer:
    size: 20000
  interceptor:
    enabled: true

Ver: Módulo de Métricas, Guía de Observabilidad

Prometheus

Endpoint de métricas de Prometheus.

prometheus:
  enabled: true
  address: "0.0.0.0:9090"

Expone el endpoint /metrics para el scraping de Prometheus.

Ver: Guía de Observabilidad

Cluster

Clustering multi-nodo: membresía por gossip más un núcleo de consenso Raft acotado. Ver la Guía de Cluster para la arquitectura y el modelo operativo; esta sección es la referencia de claves de configuración.

Nivel superior

Membresía (gossip)

Gossip SWIM via memberlist. Usado para descubrimiento de nodos, detección de fallos y diseminación de metadatos.

Internodo (transporte)

Malla TCP que transporta el tráfico de relay y Raft entre nodos. Raft viaja por esta malla (multiplexada con yamux); no hay un puerto Raft separado.

Raft (consenso)

Raft acotado. El estado de Raft es durable en disco por defecto, almacenado bajo raft.data_dir (por defecto ~/.wippy/store); un nodo reiniciado aún se une al quórum desde sus peers. Las entradas store.kv.raft se replican a través de él. El bootstrap es dirigido por gossip (estilo Consul/Nomad bootstrap_expect).

Nodo único (desarrollo) — clustering activado, se bootstrapea inmediatamente:

cluster:
  enabled: true
  name: dev
  raft:
    bootstrap_expect: 1

Cluster de votación de tres nodos — cada nodo lista los otros como semillas y espera a los tres antes de formar quórum:

cluster:
  enabled: true
  name: node-1
  failure_domain: us-east-1a
  membership:
    bind_port: 7946
    join_addrs: "node-2:7946,node-3:7946"
    secret_file: /etc/wippy/cluster.key
  raft:
    bootstrap_expect: 3
    max_voters: 5

Cliente solo-gossip — se une al cluster para naming/mensajería pero nunca ejecuta Raft:

cluster:
  enabled: true
  name: edge-7
  membership:
    join_addrs: "node-1:7946,node-2:7946"
  raft:
    role: client

LSP

Servidor del Protocolo de Servidor de Lenguaje para integraciones con editores.

lsp:
  enabled: true
  address: ":7777"
  http_enabled: true

Ver: Guía de LSP

Servicio de Red

Gestor de red superpuesta (drivers SOCKS5, I2P, Tailscale).

network_service:
  state_dir: /var/lib/wippy/net
  default_network: app:tailscale

Ver: Redes Superpuestas

Despachador HTTP

Ajuste del pool de clientes HTTP compartido utilizado por funciones despachadas HTTP y solicitudes salientes.

dispatcher:
  http:
    timeout: 30s
    max_idle_per_host: 32

Módulos

Cliente del registro de módulos usado por wippy install/update.

modules:
  registry_url: https://internal-registry.example.com

Extensiones

Extensiones de plugin nativo de Go cargadas al inicio (solo Unix).

extensions:
  enabled: true
  paths:
    - ./extensions/myplugin.so

Variables de Entorno

Ver También

• Referencia de CLI - Opciones de línea de comandos
• Guía de Cluster - Arquitectura y operaciones de clustering
• Tipos de Entrada - Todos los tipos de entrada
• Guía de Observabilidad - Registro, métricas, trazas