設定

Kubetail をクラスタにデプロイすると、Dashboard、Cluster API、Cluster Agent の各コンポーネントは、コンテナにマウントされた YAML 設定ファイルを使って個別に設定されます。Helm chart は ConfigMap を通じてこれらのファイルを管理しますが、chart の runtimeConfig フィールドを上書きすることで任意の設定をカスタマイズできます。

設定の仕組み

各コンポーネントは、起動時に --config フラグで渡された設定ファイルを読み込みます。

dashboard     --config /etc/kubetail/config.yaml
cluster-api   --config /etc/kubetail/config.yaml
cluster-agent --config /etc/kubetail/config.yaml

設定ファイルは Helm chart によって作成された ConfigMap からマウントされます。コンポーネントごとの設定を調整するには、Helm values の kubetail.<component>.runtimeConfig 以下に上書き値を指定します。

kubetail:
  dashboard:
    runtimeConfig:
      logging:
        level: debug
  clusterAPI:
    runtimeConfig:
      logging:
        level: debug

Dashboard

Dashboard は UI をホストし、ブラウザーからクラスタへのリクエストを中継する Web サーバーです。クラスタ環境では kubetail-system namespace の Deployment として動作します。

完全な設定リファレンスは Dashboard リファレンスを参照してください。

Cluster API

Cluster API は、Dashboard から各ノードで動作する Cluster Agent インスタンスへリクエストを中継するバックエンドサーバーです。クラスタ内では kubetail-system namespace の Deployment として動作します。

完全な設定リファレンスは Cluster API リファレンスを参照してください。

Cluster Agent

Cluster Agent は各ノードで動作し、ノードのファイルシステムからコンテナのログファイルを直接読み取る小さな Rust 製プログラムです。クラスタ内では kubetail-system namespace の DaemonSet として動作します。

完全な設定リファレンスは Cluster Agent リファレンスを参照してください。