클러스터 생성 및 관리
클러스터 생성
클러스터는 Kubernetes Engine의 기본 리소스로, 컨테이너 애플리케이션을 포함한 모든 Kubernetes 객체가 이 클러스터에서 실행됩니다. 클 러스터는 콘솔에서 생성할 수 있으며, API를 호출하여 클러스터를 생성하는 방법은 지원 예정입니다.
Kubernetes Engine 서비스에서 클러스터를 생성하는 방법은 다음과 같습니다.
- Multi-AZ를 지원하는
kr-central-2
리전에서는 리전 내 여러 AZ(Availability Zone)에서 클러스터와 노드를 운영하여 가용성을 높일 수 있습니다. - 클러스터를 생성하기 위해서는 사전에 VPC와 Subnet이 설정되어 있어야 합니다. VPC와 Subnet이 설정되지 않은 경우 VPC 생성 및 관리를 참고하시기 바랍니다.
콘솔에서 클러스터 생성
카카오클라우드 콘솔에서 클러스터를 생성할 수 있습니다.
-
카카오클라우드 콘솔에서 Kubernetes Engine 메뉴를 선택합니다.
-
[시작하기] 버튼을 클릭하여 Kubernetes Engine 사용을 시작합니다.
- 서비스 사용을 시작하면 Kubernetes Engine의 리소스에 접근하기 위한 서비스 에이전트가 생성됩니다.
-
Cluster 탭에서 [클러스터 만들기] 버튼을 클릭합니다.
-
클러스터 만들기에서 정보를 입력하고, [만들기] 버튼을 클릭합니다.
구분 설명 기본 설정 클러스터의 기본 정보 설정
- 클러스터 이름: 클러스터의 이름을 입력
- 클러스터 설명(선택): 60자 이내로 클러스터 설명 작성
- Kubernetes 버전: 클러스터에서 사용할 Kubernetes 버전 선택
ㄴ Kubernetes Engine에서 제공하는 지원 버전에 대한 자세한 설명은 지원 정보를 참고클러스터 Network 설정 클러스터의 네트워크 설정
- VPC: 프로젝트에 공유된 VPC 중 클러스터를 배포할 VPC 선택
- Subnet: 프로젝트에 공유된 Subnet 중 클러스터를 배포할 Subnet 선택
ㄴ 노드 풀 생성 시, 클러스터 Network에서 설정한 Subnet 중 노드가 실행될 Subnet을 선택
ㄴ Multi-AZ를 지원하는 kr-central-2 리전에서는 노드 풀의 네트워크를 서로 다른 AZ의 Subnet으로 다중 선택하여 가용성을 높일 수 있음
ㄴ Multi-AZ 클러스터의 가용성을 높이기 위해, kr-central-2 리전의 각 AZ별 최소 1개 이상 Subnet 필수 선택 필요CNI Calico와 Cilium 중, 필요한 상황에 맞게 클러스터 에서 사용할 CNI 플러그인을 선택
- 서비스 IP CIDR 블록(선택): 클러스터의 서비스 객체가 수신할 IP를 지정
- 파드 IP CIDR 블록(선택): 파드가 수신할 IP를 지정
⚠️ 주의
서비스 IP와 파드 IP는 클러스터 생성 후에는 변경할 수 없습니다.
클러스터의 네트워크가 Private Subnet일 경우, Private Subnet의 노드는 인터넷 통신이 불가합니다. Private Subnet의 노드가 인터넷을 통해 외부 CR과 통신하기 위해서는 NAT 통신이 필요합니다.
NAT 통신은 NAT Instance를 사용할 수 있으며, 자세한 내용은 NAT 인스턴스 사용 문서를 참고하시기 바랍니다.
CNI의 서비스 IP와 파드 IP로 허용되는 조건은 아래와 같습니다.
- CIDR 형식으로 입력해야 하며, IPv4 RFC-1918로 규정된 사 설 네트워크 범위 내에 있어야 합니다.
- 서비스 IP의 최소 허용 크기는 /28이고, 최대 허용 크기는 /12입니다.
- 파드 IP의 최소 허용 크기는 /24이고, 최대 허용 크기는 /16입니다.
- 서비스 IP와 파드 IP는 서로 중첩될 수 없습니다.
- 클러스터 네트워크로 설정한 VPC 범위와 중첩될 수 없습니다.
- Kubernetes Engine 내부에서 사용 중인 198.18.0.0/16과 중첩될 수 없습니다.
- 서비스 IP와 파드 IP는 IPv4만 지원합니다.
API로 클러스터 생성
Kubernetes Engine API를 사용하여 클러스터를 생성하는 방식은 추후 지원 예정입니다.
클러스터 관리
Kubernetes Engine 서비스에서 클러스터를 관리하는 방법은 다음과 같습니다.
클러스터 목록 보기
현재 생성된 클러스터의 목록을 확인할 수 있습니다.
-
카카오클라우드 콘솔에서 Kubernetes Engine 메뉴를 선택합니다.
-
Cluster 탭에서 현재 생성된 클러스터를 확인합 니다.
구분 설명 클러스터 이름 클러스터의 이름 클러스터 상태 클러스터의 상태 정보
-Provisioned
: 클러스터 프로비저닝 완료
-Pending
: 클러스터 프로비저닝 준비 중
-Provisioning
: 클러스터 프로비저닝 중
-Deleting
: 클러스터 삭제 중
-Failed
: 사용자의 개입이 필요한 실패 상태Kubernetes 버전 클러스터의 Kubernetes 버전 정보 기능 [kubectl] 버튼 클릭 시 kubectl 제어 설정 가능 [더 보기] 아이콘 - 클러스터 설정: 클러스터의 이름, 생성일 설명 확인
- 자동 축소 설정: 자동 확장을 설정한 노드 풀의 자동 축소 조건 설정
- 클러스터 삭제: 해당 클러스터를 삭제
클러스터 설정 보기
클러스터의 이름, 생성일, 설명을 확인 및 수정할 수 있습니다.
-
카카오클라우드 콘솔에서 Kubernetes Engine 메뉴를 선택합니다.
-
Cluster 탭에서 설정할 클러스터의 [더 보기] 아이콘 > 클러스터 설정을 선택합니다.
-
클러스터 설정 팝업창에서 정보를 확인합니다. 설정 수정 시, 정보를 입력하고 [저장] 버튼을 클릭합니다.
구분 설명 클러스터 이름 현재 클러스터의 이름 클러스터 생성일 클러스터의 생성 날짜 클러스터 설명(선택) 클러스터 생성 시 작성한 설명
- 60자 이내로 클러스터 설명 수정 또는 작성 가능
클러스터 검색
클러스터 필터를 통해 클러스터를 검색할 수 있습니다.
- 카카오클라우드 콘솔에서 Kubernetes Engine 메뉴를 선택합니다.
- Cluster 탭의 클러스터 필터에서 검색할 클러스터를 입력합니다.
클러스터 상세 보기
클러스터의 세부 정보, 노드 풀, 노드 정보를 확인할 수 있습니다.
-
카카오클라우드 콘솔에서 Kubernetes Engine 메뉴를 선택합니다.
-
Cluster 탭에서 상세 정보를 확인할 클러스터를 선택합니다.
-
클러스터의 상세 페이지에서 정보를 확인합니다.
구분 설명 클러스터 상태 해당 클러스터의 상태 Kubernetes 버전