VPC 환경에서 이용 가능합니다.
Add-on 설치 및 관리
Add-on을 설치하고, 설정과 버전을 변경하며, 삭제하는 방법을 설명합니다.
클러스터 생성 시 함께 설치
클러스터를 생성할 때 [Add-on] 탭 메뉴에서 설치할 Add-on을 함께 지정합니다. 지정한 Add-on은 클러스터가 생성되는 과정에서 함께 설치됩니다. 클러스터 생성 전체 절차는 Ncloud Kubernetes Service 시작을 참고해 주십시오.
지정하는 항목은 다음과 같습니다.
- Add-on 선택: 여러 Add-on을 한 번에 지정해 함께 설치합니다.
- 버전 선택: Add-on별로 설치할 버전을 지정합니다.
- 설정값 입력: Add-on별로 정의된 설정값을 입력합니다. 입력하지 않으면 기본값으로 설치됩니다.
운영 중 Add-on 설치
운영 중인 클러스터에 설치되지 않은 Add-on을 추가합니다. 이미 설치된 Add-on은 설치 대상에서 제외됩니다.
운영 중인 클러스터에 Add-on을 설치하는 방법은 다음과 같습니다.
- 클러스터 상세의 [Add-on] 탭 메뉴를 클릭해 주십시오.
- [Add-on 가져오기] 버튼을 클릭해 주십시오.
- 설치할 Add-on을 클릭하여 선택해 주십시오.
- 설치할 버전을 클릭하여 선택해 주십시오.
- 설정값을 입력해 주십시오. 설정값을 입력하지 않으면 기본값으로 설치됩니다.
- 충돌 관리 방식을 클릭하여 선택해 주십시오. 자세한 내용은 충돌 관리를 참고해 주십시오.
- [확인] 버튼을 클릭해 주십시오. 설치가 시작됩니다.
충돌 관리
Add-on은 기본 설정값에 사용자가 입력한 설정값을 반영해 최종 구성을 만들고, 이를 클러스터에 적용합니다. 입력하지 않은 항목은 기본 설정값을 사용합니다. 설정값을 입력해 구성을 바꾸는 것은 충돌이 아니며, 충돌은
사용자가 클러스터에서 직접(예: kubectl edit) 수정해 둔 필드에만 발생합니다. 직접 수정한 필드가 없으면 어느 방식을 선택해도 결과는 같습니다.
| 방식 | 설명 |
|---|---|
| 덮어쓰기(기본) | 사용자가 직접 수정한 필드가 있어도 최종 구성 값으로 덮어씁니다. 충돌로 작업이 실패하지 않습니다. |
| 보존 | 사용자가 직접 수정한 필드는 그대로 두고, 나머지만 최종 구성 값으로 갱신합니다. 직접 수정한 값이 이 값과 충돌하면 작업이 실패할 수 있습니다. |
설정 변경 및 버전 업그레이드
설치된 Add-on의 버전과 설정값을 변경합니다. 편집 화면은 현재 설정값이 입력된 상태로 열립니다.
설치된 Add-on을 편집하는 방법은 다음과 같습니다.
- 클러스터 상세의 [Add-on] 탭 메뉴를 클릭해 주십시오.
- 편집할 Add-on에서 [편집] 버튼을 클릭해 주십시오.
- 필요한 경우 버전을 변경해 주십시오. 버전은 클러스터와 호환되는 범위에서 클릭하여 선택할 수 있습니다.
- 필요한 경우 설정값을 수정해 주십시오.
- 충돌 관리 방식을 클릭하여 선택해 주십시오. 판정 기준과 동작은 충돌 관리와 같습니다.
- [확인] 버튼을 클릭해 주십시오. 변경이 적용됩니다.
변경 사항이 거부되거나 검증에 실패하면, 직전 정상 상태(버전 및 설정값)로 자동 복원을 시도합니다. 단, 적용은 완료되었으나 이후 런타임이 비정상인 경우(예: 컨테이너 재시작 반복)는 자동 복원 대상이 아닙니다.
Add-on 삭제
설치된 Add-on을 클러스터에서 제거합니다.
설치된 Add-on을 삭제하는 방법은 다음과 같습니다.
- 클러스터 상세의 [Add-on] 탭 메뉴를 클릭해 주십시오.
- 삭제할 Add-on에서 [삭제] 버튼을 클릭해 주십시오.
- 확인 창의 내용을 확인한 다음 삭제를 진행해 주십시오. 삭제가 시작됩니다.
삭제하면 Add-on을 통해 설치된 리소스가 제거됩니다. 삭제 전에 Add-on 리소스에 의존하는 워크로드가 클러스터에 남아 있지 않은지 확인해 주십시오. 단, 사용자 데이터가 남아 있는 리소스(예: 사용 중인 볼륨 스냅샷)는 보호를 위해 보존될 수 있으며, 보존된 리소스는 필요할 때 직접 정리해 주십시오.
작업 실패 시 확인
작업이 실패하면 Add-on의 상태가 실패로 표시되고, 작업 결과 메시지에 원인이 표시됩니다. 메시지를 확인해 설정값이나 버전, 충돌 관리 방식을 조정한 다음 다시 시도해 주십시오.