--- title: "Ncloud Kubernetes Service 문제 해결" slug: "k8s-troubleshoot" updated: 2026-09-17T09:02:19Z published: 2026-09-17T09:09:41Z canonical: "guide-fin.ncloud-docs.com/k8s-troubleshoot" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Ncloud Kubernetes Service 문제 해결 Ncloud Kubernetes Service를 이용하면서 겪을 수 있는 문제 상황과 해결 방법을 안내합니다. 각 문제 상황을 클릭하면 관련 페이지로 이동합니다. ## 일반적인 문제 사용자가 겪을 수 있는 일반적인 문제 상황은 다음과 같습니다. [클러스터 상태 이상](/docs/k8s-troubleshoot-common#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EC%83%81%ED%83%9C%EC%9D%B4%EC%83%81) Ncloud Kubernetes Service의 클러스터가 오랜 시간 동안 작업 중 상태로 유지됩니다. [클러스터 생성 이후 Cilium-Operator 파드가 Pending 상태](/docs/k8s-troubleshoot-common#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EC%83%9D%EC%84%B1%EC%9D%B4%ED%9B%84CiliumOperator%ED%8C%8C%EB%93%9C%EA%B0%80Pending%EC%83%81%ED%83%9C) Ncloud Kubernetes Service의 클러스터 생성 이후 Cilium-Operator 파드가 Pending 상태입니다. [워커노드가 Not Ready 상태](/docs/k8s-troubleshoot-common#%EC%9B%8C%EC%BB%A4%EB%85%B8%EB%93%9C%EA%B0%80NotReady%EC%83%81%ED%83%9C) Ncloud Kubernetes Service의 워커노드가 Not Ready 상태입니다. [Evict 상태의 파드 생성](/docs/k8s-troubleshoot-common#Evict%EC%83%81%ED%83%9C%EC%9D%98%ED%8C%8C%EB%93%9C%EC%83%9D%EC%84%B1) Evict 상태를 가진 파드가 생성되었거나 생성되고 있습니다. [ncp-iam-authenticator를 통해 Kubernetes Cluster에 접근 불가](/docs/k8s-troubleshoot-common#ncpiamauthenticator%EB%A5%BC%ED%86%B5%ED%95%B4KubernetesCluster%EC%97%90%EC%A0%91%EA%B7%BC%EB%B6%88%EA%B0%80) ncp-iam-authenticator를 통해 Kubernetes Cluster에 접근할 수 없습니다. [Kubernetes 대시보드 접근 오류](/docs/k8s-troubleshoot-common#Kubernetes%EB%8C%80%EC%8B%9C%EB%B3%B4%EC%A0%91%EA%B7%BC%EC%98%A4%EB%A5%98) 서브 계정으로 Kubernetes 대시보드 접근이 안 됩니다. Kubernetes 대시보드에 'Unauthorized'가 나타납니다. [PVC 사이즈 변경 불가](/docs/k8s-troubleshoot-common#PVC%EC%82%AC%EC%9D%B4%EC%A6%88%EB%B3%80%EA%B2%BD%EB%B6%88%EA%B0%80) PVC 사이즈 변경이 되지 않습니다. [StorageClass 설정 변경 불가](/docs/k8s-troubleshoot-common#StorageClass%EC%84%A4%EC%A0%95%EB%B3%80%EA%B2%BD%EB%B6%88%EA%B0%80) StorageClass의 설정이 변경되지 않습니다. ## 배포 문제 사용자가 겪을 수 있는 배포 관련 문제는 다음과 같습니다. [파드 생성 시 ImagePullBackOff 상태 발생](/docs/k8s-troubleshoot-deploying#%ED%8C%8C%EB%93%9C%EC%83%9D%EC%84%B1%EC%8B%9CImagePullBackOff%EC%83%81%ED%83%9C%EB%B0%9C%EC%83%9D) 파드 생성 시 ImagePullBackOff 상태가 발생합니다. [특정 파드에서 간헐적으로 DNS 조회 실패 및 작업 지연](/docs/k8s-troubleshoot-deploying#%ED%8A%B9%EC%A0%95%ED%8C%8C%EB%93%9C%EC%97%90%EC%84%9C%EA%B0%84%ED%97%90%EC%A0%81%EC%9C%BC%EB%A1%9CDNS%EC%A1%B0%ED%9A%8C%EC%8B%A4%ED%8C%A8%EB%B0%8F%EC%9E%91%EC%97%85%EC%A7%80%EC%97%B0) 특정 파드에서 간헐적으로 DNS 조회가 실패하거나 오랜 시간이 소요됩니다. ## 네트워킹 문제 사용자가 겪을 수 있는 네트워킹 관련 문제는 다음과 같습니다. [생성하지 않은 Target Group 존재](/docs/k8s-troubleshoot-lb#%EC%83%9D%EC%84%B1%ED%95%98%EC%A7%80%EC%95%8A%EC%9D%80TargetGroup%EC%A1%B4%EC%9E%AC) 생성하지 않은 Target Group이 존재합니다. [NetworkPolicy 오류](/docs/k8s-troubleshoot-lb#NetworkPolicy%EC%98%A4%EB%A5%98) NetworkPolicy가 정상적으로 작동하지 않습니다. [Cilium의 Connectivity Test 실패](/docs/k8s-troubleshoot-lb#Cilium%EC%9D%98ConnectivityTest%EC%8B%A4%ED%8C%A8) Cilium의 Connectivity Test에 실패합니다. [LoadBalancer 타입의 서비스 리소스 생성 이후 Pending 상태 지속](/docs/k8s-troubleshoot-lb#LoadBalancer%ED%83%80%EC%9E%85%EC%9D%98%EC%84%9C%EB%B9%84%EC%8A%A4%EB%A6%AC%EC%86%8C%EC%8A%A4%EC%83%9D%EC%84%B1%EC%9D%B4%ED%9B%84Pending%EC%83%81%ED%83%9C%EC%A7%80%EC%86%8D) LoadBalancer 타입의 서비스 리소스 생성 이후 Pending 상태를 유지하고 있습니다. [Ingress와 연결된 ALB(ApplicationLoadBalancer) 오류](/docs/k8s-troubleshoot-lb#Ingress%EC%99%80%EC%97%B0%EA%B2%B0%EB%90%9CALBApplicationLoadBalancer%EC%98%A4%EB%A5%98) Ingress와 연결된 ALB(ApplicationLoadBalancer)가 정상적으로 생성되지 않거나, 동작하지 않습니다. [커널 파라미터 변경 이후 클러스터에서 패킷 드랍 발생](/docs/k8s-troubleshoot-lb#%EC%BB%A4%EB%84%90%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0%EB%B3%80%EA%B2%BD%EC%9D%B4%ED%9B%84%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EC%97%90%EC%84%9C%ED%8C%A8%ED%82%B7%EB%93%9C%EB%9E%8D%EB%B0%9C%EC%83%9D) 커널 파라미터 변경 이후 클러스터에서 패킷 드랍이 발생합니다. [Ingress 인증서 변경 실패](/docs/k8s-troubleshoot-lb#Ingress%EC%9D%B8%EC%A6%9D%EC%84%9C%EB%B3%80%EA%B2%BD%EC%8B%A4%ED%8C%A8) Ingress 인증서가 변경되지 않습니다. Ingress의 인증서 변경에 실패합니다. [올바르지 않은 Client IP](/docs/k8s-troubleshoot-lb#%EC%98%AC%EB%B0%94%EB%A5%B4%EC%A7%80%EC%95%8A%EC%9D%80ClientIP) Client IP가 올바르지 않습니다. 실제 사용자의 Client IP를 확인하고 싶습니다. [ALB 생성 시 타깃 그룹의 설정 변경](/docs/k8s-troubleshoot-lb#ALB%EC%83%9D%EC%84%B1%EC%8B%9C%ED%83%80%EA%B7%B8%EB%A3%B9%EC%9D%98%EC%84%A4%EC%A0%95%EB%B3%80%EA%B2%BD) ALB 생성 시 타깃 그룹의 설정을 변경하고 싶습니다. [kube-proxy가 존재하지 않음](/docs/k8s-troubleshoot-lb#kubeproxy%EA%B0%80%EC%A1%B4%EC%9E%AC%ED%95%98%EC%A7%80%EC%95%8A%EC%9D%8C) 클러스터에 kube-proxy가 존재하지 않습니다. ## 확장성 및 성능 문제 사용자가 겪을 수 있는 확장성 및 성능 관련 문제는 다음과 같습니다. [Cluster AutoScaler 설정 후에도 Scale Up/Down이 발생하지 않음](/docs/k8s-troubleshoot-performance#ClusterAutoscaler%EC%84%A4%EC%A0%95%ED%9B%84%EC%97%90%EB%8F%84ScaleInOut%EC%9D%B4%EB%B0%9C%EC%83%9D%ED%95%98%EC%A7%80%EC%95%8A%EC%9D%8C) Cluster AutoScaler를 설정하였지만 Scale Up/Down이 발생하지 않습니다. [Cluster AutoScaler 사용 시 파라미터 변경 및 확인](/docs/k8s-troubleshoot-performance#ClusterAutoscaler%EC%82%AC%EC%9A%A9%EC%8B%9C%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0%EB%B3%80%EA%B2%BD) Cluster AutoScaler 사용 시 파라미터를 변경하거나 확인하고 싶습니다. [Cluster AutoScaler 사용 시 특정 노드를 Scale Down 대상에서 제외](/docs/k8s-troubleshoot-performance#%ED%8A%B9%EC%A0%95%EB%85%B8%EB%93%9C%EB%A5%BCScaleDown%EB%8C%80%EC%83%81%EC%97%90%EC%84%9C%EC%A0%9C%EC%99%B8) Cluster AutoScaler 사용 시 특정 노드를 Scale Down 대상에서 제외하고 싶습니다. [Cluster AutoScaler 사용 시 클러스터가 자동으로 확장되는 경우](/docs/k8s-troubleshoot-performance#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EA%B0%80%EC%9E%90%EB%8F%99%EC%9C%BC%EB%A1%9C%ED%99%95%EC%9E%A5%EB%90%98%EB%8A%94%EA%B2%BD%EC%9A%B0) Cluster AutoScaler 사용 시 클러스터가 자동으로 확장되는 경우가 발생합니다. [Cluster AutoScaler 사용 시 전체 노드 수가 최대 노드 수 보다 작아도 신규 노드가 생성되지 않는 경우](/docs/k8s-troubleshoot-performance#%EC%A0%84%EC%B2%B4%EB%85%B8%EB%93%9C%EC%88%98%EA%B0%80%EC%B5%9C%EB%8C%80%EB%85%B8%EB%93%9C%EC%88%98%EB%B3%B4%EB%8B%A4%EC%9E%91%EC%95%84%EB%8F%84%EC%8B%A0%EA%B7%9C%EB%85%B8%EB%93%9C%EA%B0%80%EC%83%9D%EC%84%B1%EB%90%98%EC%A7%80%EC%95%8A%EB%8A%94%EA%B2%BD%EC%9A%B0) Cluster AutoScaler 사용 시 전체 노드 수가 최대 노드 수 보다 작아도 신규 노드가 생성되지 않는 경우가 발생합니다. [워커노드의 높은 리소스 사용량](/docs/k8s-troubleshoot-performance#%EC%82%AC%EC%9A%A9%EC%8B%9C%EC%9B%8C%EC%BB%A4%EB%85%B8%EB%93%9C%EC%9D%98%EB%86%92%EC%9D%80%EB%A6%AC%EC%86%8C%EC%8A%A4%EC%82%AC%EC%9A%A9%EB%9F%89) 워커노드에서 높은 리소스 사용량이 나타나고 있습니다. ## 둘러볼 콘텐츠 네이버 클라우드 플랫폼에서는 고객에게 도움을 주기 위해 다양한 방식으로 정보를 제공하고 있습니다. Ncloud Kubernetes Service 이용 시 활용할 수 있는 유용한 콘텐츠를 안내합니다. - 자주 하는 질문: [Ncloud Kubernetes Service 자주 하는 질문](https://www.fin-ncloud.com/support/faq/prod?categoryCode2=CNTR&categoryCode3=SV_0120&page=1) - 네이버 클라우드 플랫폼 블로그: [테라폼을 통해 Ncloud Kubernetes Service (NKS) 클러스터 구축하기](https://blog.naver.com/n_cloudplatform/223323963232?trackingCode=blog_bloghome_searchlist) - 네이버 클라우드 플랫폼 블로그: [ncloud 컨테이너 레지스트리와 쿠버네티스 연동에 필요한 명령어(secret 생성 방법)](https://blog.naver.com/n_cloudplatform/222480533910?trackingCode=blog_bloghome_searchlist) - Kubernetes AutoScaler Github: [AutoScaler FAQ](https://github.com/kubernetes/autoscaler/blob/master/cluster-autoscaler/FAQ.md) - Kubernetes 문서 - [Getting started](https://kubernetes.io/docs/setup/) - [CHANGELOG](https://github.com/kubernetes/kubernetes/tree/master/CHANGELOG) - [Version Skew Policy](https://kubernetes.io/releases/version-skew-policy/) - [Safely Drain a Node](https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/) 참고 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.