はじめに

ここでは、Kubernetes 1.21 の CHANGELOG から SIG-CLI (kubectl) の取り組みについてまとめています。

新たに追加された主なコマンドとフラグ

--show-managed-fields フラグ: もし true の場合、JSON または YAML 形式でオブジェクトを出力する際に managedFields をそのままにする
- これまで出力されていた metadata.managedFields がデフォルトでは出力されなくなりました。出力したい場合が明示的に --show-managed-fields フラグを使用する必要があります
- metadata.managedFields は Server Side Apply で使用されるフィールドで、誰がどのフィールドを管理しているかの記録に使用されています
-q ショートフラグ: --quiet フラグのショートフラグとして追加
kubectl drain --ignore-errors フラグ: ドレインするノード群のなかで発生したエラーを無視する
- これまでドレイン中にあるノードで失敗すると処理が中断されていましたが、この挙動は廃止予定となり、今後はエラーが発生しても対象のすべてのノードでドレインが実行されるように変更されます。このフラグを使用することで、将来的なデフォルトの挙動を先に試すことができます。
kubectl top --use-protocol-buffers フラグ: 使用すると、メトリクスのリクエストに Protocol Buffers が使われる

変更があった主なコマンドとフラグ

kubectl kustomize コマンドと kubectl apply -k フラグ: Kustomize バージョンが v2.0.3 から v4.0.5 に更新

廃止予定のコマンドとフラグ

kubectl run コマンド: --serviceaccount, --hostport, --requests, --limits フラグ

削除されたコマンドとフラグ

kubectl run コマンド: --generator, --replicas, --service-generator, --service-overrides, --schedule フラグ

そのほか、細かい変更は、 https://github.com/superbrothers/kubectl-docs/compare/v1.20.0...v1.21.0 で参照できます。

What's New (新情報)

Kubectl の Kustomize の更新

kubectl の Kustomize バージョンが v2.0.3 から v4.0.5 にジャンプしました。Kustomize はライブラリとして扱われるようになり、将来の更新は不定期ではなくなります。

ついに kubectl に組み込まれていた Kustomize（kubectl kustomize、kubectl apply -k など）が最新まで追従されました。v2.0.3 から v4.0.5 への更新で別物になっているため、これまで kubectl の kustomize 機能を使用していた人は十分に注意してください。

Kustomize ツールは単体で機能するツールで独自のリリースサイクルも持っているため、個人的にはこれまでもこれからも組み込まれている機能は使わないつもりです。

デフォルトのコンテナを事前に選択できるアノテーション

複数のコンテナを含む Pod は、kubectl コマンドのために事前にコンテナを選択しておける kubectl.kubernetes.io/default-container アノテーションを使用できるようになりました。詳しくは KEP-2227 を参照してください。

これまでは kubectl で --container オプションを使用していなかった場合には次の挙動になっていました。

kubectl exec/attach/cp: デフォルトで最初のコンテナを選択する
kubectl logs: デフォルトはなく、kubectl.kubernetes.io/default-logs-container アノテーションがある場合はそれで指定されたコンテナを選択する

例えば Pod にサイドカーコンテナを挿入するサービスメッシュのプロダクトを採用した場合に、そのサービスメッシュがコンテナリストの先頭にサイドカーコンテナを挿入するようになっていると、これまでアプリケーションコンテナに対して実行されていたコマンドがサイドカーコンテナ内で実行されるようになってしまうという問題がありました。

kubectl.kubernetes.io/default-container アノテーションにより、事前にデフォルトで選択されるコンテナを指定できるようにすることで上記の課題が解決されます。

apiVersion: v1
kind: Pod
metadata:
 annotations:
    kubectl.kubernetes.io/default-container: app

なお、このアノテーションが使用されていない場合は、これまでと同じリストの先頭のコンテナがデフォルトで選択されます。

このアノテーションがサポートされたことで kubectl logs コマンドが kubectl.kubernetes.io/default-logs-container アノテーションを使用してデフォルトのコンテナを事前に選択できる機能がありましたが、これは廃止予定になり v1.25 で削除される予定です。代わりに kubectl.kubernetes.io/default-container を使用する必要があります。

kubectl プラグイン等でこのアノテーションをサポートしたい場合には podcmd.FindOrDefaultContainerByName 関数が便利につかえます。

https://github.com/kubernetes/kubectl/blob/v0.21.0/pkg/cmd/util/podcmd/podcmd.go#L53-L90

Known Issues（既知の問題）

なし

Urgent Upgrade Notes（必ず一読してからアップグレードしなければならない事項）

なし

Changes by Kind（種類別の変更）

Deprecation (廃止)

API Change (API 変更)

コネクションを維持するために SPDY pings が有効になり、kubectl exec と kubectl port-forward が中断されないようになりました (#97083, knight42) [SIG API Machinery and CLI]
- SPDY pings の間隔は 5s となっており変更できません

Feature（機能）

Bug or Regression（バグまたはリグレッション）

--dry-run=client で Deployment を公開（expose）する場合に Namespace の指定に効果がないバグが修正されました (#97492, masap) [SIG CLI]
KUBECTL_EXTERNAL_DIFF がイコール（=）を追加のパラメータとして受け入れるようになりました (#98158, dougsland) [SIG CLI]
- KUBECTL_EXTERNAL_DIFF 環境変数は kubectl diff コマンドで任意の diff コマンドとパラメータを使用できる機能ですが、これまでイコールを受け入れなかったため、KUBECTL_EXTERNAL_DIFF="diff --color=auto" のような指定ができなかったようです
kubectl describe: API Group なしの Ingress backend を含む場合にパニックになるバグが修正されました (#100505, lauchokyip) [SIG CLI]
kubectl kustomize {arg} と kubectl apply -k {arg} が kustomize CLI v4.0.5 のコードを使うように更新されました (#98946, monopole)
kubectl exec と kubectl attach は、リモートコマンド出力と混同される可能性のあるローカルバイナリからの出力を抑制する --quiet コマンドをサポートしました（全てのエラーでない出力が非表示）。加えて kubectl exec と attach でデフォルトのコンテナが使用された場合に、選択できるコンテナのリストが出力されるようになりました (#99004, smarterclayton) [SIG CLI]
client-go exec credential plugins は、stdin でインタラクティブターミナルが検出された場合にのみ stdin を通過させるようになりました。これは以前は "stdout" がインタラクティブターミナルかどうかを確認していたことの修正です。 (#99654, ankeesler)
Kubectl logs: --ignore-errors はすべてのコンテナで尊重されるようになり、parallelConsumeRequest の挙動と一貫性が保たれます (#97686, wzshiming)
Kubectl-convert: no kind "Ingress" is registered for version エラーが修正されました (#97754, wzshiming)

Other (そのほか)

なし

所感

ついに kubectl コマンドに組み込まれていた kustomize が更新されました。これはうれしいユーザが多いのではないかと思います。大きくバージョンに乖離があり、これまで使えていた kustomization.yaml が使えなくなっているので注意が必要です。個人的には kustomize は単体で使えるのだからビルトインしなくてよいのにという強い気持ちを持っています。

v1.21 でベータに昇格してデフォルトで有効化が予定されていた kubectl debug のデバッグコンテナ機能（Ephemeral Containers）は昇格が見送られました。SIG Auth が API の大幅な変更をリクエストしたためだそうです。とても強力な機能なため期待していましたが、次回に期待しましょう。なお、アルファレベルの機能として EphemeralContainers フィーチャゲートを有効にすることで使用することもできます。

Ephemeral Containers | Kubernetes

CHANGELOG でときどき SIG の指定のない変更があり、そこに SIG CLI の変更がちょくちょく含まれていて探すのが大変でした。これは困るので今後修正してもらいたい。SIG Release に言えばよいだろうか。