How-to guides

사용자는 Samsung Cloud Platform Console을 통해 Kubernetes Engine의 필수 정보를 입력하고, 상세 옵션을 선택하여 서비스를 생성할 수 있습니다.

Kubernetes Engine 생성하기

Samsung Cloud Platform Console에서 Kubernetes Engine 서비스를 생성하여 사용할 수 있습니다.

Kubernetes Engine 서비스 이용을 위해 클러스터를 생성하고 관리할 수 있습니다. 클러스터 생성 후 노드, 네임스페이스, 워크로드 등 운영에 필요한 서비스를 추가할 수 있습니다.

클러스터 생성하기

Samsung Cloud Platform Console에서 Kubernetes Engine 클러스터 서비스를 생성하여 사용할 수 있습니다.

Kubernetes Engine 클러스터를 생성하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engine의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 생성 버튼을 클릭하세요. 클러스터 생성 페이지로 이동합니다.
3. 클러스터 생성 페이지에서 서비스 생성에 필요한 정보들을 입력하고, 상세 옵션을 선택하세요.
   • 서비스 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

• 추가 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

  구분	필수 여부	상세 설명
  태그	선택	태그 추가 자원 당 최대 50개까지 추가 가능 태그 추가 버튼을 클릭한 후 Key, Value 값을 입력 또는 선택

  표. Kubernetes Engine 추가 정보 입력 항목

4. 요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 생성 버튼을 클릭하세요.
   • 생성이 완료되면, 클러스터 목록 페이지에서 생성한 자원을 확인하세요.

클러스터 상세 정보 확인하기

Kubernetes Engine 서비스는 전체 자원 목록과 상세 정보를 확인하고 수정할 수 있습니다. 클러스터 상세 페이지에서는 상세 정보, 노드 풀, 태그, 작업 이력 탭으로 구성되어 있습니다.

클러스터 상세 정보를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engine의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 상세 정보를 확인할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
   • 클러스터 상세 페이지에는 클러스터의 상태 정보 및 상세 정보가 표시되며, 상세 정보, 노드 풀, 태그, 작업 이력 탭으로 구성됩니다.

     구분	상세 설명
     클러스터 상태	Kubernetes Engine 클러스터의 상태 Creating: 생성 중 Running: 생성 완료/작동 중 Updating: 버전 업그레이드 중 Deleting: 삭제 중 Error: 에러 발생
     서비스 해지	Kubernetes Engine 클러스터를 해지하는 버튼 Kubernetes Engine 서비스를 해지하려면 클러스터에 추가된 노드 풀을 모두 삭제해야 함 서비스를 해지하면 운영 중인 서비스가 즉시 중단될 수 있으므로, 서비스 중단에 따른 영향을 고려하여 해지 필요 Deletion Protection을 사용 중인 클러스터는 해지할 수 없으며, 클릭 시 알림 팝업이 표시됨. 해지하려면 먼저 Deletion Protection 사용을 해제해야 함

     표. 클러스터 상태 정보 및 부가 기능

상세 정보

클러스터 목록 페이지에서 선택한 자원의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

노드 풀

클러스터 노드 풀 정보를 확인하고 추가하거나 변경, 삭제할 수 있습니다. 노드 풀 사용에 대한 자세한 내용은 노드 관리하기를 참고하세요.

태그

클러스터 목록 페이지에서 선택한 자원의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

작업 이력

클러스터 목록 페이지에서 선택한 자원의 작업 이력을 확인할 수 있습니다.

클러스터 자원 관리하기

클러스터 자원 관리를 위해서 클러스터 버전 업그레이드, kubeconfig 다운로드, 제어 영역 로깅 수정 기능 등을 제공하고 있습니다.

클러스터 버전 업그레이드

클러스터의 쿠버네티스 버전에서 업그레이드할 수 있는 버전이 있는 경우, 클러스터 상세 페이지에서 업그레이드를 수행할 수 있습니다.

클러스터 버전 업그레이드 사전 준비

클러스터 버전 업그레이드 시 API 객체를 삭제하고 다시 만들 필요는 없습니다. 전환된 API에 대해 모든 기존 API 객체는 새로운 API버전을 사용하여 읽고 업데이트할 수 있습니다. 하지만 구 버전 쿠버네티스의 Deprecated API로 인해 기존 객체를 읽고 수정하지 못하거나 새 객체를 만들지 못할 수 있습니다. 따라서, 시스템 안정성을 위해 업그레이드 전에 클라이언트와 매니페스트를 마이그레이션하는 것을 권장합니다.

다음 방법으로 클라이언트와 매니페스트를 마이그레이션 하세요.

• 새 버전의 클라이언트(kubectl 등)를 다운로드하여 클러스터에 설치하고, 새로운 API를 참고하도록 Yaml을 수정합니다.
• 또는 별도의 플러그인(kubectl convert)을 사용해 자동으로 변환해주세요. 자세한 설명은 쿠버네티스 공식 문서 > 리눅스에 kubectl 설치 및 설정을 참고하세요.

클러스터 및 노드 풀 버전 업그레이드하기

클러스터 및 노드 풀을 업데이트 하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 버전 업그레이드할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 Kubernetes 버전의 수정 아이콘을 클릭하세요. 클러스터 버전 업그레이드 팝업창이 열립니다.
5. 업그레이드할 Kubernetes 버전을 선택하고, 확인 버튼을 클릭하세요.
   • 클러스터 업그레이드가 완료될 때까지 몇 분 정도 소요될 수 있습니다
   • 업그레이드가 진행되는 동안 클러스터의 상태는 Updating으로 표시되며, 업그레이드가 완료되면 Running으로 표시됩니다.
6. 업그레이드가 완료되면 노드 풀 탭을 선택하세요. 노드 풀 페이지로 이동합니다.
7. 노드 풀 항목의 더보기 버튼을 클릭하여 업그레이드를 클릭하세요. 노드 풀 버전 업그레이드 팝업창이 열립니다.
8. 노드 풀 버전 업그레이드 팝업창에서 메시지를 확인한 후 확인 버튼을 클릭하세요.
   • 노드 풀 업그레이드가 완료될 때까지 몇 분 정도 소요될 수 있습니다.
   • 업그레이드가 진행되는 동안 노드 풀의 상태는 Updating으로 표시되며, 업그레이드가 완료되면 Running으로 표시됩니다.

kubeconfig 다운로드

클러스터의 퍼블릭 엔드포인트와 프라이빗 엔드포인트의 관리자/사용자 kubeconfig 설정값을 yaml 문서로 다운로드할 수 있습니다.

클러스터의 kubeconfig 설정값을 다운로드하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 kubeconfig 다운로드할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 원하는 엔드포인트의 관리자 kubeconfig 다운로드/사용자 kubeconfig 다운로드 버튼을 클릭하세요.
   • 각 권한별로 kubeconfig 파일을 yaml 형식으로 다운로드할 수 있습니다.

프라이빗 엔드포인트 접근 허용 자원 수정하기

클러스터의 프라이빗 엔드포인트 접근 허용 자원 설정을 변경할 수 있습니다.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 프라이빗 엔드포인트 접근 제어를 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 프라이빗 엔드포인트 접근 허용 자원의 수정 아이콘을 클릭하세요. 프라이빗 엔드포인트 접근 허용 자원 수정 팝업창이 열립니다.
5. 프라이빗 엔드포인트 접근 허용 자원 수정 팝업창에서 프라이빗 엔드포인트 접근 허용 자원의 사용 여부를 설정하고 접근 허용 자원을 추가한 후, 확인 버튼을 클릭하세요.

퍼블릭 엔드포인트 수정하기

클러스터의 퍼블릭 엔드포인트 설정을 변경할 수 있습니다.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 퍼블릭 엔드포인트 접근 제어를 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 퍼블릭 엔드포인트의 수정 아이콘을 클릭하세요. 퍼블릭 엔드포인트 수정 팝업창이 열립니다.
5. 퍼블릭 엔드포인트 수정 팝업창에서 퍼블릭 엔드포인트의 사용 여부를 설정하고 접근 허용 IP 범위를 추가한 후, 확인 버튼을 클릭하세요.

제어 영역 로그 수집 설정 수정하기

클러스터의 제어 영역(Control Plane)의 로그 수집 설정을 변경할 수 있습니다. 클러스터의 상세 로그는 ServiceWatch 서비스에서 확인할 수 있습니다.

클러스터의 제어 영역 로그 수집 설정을 변경하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 제어 영역 로깅을 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 ServiceWatch 로그 수집의 수정 아이콘을 클릭하세요. ServiceWatch 로그 수집 팝업창이 열립니다.
5. ServiceWatch 로그 수집 팝업창에서 ServiceWatch 로그 수정의 사용 여부를 설정한 후, 확인 버튼을 클릭하세요.

Deletion Protection 수정하기

클러스터가 실수로 삭제되는 것을 방지하기 위해 클러스터의 Deletion Protection(삭제 방지) 사용 여부를 변경할 수 있습니다.

클러스터의 Deletion Protection 설정을 변경하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engine의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 Deletion Protection을 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지의 제어 영역 설정 영역에서 Deletion Protection의 수정 아이콘을 클릭하세요. Deletion Protection 수정 팝업창이 열립니다.
5. Deletion Protection 수정 팝업창에서 Deletion Protection의 사용 여부를 설정한 후, 확인 버튼을 클릭하세요.
   • 현재 설정된 값과 동일한 값을 선택한 경우에는 확인 버튼이 활성화되지 않습니다.

Security Group 수정하기

클러스터의 Security Group을 수정할 수 있습니다.

클러스터의 Security Group을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 Security Group을 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 Security Group의 수정 아이콘을 클릭하세요. Security Group 수정 팝업창이 열립니다.
5. 수정할 Security Group을 선택 또는 선택 해제한 후, 확인 버튼을 클릭하세요.

추가 Subnet 수정하기

클러스터에 연결한 추가 Subnet을 수정할 수 있습니다.

클러스터의 추가 Subnet을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engine의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 추가 Subnet을 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 추가 Subnet의 수정 아이콘을 클릭하세요. 추가 Subnet 수정 팝업창이 열립니다.
5. 추가할 Subnet을 선택하거나 사용하지 않는 추가 Subnet을 선택 해제한 후, 확인 버튼을 클릭하세요.

NFS 볼륨 수정하기

클러스터의 NFS 볼륨을 수정할 수 있습니다.

클러스터의 NFS 볼륨을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 NFS 볼륨을 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 NFS 볼륨의 수정 아이콘을 클릭하세요. NFS 볼륨 수정 팝업창이 열립니다.
5. NFS 볼륨의 사용 여부를 선택하고 목록에서 사용할 NFS 볼륨을 선택한 후, 확인 버튼을 클릭하세요.

클러스터 연결 자원 수정하기

클러스터 연결 자원을 수정할 수 있습니다.

클러스터 연결 자원을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 연결 자원을 수정할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 클러스터 연결 자원의 수정 아이콘을 클릭하세요. 클러스터 연결 자원 수정 팝업창이 열립니다.
5. 수정할 연결 자원을 선택 또는 선택 해제한 후, 확인 버튼을 클릭하세요.

클러스터 해지하기

클러스터를 해지하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Kubernetes Engine 메뉴를 클릭하세요. Kubernetes Engines의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 클러스터 메뉴를 클릭하세요. 클러스터 목록 페이지로 이동합니다.
3. 클러스터 목록 페이지에서 상세 정보를 확인할 자원(클러스터)을 클릭하세요. 클러스터 상세 페이지로 이동합니다.
4. 클러스터 상세 페이지에서 서비스 해지를 클릭하세요.
   • Deletion Protection을 사용 중인 클러스터는 알림 팝업이 표시되며 해지할 수 없습니다. Deletion Protection 사용을 해제한 후 다시 시도하세요.
5. 서비스 해지 팝업창에서 내용을 확인한 후, 확인 버튼을 클릭하세요.