kubectl チートシート

クライアント / サーバのバージョン情報を表示(バージョンのずれ確認に便利)。

--client クライアントのみ; -o yaml/json

マスタとクラスタ内サービスの情報を表示します。

--context ctx; --output json|yaml

kubeconfig 内の全コンテキストを一覧表示します。

--minify; -o name|json|yaml

現在のコンテキストを切り替えます。

コンテキストの表示 / リネーム / 更新(namespace、cluster、user を設定)。

--current 現在を表示; set-context --namespace N --cluster C --user U

コンテキスト毎の既定 namespace を変更し、以降のコマンドで -n を不要にします。

pods / services / deployments / replicasets / statefulsets などを一覧表示します。

-A 全 namespace; -n ns; -l label=key=value セレクタ; -o wide|yaml|json|name|custom-columns; --sort-by

特定のリソース タイプを一覧表示します(よく使うリソース)。

-A; -l app=api; -o wide(node, ip 表示); --field-selector; --sort-by .metadata.creationTimestamp

オブジェクト全体を YAML/JSON で出力し、確認やエクスポートに使います。

-o yaml; --export クラスタ固有フィールドを除いて保存

詳細情報、イベント、コンテナ状態、ライフサイクルを表示 — デバッグに最適。

-n ns; -A 全 namespace; --show-events=true

API サーバから直接スキーマ / フィールドのドキュメントを表示します。

マニフェストを適用 / 更新し、クラスタ状態を一致させます(宣言的)。

-f file|dir|URL; -R ディレクトリを再帰; --prune; --force-conflicts server-side apply; --server-side

`apply` で何を変更するか表示(KUBECTL_EXTERNAL_DIFF または diff バイナリが必要)。

-R; --server-side; --prune

マニフェストから命令的に作成 / 削除します(ワンショット)。

create -f; delete -f; delete pod foo; delete svc,deploy -l app=foo(複合)

ライブ オブジェクトをエディタで開きます(既定は vi)。

-o yaml; --save-config; --windows-line-ending

ライブ オブジェクトに strategic-merge / JSON patch を適用します。

--type strategic|merge|json; --patch-file file.json

新しいイメージでロールアウトをトリガ;`set image env / resources` も同様。

set image env / resources / serviceaccount / subject / selector

ライブ オブジェクトにラベル / アノテーションを追加 / 更新します。

key=value 追加; key- 削除(末尾 -); --overwrite

pod のログを表示(-c で特定コンテナを指定)。

-f フォロー; --tail N; --since R|D|T; --timestamps; -c コンテナ; --all-containers; -p 前回

コンテナの 1 つ前のインスタンスのログを表示(クラッシュ / ロールアウト後)。

-c コンテナ; --tail N

ラベルに一致する全 pod のログを集約 — Deployment で便利。

-l app=api; --all-containers=true; -f; --max-log-requests N

pod 内でコマンドを実行(任意で対話 bash/sh)。

-it; -c コンテナ; -n ns; -- /bin/sh

pod とローカル間でファイル / フォルダをコピー(exec を介して tar を使用)。

-c コンテナ; -n ns

ローカル ポートを pod(または svc、deploy)に転送します。

pod/<name> <l>:r; svc/<name> <l>:r; --address 127.0.0.1

ローリング アップデートの準備完了(またはタイム アウト)までを監視します。

--timeout 5m; --revision N

ロールアウト履歴の表示 / 過去のリビジョンへロールバック。

history --revision N; undo --to-revision N; --dry-run=client

pod テンプレートへのパッチで Deployment(DaemonSet / StatefulSet も)を再起動します。

-n ns

レプリカ数を直接設定;マニフェストは変更しません。

--current-replicas 先確認; --dry-run=client -o yaml

指定範囲で HPA を作成(`kubectl create hpa` を使うのも可)。

--max --min --cpu-percent; --dry-run=client -o yaml

メンテナンス前(アップグレード等)にノードから安全 pod を退避します。

--grace-period N; --force; --skip-errors; --dry-run; --delete-emptydir-data

ノードをスケジューリング不可(cordon)/ 可(uncordon)に。メンテナンス後に uncordon を使います。

--name で暗黙指定、フラグは不要

pod を削除 — Deployment ではコントローラが新規作成します(単一インスタンスの強制再起動にも利用)。

--grace-period=0 --force; -n ns; --now

CPU / メモリのライブ使用率を表示(metrics-server が必要)。

--sort-by cpu|memory; --containers; -A; -l

デバッグ コンテナを追加 attach(kubectl-debug / Ephemeral Containers)。

--image <img>; --target-container; --share-processes; --profile

クラスタ イベントを tail し、スケジューリング / イメージ取得 / プローブ失敗を発見。

--field-selector involvedObject.name=podX; -A; -w; --watch-only-events

現在のユーザが実行可能な操作を確認 — RBAC デバッグに最適。

--as user; --as-group; -n ns; --all-namespaces

リソースが目的の状態になるまでブロック(CI / スクリプトで利用)。

--for condition=Ready|Available; --timeout 60s; --all --selector

ConfigMap / Secret を命令的に作成(`kubectl create secret generic ...`)。

--from-file; --from-literal=KEY=val; --dry-run=client -o yaml

ServiceAccount の短期トークンを発行(静的 Secret より推奨)。

--duration 24h

base64 の Secret キーを 1 度だけ確認するためにデコードします。