クイックスタート

実行ファイルをインストールし、ターミナル UI から既存の Kubernetes コンテキストを使って独立した kubeconfig を発行します。管理者 kubeconfig を変更せず、コントロールプレーンにも何も追加しません。

必要条件

amd64 または arm64 の Linux、macOS、Windows。
有効な管理者 kubeconfig と、到達可能な Kubernetes API サーバー。
名前空間・RBAC リソースの読取、ServiceAccount・バインディング・serviceaccounts/token の作成権限。

インストール

ダウンロードページからプラットフォームとアーキテクチャに合ったファイルを入手します。Linux の tar.gz または macOS の zip を展開すると kticket が得られます。Windows は exe を直接ダウンロードします。

# Linux amd64
tar -xzf kticket_linux_amd64.tar.gz
mv kticket /usr/local/bin/kticket
kticket --help

各ダウンロードには対応する <filename>.sha256 が付属しています。展開またはインストールの前に検証してください。

発行前にアクティベート

kubeconfig の発行と権限の追加には有効なライセンスが必要です。マシン ID を取得し、ライセンスの購入とアクティベーションに従ってメールの添付ファイルをインストールしてください。未アクティベートでも TUI の確認、アカウント表示、失効は利用できます。

kticket license machine-id
kticket license install /path/to/kticket-license.ktlicense
kticket license status

ターミナル UI を開く

サブコマンドなしで kticket を実行し、クラスターと操作を選びます。F2 で6言語を切り替えられ、下書きは保持されます。

kticket

アカウント、権限、有効期間、出力先を選び、確認して発行します。

スクリプトで CLI を使用

スクリプトからの発行には CLI を使用します。このコマンドは既存の app-prod 名前空間で alice に読取権限を付与し、8 時間の認証情報を要求します。view ClusterRole が必要です。

kticket issue --context my-cluster --username alice \
  --access namespace --role view --role-namespace app-prod \
  --duration 8h --output ./alice.kubeconfig

現在の kubeconfig を変えずに生成ファイルをテスト:

kubectl --kubeconfig ./alice.kubeconfig \
  get pods --namespace app-prod

確認と失効

kticket list --context my-cluster --credentials
kticket access list --context my-cluster --username alice
kticket revoke --context my-cluster --username alice

注: CLI の書込コマンドは確認なしで即時実行します。適用前に変更を確認したい場合は TUI を使用してください。