API endpoint 버저닝

API Discovery
A list of all group versions supported by a cluster is published at the /api and /apis endpoints. Each group version also advertises the list of resources supported via /apis// (for example: /apis/rbac.authorization.k8s.io/v1alpha1). These endpoints are used by kubectl to fetch the list of resources supported by a cluster.

클러스터에서 지원하는 모든 그룹 버전 목록은 /api및 /apis엔드포인트에 게시됩니다. 각 그룹 버전은 또한 /apis//(예: ) 을 통해 지원되는 리소스 목록을 광고합니다 /apis/rbac.authorization.k8s.io/v1alpha1. 이러한 엔드포인트는 kubectl이 클러스터에서 지원하는 리소스 목록을 가져오는 데 사용됩니다.

아래 순서가 일반적

• Name
• Cluster or namespaced scope
• Endpoint URL and supported verbs
• Alternative names
• Group, version, kind

최근 회사에서 사용중인 api

• endpoint/v1/api

위와같은 형식으로 되어있다보니, 프레임워크(nest) 수준에서 버전관리하기가 어려워지는 부분이 있음. api/v1 처럼 사용하는 경우가 일반적이기도 함

출처: https://kubernetes.io/docs/concepts/overview/kubernetes-api/