[CKA] etcd의 역할과 명령

2024년 11월 19일

쿠버네티스 상태를 저장하는 etcd의 역할과 etcdctl v3 사용 시 확인할 항목을 정리합니다.

etcd는 Raft 합의를 사용하는 분산 키-값 저장소입니다. 쿠버네티스에서는 노드, 파드, 설정, Secret, 계정, Role과 Binding 등 API 객체의 상태를 저장합니다. 다른 구성 요소는 etcd에 직접 접근하지 않고 API 서버를 통해 상태를 읽고 씁니다.

etcdctl put key1 value1
etcdctl get key1

kubeadm으로 구성한 클러스터에서는 etcd가 컨트롤 플레인의 정적 파드로 실행될 수 있습니다. 외부 etcd 토폴로지도 가능하므로 실제 엔드포인트와 인증서 위치는 클러스터 구성을 확인해야 합니다.

etcdctl v3 명령을 사용할 때는 API 버전과 TLS 인증서 경로를 맞춥니다.

ETCDCTL_API=3 etcdctl snapshot save snapshot.db
ETCDCTL_API=3 etcdctl endpoint health
ETCDCTL_API=3 etcdctl get <key>
ETCDCTL_API=3 etcdctl put <key> <value>