👥

[CKA] 45. API Groups

Date

2025/01/14

API Groups

쿠버네티스 API는 목적에 따라 여러 그룹으로 나뉘어 있으며, 각각의 그룹은 특정 기능을 제공한다.

•

/version - 클러스터의 버전을 조회

•

/healthz - 클러스터의 health를 모니터링

•

/metrics - 클러스터의 메트릭을 수집하고 확인

•

/logs - 서드파티 로깅 애플리케이션과 통합

API는 클러스터 기능을 책임지는 역할에 맞춰 두 가지로 분류할 수 있다: Core & Named

Core Group

코어 그룹에는 Kubernetes의 모든 핵심 기능이 포함되어 있다.

Named Group

명명 그룹은 더 조직화된 형태로 제공되며, 새로운 기능은 명명 그룹을 통해 제공된다. 각 API 그룹에는 여러 리소스가 있으며, 이러한 리소스에는 특정 작업을 수행할 수 있는 작업들이 연결되어 있다. 이러한 작업들을 Verbs라고 하며, Kubernetes API를 통해 리소스를 조작하는 데 사용된다.

예를 들어, 앱 그룹 내의 배포 리소스에 대한 Verbs는 다음과 같다:

•

list, get, create, delete, update, watch

API 그룹의 세부사항은 Kubernetes API Reference 페이지에서 확인할 수 있다.

Access API Server

클러스터의 API 서버에 접근하면 사용 가능한 API 그룹 리스트를 얻을 수 있다

curl https://localhost:6443 -k

{
	"path": [
		"/api",
		"/api/v1",
		"/apis",
		"/apis/",
		"/healthz",
		...
}
Bash
복사

Named API Group 내에서 지원되는 모든 리소스 그룹을 확인할 수도 있다.

curl https://localhost:6443/apis -k | grep "name"

{
	...
			"name": "extensions",
			"name": "apps",
			"name": "events.k8s.io",
			"name": "authentication.k8s.io",
			"name": "authorization.k8s.io",
	...
}
Bash
복사

With Certificates

이때 curl을 통한 API에 대한 직접적인 액세스는 apiVersion 같은 특정 API를 제외하곤 액세스되지 않는다. 인증서 파일을 통해 API에 대한 인증을 거쳐야 액세스가 가능하다.

curl https://localhost:6443 -k \
 --key admin.key --cert admin.crt --cacert ca.crt
Bash
복사

kubectl proxy

다른 방법은 kubectl proxy client를 시작하는 것이다. kubectl proxy 명령은 로컬에서 8001 포트에 프록시 서비스를 시작하며, kubeconfig 파일의 자격 증명과 인증서를 사용하여 클러스터에 접근한다. 이를 통해 curl 명령에서 인증서를 지정할 필요가 없다.

# kubectl proxy client 시작
$ kubectl proxy
Starting to serve on 127.0.0.1:8001

# 인증서 명시할 필요 없이 액세스 가능
$ curl https://localhost:6443 -k
{
	"path": [
		"/api",
		"/api/v1",
		"/apis",
		"/apis/",
		"/healthz",
		...
}
Bash
복사

참고: kube proxy ≠ kubectl proxy

•

kube proxy: 클러스터 Pod와 Service 간의 네트워크 트래픽을 관리하는 Component

•

kubectl proxy: HTTP Proxy 서비스로, kubectl 이 kube-apiserver에 접근 가능하게 함

Summary

Kubernetes는 리소스를 효율적으로 관리하기 위해 다양한 API 그룹으로 리소스를 분류한다.

API Group

•

Core API Group: Kubernetes의 기본 리소스 포함

•

Named API Group: 특정 기능이나 서비스에 맞춰 구성된 리소스 포함

Resources & Verbs

API Group 내에는 다양한 리소스가 존재하며, 각 리소스는 CRUD 작업을 포함한 여러 동작(Verbs)을 수행할 수 있다.