쿠버네티스(Kubernetes)는 컨테이너 오케스트레이션 시스템으로, 클러스터 내의 리소스를 관리하고 조정하는 데 사용됩니다. 쿠버네티스 클러스터와 상호작용하기 위해서는 API(Application Programming Interface)를 이해하는 것이 중요합니다. API는 다양한 기능을 제공하며, 리소스를 생성하고 관리할 수 있는 인터페이스를 제공합니다.
쿠버네티스 API 그룹
쿠버네티스 API는 여러 그룹으로 구성되어 있습니다. 각 그룹은 특정 기능이나 목적에 따라 구성되어 있으며, 쿠버네티스의 다양한 측면을 다룹니다. 주요 API 그룹에는 core 그룹과 named 그룹이 있습니다.
- Core 그룹: 이 그룹에는 네임스페이스, 파드, 이벤트, 엔드포인트, 노드, 바인딩, PV, PVC, Configmap, Secret, Service 등과 같은 모든 핵심 기능이 포함됩니다. 기본적인 쿠버네티스 리소스를 관리하기 위해 필수적인 API 그룹입니다.
- Named 그룹: Named 그룹은 보다 구체적이고 정리된 API를 제공합니다. 애플리케이션, 확장, 네트워킹, 스토리지, 인증, 권한 부여, 인증서 등과 같은 다양한 하위 그룹을 포함하며, 새로운 기능들은 이 그룹에 추가됩니다.
API 접근 방법
쿠버네티스 API는 RESTful API로서, HTTP를 통해 접근할 수 있습니다. 예를 들어, 파드 목록을 가져오기 위해선 api/v1/pods와 같은 URL을 사용할 수 있습니다. 각 리소스는 일련의 동작(verbs)을 지원하며, 이를 통해 리소스를 생성, 업데이트, 삭제, 모니터링 등을 수행할 수 있습니다.
API 접근 방법과 도구
쿠버네티스 API에 접근하는 방법에는 여러 가지가 있습니다:
- kubectl 유틸리티: 가장 일반적이고 편리한 방법으로, kubectl을 통해 쿠버네티스 클러스터와 상호작용할 수 있습니다.
- curl을 통한 직접 접근: curl을 사용하여 직접 API에 접근할 수도 있지만, 인증이 필요한 경우에는 적절한 인증서나 토큰을 제공해야 합니다.
- kubectl proxy: 로컬에서 프록시 서비스를 실행하여 API에 접근하는 방법으로, kubeconfig 파일을 사용하여 인증을 관리할 수 있습니다.
마무리
쿠버네티스의 API는 클러스터를 관리하고 모니터링하기 위한 필수적인 도구입니다. API 그룹은 기능에 따라 분류되어 있으며, 각 그룹은 다양한 리소스와 그에 따른 동작을 제공합니다. 이를 통해 쿠버네티스를 유연하게 사용하고, 개발자는 필요에 따라 다양한 리소스를 조작할 수 있습니다.
