Ncloud Kubernetes Service 문제 해결

Ncloud Kubernetes Service를 이용하면서 겪을 수 있는 문제 상황과 해결 방법을 안내합니다. 각 문제 상황을 클릭하면 관련 페이지로 이동합니다.

일반적인 문제

사용자가 겪을 수 있는 일반적인 문제 상황은 다음과 같습니다.

클러스터 상태 이상
Ncloud Kubernetes Service의 클러스터가 오랜 시간 동안 작업 중 상태로 유지됩니다.

클러스터 생성 이후 Cilium-Operator 파드가 Pending 상태
Ncloud Kubernetes Service의 클러스터 생성 이후 Cilium-Operator 파드가 Pending 상태입니다.

워커노드가 Not Ready 상태
Ncloud Kubernetes Service의 워커노드가 Not Ready 상태입니다.

Evict 상태의 파드 생성
Evict 상태를 가진 파드가 생성되었거나 생성되고 있습니다.

ncp-iam-authenticator를 통해 Kubernetes Cluster에 접근 불가
ncp-iam-authenticator를 통해 Kubernetes Cluster에 접근할 수 없습니다.

Kubernetes 대시보드 접근 오류
서브 계정으로 Kubernetes 대시보드 접근이 안 됩니다.
Kubernetes 대시보드에 'Unauthorized'가 나타납니다.

PVC 사이즈 변경 불가
PVC 사이즈 변경이 되지 않습니다.

StorageClass 설정 변경 불가
StorageClass의 설정이 변경되지 않습니다.

배포 문제

사용자가 겪을 수 있는 배포 관련 문제는 다음과 같습니다.

파드 생성 시 ImagePullBackOff 상태 발생
파드 생성 시 ImagePullBackOff 상태가 발생합니다.

특정 파드에서 간헐적으로 DNS 조회 실패 및 작업 지연
특정 파드에서 간헐적으로 DNS 조회가 실패하거나 오랜 시간이 소요됩니다.

네트워킹 문제

사용자가 겪을 수 있는 네트워킹 관련 문제는 다음과 같습니다.

생성하지 않은 Target Group 존재
생성하지 않은 Target Group이 존재합니다.

NetworkPolicy 오류
NetworkPolicy가 정상적으로 작동하지 않습니다.

Cilium의 Connectivity Test 실패
Cilium의 Connectivity Test에 실패합니다.

LoadBalancer 타입의 서비스 리소스 생성 이후 Pending 상태 지속
LoadBalancer 타입의 서비스 리소스 생성 이후 Pending 상태를 유지하고 있습니다.

Ingress와 연결된 ALB(ApplicationLoadBalancer) 오류
Ingress와 연결된 ALB(ApplicationLoadBalancer)가 정상적으로 생성되지 않거나, 동작하지 않습니다.

커널 파라미터 변경 이후 클러스터에서 패킷 드랍 발생
커널 파라미터 변경 이후 클러스터에서 패킷 드랍이 발생합니다.

Ingress 인증서 변경 실패
Ingress 인증서가 변경되지 않습니다.
Ingress의 인증서 변경에 실패합니다.

올바르지 않은 Client IP
Client IP가 올바르지 않습니다. 실제 사용자의 Client IP를 확인하고 싶습니다.

ALB 생성 시 타깃 그룹의 설정 변경
ALB 생성 시 타깃 그룹의 설정을 변경하고 싶습니다.

kube-proxy가 존재하지 않음
클러스터에 kube-proxy가 존재하지 않습니다.

확장성 및 성능 문제

사용자가 겪을 수 있는 확장성 및 성능 관련 문제는 다음과 같습니다.

Cluster AutoScaler 설정 후에도 Scale Up/Down이 발생하지 않음
Cluster AutoScaler를 설정하였지만 Scale Up/Down이 발생하지 않습니다.

Cluster AutoScaler 사용 시 파라미터 변경 및 확인
Cluster AutoScaler 사용 시 파라미터를 변경하거나 확인하고 싶습니다.

둘러볼 콘텐츠

네이버 클라우드 플랫폼에서는 고객에게 도움을 주기 위해 다양한 방식으로 정보를 제공하고 있습니다. Ncloud Kubernetes Service 이용 시 활용할 수 있는 유용한 콘텐츠를 안내합니다.

• 자주 하는 질문: Ncloud Kubernetes Service 자주 하는 질문
• 네이버 클라우드 플랫폼 블로그: 테라폼을 통해 Ncloud Kubernetes Service (NKS) 클러스터 구축하기
• 네이버 클라우드 플랫폼 블로그: ncloud 컨테이너 레지스트리와 쿠버네티스 연동에 필요한 명령어(secret 생성 방법)
• Kubernetes AutoScaler Github: AutoScaler FAQ
• Kubernetes 문서
  • Getting started
  • CHANGELOG
  • Version Skew Policy
  • Safely Drain a Node