コンテンツにスキップ

認証

kubetail CLI ツールは、ローカルの kubeconfig ファイルを使って Kubernetes クラスターに認証します。クラスター内の権限は Cluster RBAC によって処理されます。


認証が必要な kubetail コマンド(例: kubetail serve, kubetail logs)を実行すると、Kubetail はローカルの kubeconfig ファイルを読み取り、そこに定義された認証情報を使って各クラスター context に接続します。標準的な kubeconfig の Credential タイプはすべてサポートされています。

Credential タイプkubeconfig フィールド
Client certificate / keyclient-certificate, client-key
Bearer tokentoken, tokenFile
Exec credential pluginexec (例: aws eks get-token, gke-gcloud-auth-plugin)
OIDC / auth-providerauth-provider

Kubetail は kubeconfig ファイルの変更を監視し、再起動なしで新しい context や更新された context を取り込みます。


kubetail は kubeconfig ユーザーの権限を利用します。最低限、監視するリソースに対する読み取り権限が必要です。

リソースAPI グループ動詞
cronjobsbatchget, list, watch
daemonsetsappsget, list, watch
deploymentsappsget, list, watch
jobsbatchget, list, watch
namespacescoreget, list, watch
nodescoreget, list, watch
podscoreget, list, watch
pods/logcoreget, list, watch
replicasetsappsget, list, watch
statefulsetsappsget, list, watch

kubetail は、ユーザーが限られた namespace にしかアクセスできない場合も自動的に検出します。