設定リファレンス

Wippyは.wippy.yamlファイルで設定されます。すべてのオプションには妥当なデフォルト値があります。

以下の値はいずれも、起動時に wippy run --set section.path=value で上書きできます（繰り返し指定可能で、ファイルより優先されます）。これらの設定セクションではなく個々のレジストリエントリを上書きするには、override: セクションまたは -o を使用します — エントリの上書きを参照してください。

Logger

zap ロガーのエンコーダを制御します。CLI フラグ（-v, -c, -s）はレベル/出力を上書きします。yaml で制御できる唯一のオプションはエンコーディングです。

logger:
  encoding: json

ログマネージャ

ランタイムログルーティングを制御します。コンソール出力はCLIフラグ（-v, -c, -s）で設定します。

logmanager:
  propagate_downstream: true
  stream_to_events: false
  min_level: 0

参照: ロガーモジュール

プロファイラ

CPU/メモリプロファイリング用のGo pprof HTTPサーバー。-pフラグまたは設定で有効化。

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

アクセス: http://localhost:6060/debug/pprof/

セキュリティ

グローバルセキュリティ動作。個別のポリシーはsecurity.policyエントリとして定義されます。

security:
  strict_mode: true

参照: セキュリティシステム, セキュリティモジュール

レジストリ

エントリストレージとバージョン履歴。レジストリはすべての設定エントリを保持します。

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

参照: レジストリコンセプト, レジストリモジュール

リレー

ノード間のプロセス間メッセージルーティング。

relay:
  node_name: worker-1

参照: プロセスモデル

スーパーバイザ

サービスライフサイクル管理。ライフサイクルイベントのディスパッチに使用されるスーパーバイザの内部制御メールボックスを制御します。

supervisor:
  host:
    buffer_size: 2048
    worker_count: 32

参照: スーパービジョンガイド

Luaランタイム

Lua VMキャッシュと式評価。

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

参照: Lua概要

ファインダー

レジストリ検索キャッシュ。エントリルックアップに内部的に使用されます。

finder:
  query_cache_size: 2000

OpenTelemetry

OTLPによる分散トレーシングとメトリクスエクスポート。

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

標準 OTEL 環境変数（OTEL_EXPORTER_OTLP_ENDPOINT、OTEL_SERVICE_NAME、OTEL_TRACES_SAMPLER_ARG、OTEL_PROPAGATORS、OTEL_SDK_DISABLED）は一致するフィールドを上書きします。

参照: 可観測性ガイド

シャットダウン

グレースフルシャットダウン動作。

shutdown:
  timeout: 60s

メトリクス

内部メトリクス収集バッファ。

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

参照: メトリクスモジュール, 可観測性ガイド

Prometheus

Prometheusメトリクスエンドポイント。

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

Prometheusスクレイピング用の/metricsエンドポイントを公開します。

参照: 可観測性ガイド

クラスタ

マルチノードクラスタリング: ゴシップメンバーシップと有界 Raft コンセンサスコア。アーキテクチャと運用モデルについてはクラスタガイドを参照。このセクションは設定キーのリファレンスです。

トップレベル

メンバーシップ（ゴシップ）

memberlist による SWIM ゴシップ。ノード探索、障害検出、メタデータ伝播に使用されます。

ノード間（トランスポート）

ノード間でリレーと Raft トラフィックを運ぶ TCP メッシュ。Raft はこのメッシュ上を走行（yamux 多重化）し、独立した Raft ポートはありません。

Raft（コンセンサス）

有界 Raft。Raft の状態はデフォルトで fs 永続化され、raft.data_dir（デフォルト ~/.wippy/store）の下に保存されます。再起動したノードでもピアからクォーラムに再参加します。store.kv.raft エントリはこれを通じてレプリケートされます。ブートストラップはゴシップ駆動（Consul/Nomad の bootstrap_expect スタイル）です。

単一ノード（開発用）— クラスタリング有効、即座にブートストラップ:

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

3ノード投票クラスタ — 各ノードが他のノードをシードとして指定し、3つ全てが揃うのを待ってからクォーラムを形成:

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

ゴシップのみのクライアント — 名前付けやメッセージングのためにクラスタに参加するが、Raft は実行しない:

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

LSP

エディタ統合のためのLanguage Server Protocolサーバー。

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

参照: LSPガイド

ネットワークサービス

オーバーレイネットワークマネージャ（SOCKS5、I2P、Tailscaleドライバ）。

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

参照: ネットワークオーバーレイ

HTTPディスパッチャ

HTTP ディスパッチ関数や送信リクエストで使用される共有 HTTP クライアントプールのチューニング。

dispatcher:
  http:
    timeout: 30s
    max_idle_per_host: 32

モジュール

wippy install/update で使用されるモジュールレジストリクライアント。

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

拡張機能

起動時に読み込まれるネイティブGoプラグイン拡張機能（Unixのみ）。

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

環境変数

関連項目

• CLIリファレンス - コマンドラインオプション
• クラスタガイド - クラスタリングのアーキテクチャと運用
• エントリ種別 - すべてのエントリタイプ
• 可観測性ガイド - ロギング、メトリクス、トレーシング