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

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

この記事の位置づけ

この記事は、Kubernetes マニフェストで指定する apiVersion の意味を整理する記事です。単なる書式ではなく、リソース種別、API グループ、クラスタのバージョン差を読むための基礎として扱います。

apiVersion: v1
kind: Pod
metadata:
  name: nginx-minimum
spec:
  containers:
    - name: nginx
      image: nginx:latest

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

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

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

参考
書籍

参考書籍

Kubernetes完全ガイド第2版

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

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

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