VPC 환경에서 이용 가능합니다.
Ncloud Kubernetes Service를 이용하면서 겪을 수 있는 문제 상황과 해결 방법을 안내합니다. 각 문제 상황을 클릭하면 관련 페이지로 이동합니다. ## 일반적인 문제 사용자가 겪을 수 있는 일반적인 문제 상황은 다음과 같습니다. [클러스터 상태 이상](/docs/k8s-troubleshoot-common#클러스터상태이상) Ncloud Kubernetes Service의 클러스터가 오랜 시간 동안 작업 중 상태로 유지됩니다. [클러스터 생성 이후 Cilium-Operator 파드가 Pending 상태](/docs/k8s-troubleshoot-common#클러스터생성이후CiliumOperator파드가Pending상태) Ncloud Kubernetes Service의 클러스터 생성 이후 Cilium-Operator 파드가 Pending 상태입니다. [워커노드가 Not Ready 상태](/docs/k8s-troubleshoot-common#워커노드가NotReady상태) Ncloud Kubernetes Service의 워커노드가 Not Ready 상태입니다. [Evict 상태의 파드 생성](/docs/k8s-troubleshoot-common#Evict상태의파드생성) Evict 상태를 가진 파드가 생성되었거나 생성되고 있습니다. [ncp-iam-authenticator를 통해 Kubernetes Cluster에 접근 불가](/docs/k8s-troubleshoot-common#ncpiamauthenticator를통해KubernetesCluster에접근불가) ncp-iam-authenticator를 통해 Kubernetes Cluster에 접근할 수 없습니다. [Kubernetes 대시보드 접근 오류](/docs/k8s-troubleshoot-common#Kubernetes대시보접근오류) 서브 계정으로 Kubernetes 대시보드 접근이 안 됩니다. Kubernetes 대시보드에 'Unauthorized'가 나타납니다. [PVC 사이즈 변경 불가](/docs/k8s-troubleshoot-common#PVC사이즈변경불가) PVC 사이즈 변경이 되지 않습니다. [StorageClass 설정 변경 불가](/docs/k8s-troubleshoot-common#StorageClass설정변경불가) StorageClass의 설정이 변경되지 않습니다. ## 배포 문제 사용자가 겪을 수 있는 배포 관련 문제는 다음과 같습니다. [파드 생성 시 ImagePullBackOff 상태 발생](/docs/k8s-troubleshoot-deploying#파드생성시ImagePullBackOff상태발생) 파드 생성 시 ImagePullBackOff 상태가 발생합니다. [특정 파드에서 간헐적으로 DNS 조회 실패 및 작업 지연](/docs/k8s-troubleshoot-deploying#특정파드에서간헐적으로DNS조회실패및작업지연) 특정 파드에서 간헐적으로 DNS 조회가 실패하거나 오랜 시간이 소요됩니다. ## 네트워킹 문제 사용자가 겪을 수 있는 네트워킹 관련 문제는 다음과 같습니다. [생성하지 않은 Target Group 존재](/docs/k8s-troubleshoot-lb#생성하지않은TargetGroup존재) 생성하지 않은 Target Group이 존재합니다. [NetworkPolicy 오류](/docs/k8s-troubleshoot-lb#NetworkPolicy오류) NetworkPolicy가 정상적으로 작동하지 않습니다. [Cilium의 Connectivity Test 실패](/docs/k8s-troubleshoot-lb#Cilium의ConnectivityTest실패) Cilium의 Connectivity Test에 실패합니다. [LoadBalancer 타입의 서비스 리소스 생성 이후 Pending 상태 지속](/docs/k8s-troubleshoot-lb#LoadBalancer타입의서비스리소스생성이후Pending상태지속) LoadBalancer 타입의 서비스 리소스 생성 이후 Pending 상태를 유지하고 있습니다. [Ingress와 연결된 ALB(ApplicationLoadBalancer) 오류](/docs/k8s-troubleshoot-lb#Ingress와연결된ALBApplicationLoadBalancer오류) Ingress와 연결된 ALB(ApplicationLoadBalancer)가 정상적으로 생성되지 않거나, 동작하지 않습니다. [커널 파라미터 변경 이후 클러스터에서 패킷 드랍 발생](/docs/k8s-troubleshoot-lb#커널파라미터변경이후클러스터에서패킷드랍발생) 커널 파라미터 변경 이후 클러스터에서 패킷 드랍이 발생합니다. [Ingress 인증서 변경 실패](/docs/k8s-troubleshoot-lb#Ingress인증서변경실패) Ingress 인증서가 변경되지 않습니다. Ingress의 인증서 변경에 실패합니다. [올바르지 않은 Client IP](/docs/k8s-troubleshoot-lb#올바르지않은ClientIP) Client IP가 올바르지 않습니다. 실제 사용자의 Client IP를 확인하고 싶습니다. [ALB 생성 시 타깃 그룹의 설정 변경](/docs/k8s-troubleshoot-lb#ALB생성시타그룹의설정변경) ALB 생성 시 타깃 그룹의 설정을 변경하고 싶습니다. [kube-proxy가 존재하지 않음](/docs/k8s-troubleshoot-lb#kubeproxy가존재하지않음) 클러스터에 kube-proxy가 존재하지 않습니다. ## 확장성 및 성능 문제 사용자가 겪을 수 있는 확장성 및 성능 관련 문제는 다음과 같습니다. [Cluster AutoScaler 설정 후에도 Scale Up/Down이 발생하지 않음](/docs/k8s-troubleshoot-performance#ClusterAutoscaler설정후에도ScaleInOut이발생하지않음) Cluster AutoScaler를 설정하였지만 Scale Up/Down이 발생하지 않습니다. [Cluster AutoScaler 사용 시 파라미터 변경 및 확인](/docs/k8s-troubleshoot-performance#ClusterAutoscaler사용시파라미터변경) Cluster AutoScaler 사용 시 파라미터를 변경하거나 확인하고 싶습니다. [Cluster AutoScaler 사용 시 특정 노드를 Scale Down 대상에서 제외](/docs/k8s-troubleshoot-performance#특정노드를ScaleDown대상에서제외) Cluster AutoScaler 사용 시 특정 노드를 Scale Down 대상에서 제외하고 싶습니다. [Cluster AutoScaler 사용 시 클러스터가 자동으로 확장](/docs/k8s-troubleshoot-performance#클러스터가자동으로확장) Cluster AutoScaler 사용 시 클러스터가 자동으로 확장되는 경우가 발생합니다. [Cluster AutoScaler 사용 시 전체 노드 수가 최대 노드 수 보다 작아도 신규 노드가 생성되지 않는 경우](/docs/k8s-troubleshoot-performance#전체노드수가최대노드수보다작아도신규노드가생성되지않는경우) Cluster AutoScaler 사용 시 전체 노드 수가 최대 노드 수 보다 작아도 신규 노드가 생성되지 않는 경우가 발생합니다. [워커노드의 높은 리소스 사용량](/docs/k8s-troubleshoot-performance#사용시워커노드의높은리소스사용량) 워커노드에서 높은 리소스 사용량이 나타나고 있습니다. ## 둘러볼 콘텐츠 네이버 클라우드 플랫폼에서는 고객에게 도움을 주기 위해 다양한 방식으로 정보를 제공하고 있습니다. Ncloud Kubernetes Service 이용 시 활용할 수 있는 유용한 콘텐츠를 안내합니다. * 자주 하는 질문: [Ncloud Kubernetes Service 자주 하는 질문](https://www.gov-ncloud.com/support/faq/prod?categoryCode2=CNTR&categoryCode3=SV_0137&page=1){target="_blank"} * 네이버 클라우드 플랫폼 블로그: [테라폼을 통해 Ncloud Kubernetes Service (NKS) 클러스터 구축하기](https://blog.naver.com/n_cloudplatform/223323963232?trackingCode=blog_bloghome_searchlist){target="_blank"} * 네이버 클라우드 플랫폼 블로그: [ncloud 컨테이너 레지스트리와 쿠버네티스 연동에 필요한 명령어(secret 생성 방법)](https://blog.naver.com/n_cloudplatform/222480533910?trackingCode=blog_bloghome_searchlist){target="_blank"} * Kubernetes AutoScaler Github: [AutoScaler FAQ](https://github.com/kubernetes/autoscaler/blob/master/cluster-autoscaler/FAQ.md){target="_blank"} * Kubernetes 문서 * [Getting started](https://kubernetes.io/docs/setup/){target="_blank"} * [CHANGELOG](https://github.com/kubernetes/kubernetes/tree/master/CHANGELOG){target="_blank"} * [Version Skew Policy](https://kubernetes.io/releases/version-skew-policy/){target="_blank"} * [Safely Drain a Node](https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/){target="_blank"} :::(Info) (참고) 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다. :::