Kubernetes マニフェストを理解する apiVersion

Kubernetes manifest の apiVersion をどう読むかを整理します。apiVersion は単なる固定文字列ではなく、作成するリソースの API グループとバージョンを指定する項目です。

参考
書籍

参考書籍

Kubernetes完全ガイド第2版

Kubernetes の仕組み、リソース、ネットワーク、運用観点を体系的に確認したい場合の参考書籍です。価格や在庫はリンク先で確認してください。

このリンクは Amazon アソシエイトリンクです。

最小 Manifest

kubectl apply -f - <<'EOF'
apiVersion: v1
kind: Pod
metadata:
  name: nginx-minimum
spec:
  containers:
    - name: nginx
      image: nginx:latest
EOF

apiVersion の読み方

例	意味
v1	core API group の v1
apps/v1	apps API group の v1
networking.k8s.io/v1	networking.k8s.io API group の v1

リソースから確認する

kubectl api-resources | head
kubectl api-resources | grep -E 'deployments|services|pods|ingresses'
kubectl api-versions | sort | head

Deployment の例

kubectl explain deployment.apiVersion
kubectl explain deployment.spec
kubectl explain pod.spec.containers

まとめ

apiVersion は、kind と組み合わせて Kubernetes API 上のリソース種別を特定します。迷った場合は既存サンプルを丸写しするのではなく、kubectl api-resources と kubectl explain で確認すると理解が進みます。

Kubernetes マニフェストを理解する apiVersion

Kubernetes マニフェストを理解する apiVersion

最小 Manifest

apiVersion の読み方

リソースから確認する

Deployment の例

まとめ

Related posts:

コメントを残す コメントをキャンセル

コメントを残すコメントをキャンセル