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.

Composición de Configuración {#config-composition}

--config es repetible; los archivos se componen de izquierda a derecha usando el mismo esquema:

wippy run --config .wippy.yaml --config .wippy.local.yaml

• Los archivos posteriores sobrescriben los valores coincidentes y conservan todo lo demás.
• Cada archivo nombrado explícitamente debe existir. Sin --config, el .wippy.yaml por defecto es opcional.
• El primer archivo ancla el directorio usado para resolver rutas relativas.
• Los nombres de archivo no tienen significado reservado; nada aparte del archivo por defecto se descubre automáticamente.

La configuración se aplica en orden: composición de archivos, luego las selecciones de --profile, luego las sobrescrituras de --set. Para aplicaciones ejecutadas desde packs, los valores por defecto de runtime empaquetados se sitúan por debajo de todos estos (ver Publicar Valores por Defecto de Runtime).

Perfiles {#profiles}

Un archivo de configuración puede declarar overlays con nombre bajo profiles:. Cada cuerpo de perfil refleja las secciones normales de configuración; seleccionarlo con --profile <name> superpone esos valores sobre la configuración base fusionada:

version: "1.0"

vars:
  port: 8085

override:
  app:db:kind: db.sql.sqlite

disable:
  namespaces: ["legacy.**"]

profiles:
  pg:
    vars:
      port: 18085
    override:
      app:db:kind: db.sql.postgres
    disable:
      namespaces.add: ["experimental.**"]

wippy run --profile pg

• --profile es repetible; los perfiles se componen de izquierda a derecha, después de la composición de archivos y antes de --set. Un nombre desconocido es un error.
• Los valores se fusionan por hoja (el último en escribir gana). La propia sección profiles: se elimina de la configuración resuelta.
• La sección disable admite operaciones de lista dentro de perfiles — namespaces.add, namespaces.remove, entries.add, entries.remove — de modo que un perfil puede ajustar la lista base en lugar de reemplazarla.
• Las referencias ${name} se interpolan desde la sección vars: fusionada. Las referencias a variables de entorno del SO no están permitidas dentro de las vars de perfil; usa ${env:NAME} en la configuración base, resuelta al cargar el archivo.

wippy run, test y pack aceptan --profile; install, update, lint y registry también lo aceptan para perfiles de workspace (junto con --set). Las aplicaciones pueden distribuir perfiles dentro de packs — ver Publicar Perfiles.

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.

Las cuatro claves de sondeo heredan los valores por defecto de red local de memberlist cuando no están definidas; auméntalas para enlaces de alta latencia (ej. probe_interval: 2s, probe_timeout: 500ms, suspicion_mult: 5).

Internodo (transporte)

Malla TCP que transporta el tráfico de relay y Raft entre nodos. Raft viaja por esta malla mediante request/reply internodo; no hay un puerto Raft separado.

advertise_addr/advertise_port publican un endpoint aditivo en los metadatos del nodo mientras el endpoint de enlace sigue anunciándose sin cambios, de modo que los clusters con versiones mixtas mantienen la conectividad durante una actualización progresiva.

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