Konfigurationsreferenz

Konfigurationsreferenz

Wippy wird über .wippy.yaml-Dateien konfiguriert. Alle Optionen haben sinnvolle Standardwerte.

Jeder Wert unten kann beim Start mit wippy run --set section.path=value überschrieben werden (wiederholbar, hat Vorrang vor der Datei). Um einzelne Registry-Einträge statt dieser Konfigurationsabschnitte zu überschreiben, verwenden Sie den Abschnitt override: oder -o — siehe Einträge überschreiben.

Logger

Steuert den zap-Logger-Encoder. CLI-Flags (-v, -c, -s) überschreiben Level/Ausgabe; die einzige yaml-gesteuerte Option ist die Kodierung.

Feld	Typ	Standard	Beschreibung
encoding	string	console	Encoder: console (menschenlesbar) oder json (strukturiert)

logger:
  encoding: json

Log-Manager

Steuert das Runtime-Log-Routing. Konsolenausgabe wird über CLI-Flags (-v, -c, -s) konfiguriert.

Feld	Typ	Standard	Beschreibung
propagate_downstream	bool	true	Logs an Konsolen-/Dateiausgabe senden
stream_to_events	bool	false	Logs für programmatischen Zugriff zum Event-Bus veröffentlichen
min_level	int	-1	Minimales Level: -1=debug, 0=info, 1=warn, 2=error

logmanager:
  propagate_downstream: true
  stream_to_events: false
  min_level: 0

Siehe: Logger-Modul

Profiler

Go pprof HTTP-Server für CPU-/Speicher-Profiling. Mit -p Flag oder Konfiguration aktivieren.

Feld	Typ	Standard	Beschreibung
enabled	bool	false	Profiler-Server starten
address	string	localhost:6060	Adresse zum Lauschen
read_timeout	duration	15s	HTTP Read-Timeout
write_timeout	duration	15s	HTTP Write-Timeout
idle_timeout	duration	60s	Keep-Alive-Timeout

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

Zugriff unter http://localhost:6060/debug/pprof/

Sicherheit

Globales Sicherheitsverhalten. Individuelle Richtlinien werden als security.policy-Einträge definiert.

Feld	Typ	Standard	Beschreibung
strict_mode	bool	false	Zugriff verweigern wenn Sicherheitskontext unvollständig

security:
  strict_mode: true

Siehe: Sicherheitssystem, Sicherheitsmodul

Registry

Eintragsspeicherung und Versionshistorie. Die Registry enthält alle Konfigurationseinträge.

Feld	Typ	Standard	Beschreibung
enable_history	bool	true	Eintragsversionen verfolgen
history_type	string	memory	Speicher: memory, sqlite, nil
history_path	string	.wippy/registry.db	SQLite-Dateipfad

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

Siehe: Registry-Konzept, Registry-Modul

Relay

Nachrichtenrouting zwischen Prozessen über Knoten hinweg.

Feld	Typ	Standard	Beschreibung
node_name	string	local	Bezeichner für diesen Relay-Knoten

relay:
  node_name: worker-1

Siehe: Prozessmodell

Supervisor

Dienst-Lebenszyklus-Verwaltung. Steuert das interne Steuerungs-Postfach des Supervisors, das zum Versand von Lebenszyklus-Ereignissen verwendet wird.

Feld	Typ	Standard	Beschreibung
host.buffer_size	int	1024	Kapazität des internen Steuerungs-Postfachs
host.worker_count	int	16	Nebenläufige Dispatcher-Worker

supervisor:
  host:
    buffer_size: 2048
    worker_count: 32

Siehe: Supervision-Anleitung

Worker und Warteschlangen pro `process.host` werden am Eintrag selbst konfiguriert (`workers`, `queue_size`, `local_queue_size`), nicht in diesem globalen Abschnitt. Siehe den [Process Host](system/process-host.md)-Eintragstyp.

Lua-Runtime

Lua-VM-Caching und Expression-Auswertung.

Feld	Typ	Standard	Beschreibung
proto_cache_size	int	60000	Kompilierter Prototype-Cache
main_cache_size	int	10000	Main-Chunk-Cache
cache.enabled	bool	false	Kompilierten Bytecode-/Typecheck-Cache auf Disk persistieren
cache.dir	string	(System-Cache-Verzeichnis)	Cache-Verzeichnis-Pfad
cache.mode	string	read_write	Cache-Modus: read_write, read_only, write_only
type_system.enabled	bool	false	Statische Typprüfung aktivieren
type_system.strict	bool	false	Typwarnungen als Fehler behandeln

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

Siehe: Lua-Übersicht

Finder

Registry-Such-Caching. Wird intern für Eintrags-Lookups verwendet.

Feld	Typ	Standard	Beschreibung
query_cache_size	int	1000	Gecachte Abfrageergebnisse
regex_cache_size	int	100	Kompilierte Regex-Muster

finder:
  query_cache_size: 2000

OpenTelemetry

Verteiltes Tracing und Metrik-Export über OTLP.

Feld	Typ	Standard	Beschreibung
enabled	bool	false	OTEL aktivieren
endpoint	string	localhost:4318	OTLP-Endpunkt
protocol	string	http/protobuf	Protokoll: grpc, http/protobuf
service_name	string	wippy-runtime	Dienst-Bezeichner
service_version	string		Dienst-Versions-Tag
insecure	bool	true	Unverschlüsselte OTLP-Verbindung zulassen
sample_rate	float	1.0	Trace-Sampling (0.0-1.0)
propagators	string[]	[tracecontext, baggage]	Context-Propagatoren
traces_enabled	bool	true	Traces exportieren
metrics_enabled	bool	false	Metriken exportieren
http.enabled	bool	true	HTTP-Anfragen tracen
http.extract_headers	bool	true	Trace-Context aus eingehenden Headern extrahieren
http.inject_headers	bool	true	Trace-Context in ausgehende Header einfügen
process.enabled	bool	true	Prozess-Lebenszyklus tracen
process.trace_lifecycle	bool	true	Spans für spawn/terminate ausgeben
interceptor.enabled	bool	true	Funktionsaufrufe tracen
interceptor.order	int	100	Interceptor-Priorität
queue.enabled	bool	true	Queue publish/consume tracen
temporal.enabled	bool	false	Temporal-Workflows tracen

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

Standard-OTEL-Umgebungsvariablen (OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_SERVICE_NAME, OTEL_TRACES_SAMPLER_ARG, OTEL_PROPAGATORS, OTEL_SDK_DISABLED) überschreiben die entsprechenden Felder.

Siehe: Observability-Anleitung

Shutdown

Verhalten beim kontrollierten Herunterfahren.

Feld	Typ	Standard	Beschreibung
timeout	duration	30s	Maximale Wartezeit für Komponenten zum Stoppen

shutdown:
  timeout: 60s

Metriken

Interner Metriken-Sammlungspuffer.

Feld	Typ	Standard	Beschreibung
buffer.size	int	10000	Metriken-Puffer-Kapazität
interceptor.enabled	bool	false	Funktionsaufrufe automatisch verfolgen

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

Siehe: Metriken-Modul, Observability-Anleitung

Prometheus

Prometheus-Metriken-Endpunkt.

Feld	Typ	Standard	Beschreibung
enabled	bool	false	Metriken-Server starten
address	string	localhost:9090	Adresse zum Lauschen

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

Stellt /metrics-Endpunkt für Prometheus-Scraping bereit.

Siehe: Observability-Anleitung

Cluster

Multi-Node-Clustering: Gossip-Mitgliedschaft plus ein begrenzter Raft-Konsenskern. Siehe den Cluster-Leitfaden für Architektur und Betriebsmodell; dieser Abschnitt ist die Konfigurationsschlüssel-Referenz.

Oberste Ebene

Feld	Typ	Standard	Beschreibung
enabled	bool	false	Clustering aktivieren
name	string	hostname	Knotenname; muss im Cluster eindeutig sein
failure_domain	string		Zonen-/Rack-Label; im Gossip beworben, damit Voter über Domains verteilt werden

Mitgliedschaft (Gossip)

SWIM-Gossip über memberlist. Wird für Knotenentdeckung, Fehlererkennung und Metadaten-Verbreitung verwendet.

Feld	Typ	Standard	Beschreibung
membership.bind_addr	string	0.0.0.0	Gossip-Bind-Adresse
membership.bind_port	int	7946	Gossip-Bind-Port (TCP+UDP)
membership.advertise_addr	string		Adresse, die Peers verwenden, um diesen Knoten zu erreichen (NAT/k8s)
membership.join_addrs	string		Kommagetrennte Seed-host:port-Paare
membership.secret_key	string		Base64-kodierter Gossip-Verschlüsselungsschlüssel (inline)
membership.secret_file	string		Pfad zur Datei mit dem Gossip-Verschlüsselungsschlüssel

Internode (Transport)

TCP-Mesh für Relay- und Raft-Verkehr zwischen Knoten. Raft nutzt dieses Mesh (yamux-multiplexiert); es gibt keinen separaten Raft-Port.

Feld	Typ	Standard	Beschreibung
internode.bind_addr	string	0.0.0.0	Mesh-Bind-Adresse
internode.bind_port	int	0	Mesh-Port (0 = auto: 7950-7959, dann ephemer)
internode.auto_port	bool	true	Tatsächlichen Port beim Start ermitteln, festlegen und im Gossip bewerben

Raft (Konsens)

Begrenztes Raft. Der Raft-Zustand ist standardmäßig fs-dauerhaft und wird unter raft.data_dir (Standard ~/.wippy/store) gespeichert; ein neugestarteter Knoten tritt dem Quorum dennoch von Peers wieder bei. store.kv.raft-Einträge replizieren darüber. Bootstrap ist gossip-gesteuert (Consul/Nomad bootstrap_expect-Stil).

Feld	Typ	Standard	Beschreibung
raft.data_dir	string	~/.wippy/store	Verzeichnis für fs-dauerhaften Raft-Zustand und dauerhafte CRDT-Snapshots (unter <data_dir>/_sys/). Festplatten-los nur, wenn kein Pfad aufgelöst wird (kein Home-Verzeichnis und keiner gesetzt)
raft.enabled	bool	true	Raft-Knoten betreiben; false macht diesen zum reinen Gossip-Client
raft.role	string	server	server betreibt einen Raft-Knoten; client ist nur Gossip
raft.eligible	bool	true	Ob dieser Knoten als Voter ausgewählt werden darf
raft.priority	int	100	Voter-Auswahlpriorität (niedrigerer Wert wird bevorzugt)
raft.bootstrap_expect	int	1	Initiale Quorumgröße: 0=bestehendem beitreten, 1=Einzelknoten, N=auf N berechtigte Peers warten, dann Quorum bilden
raft.max_voters	int	5	Voter-Obergrenze (muss ungerade sein); zusätzliche berechtigte Knoten werden Standbys
raft.max_standbys	int	4	Nicht-abstimmende Mitglieder, warm gehalten für Beförderung; Knoten jenseits voters+standbys sind keine Raft-Mitglieder
raft.reconcile_debounce	duration	2s	Koaleszenzfenster nach einem Gossip-Ereignis, bevor der Voter-Reconciler läuft
raft.reconcile_timeout	duration	2s	Schranke pro Reconcile-Durchlauf
raft.heartbeat_timeout	duration	3s	Follower-Leerlaufwartzeit vor dem Start einer Wahl
raft.election_timeout	duration	3s	Kandidaten-Wahltimeout (mindestens heartbeat)
raft.commit_timeout	duration	500ms	Heartbeat-Takt des Leerlauf-Leaders
raft.snapshot_threshold	uint64	8192	Log-Einträge seit dem letzten Snapshot, bevor ein neuer erstellt wird
raft.snapshot_interval	duration	2m	Snapshot-Prüfintervall
raft.snapshot_retain	int	3	Beibehaltene Snapshots
raft.trailing_logs	uint64	10240	Nach einem Snapshot beibehaltene Log-Einträge
raft.max_append_entries	int	16	Maximale Einträge pro AppendEntries RPC
raft.leader_probe_interval	duration	3s	Takt der Globale-Registry-Leader-Erreichbarkeits-Probe
raft.leader_probe_grace	int	3	Aufeinanderfolgende Probe-Fehler, bevor Leader als nicht erreichbar gilt

Einzelknoten (Entwicklung) — Clustering aktiviert, bootstrappt sich sofort:

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

Drei-Knoten-Voting-Cluster — jeder Knoten listet die anderen als Seeds und wartet auf alle drei vor der Quorumbildung:

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

Gossip-only-Client — tritt dem Cluster für Benennung/Messaging bei, betreibt nie Raft:

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

LSP

Language-Server-Protocol-Server für Editor-Integrationen.

Feld	Typ	Standard	Beschreibung
enabled	bool	false	TCP-Server aktivieren
address	string	:7777	TCP-Listen-Adresse
http_enabled	bool	false	HTTP-Transport aktivieren
http_address	string	:7778	HTTP-Listen-Adresse
http_path	string	/lsp	HTTP-Endpunkt-Pfad
http_allow_origin	string	*	CORS Allowed-Origin
max_message_bytes	int	8388608	Maximale Größe eingehender Nachrichten

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

Siehe: LSP-Anleitung

Netzwerkdienst

Overlay-Netzwerk-Manager (SOCKS5-, I2P-, Tailscale-Treiber).

Feld	Typ	Standard	Beschreibung
state_dir	string	.wippy/net	Verzeichnis für Treiber-Statusspeicherung
default_network	string		Standard-Netzwerk-ID, die angewendet wird, wenn Einträge network weglassen

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

Siehe: Netzwerk-Overlays

HTTP-Dispatcher

Tuning für den gemeinsamen HTTP-Client-Pool, der von HTTP-dispatched Funktionen und ausgehenden Anfragen verwendet wird.

Feld	Typ	Standard	Beschreibung
dispatcher.http.timeout	duration	0 (kein)	Timeout pro Anfrage
dispatcher.http.max_idle_conns	int	0 (stdlib)	Maximale Leerlaufverbindungen über alle Hosts
dispatcher.http.max_idle_per_host	int	0 (stdlib)	Maximale Leerlaufverbindungen pro Host
dispatcher.http.idle_conn_timeout	duration	0 (stdlib)	Leerlaufverbindungs-Timeout
dispatcher.http.max_clients	int	0 (unbegrenzt)	Maximale unterschiedliche gepoolte Clients

dispatcher:
  http:
    timeout: 30s
    max_idle_per_host: 32

Module

Modul-Registry-Client, der von wippy install/update verwendet wird.

Feld	Typ	Standard	Beschreibung
registry_url	string	https://hub.wippy.ai	Registry-Endpunkt

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

Erweiterungen

Native Go-Plugin-Erweiterungen, die beim Booten geladen werden (nur Unix).

Feld	Typ	Standard	Beschreibung
enabled	bool	true	Erweiterungen laden
paths	string[]		Plugin-Dateipfade (relativ zum Konfigurationsverzeichnis)

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

Umgebungsvariablen

Variable	Beschreibung
GOMEMLIMIT	Speicherlimit (überschreibt --memory-limit Flag)

Siehe auch

• CLI-Referenz - Kommandozeilenoptionen
• Cluster-Leitfaden - Clustering-Architektur und Betrieb
• Entry-Typen - Alle Entry-Typen
• Observability-Anleitung - Logging, Metriken, Tracing