다음을 통해 공유

노드 준비 안 됨 오류의 기본 문제 해결

  • 아티클

이 문서에서는 실패 후 AKS(Microsoft Azure Kubernetes Service) 클러스터 노드를 복구하는 문제 해결 단계를 제공합니다. 이 문서에서는 노드 준비 안 됨 오류가 발생할 때 생성되는 가장 일반적인 오류 메시지를 구체적으로 설명하고 Windows 및 Linux 노드 모두에 대해 노드 복구 기능을 수행하는 방법을 설명합니다.

시작하기 전에

Kubernetes 클러스터 문제 해결을 위한 공식 가이드를 참조하세요. 또한 Kubernetes 문제 해결에 대한 Microsoft 엔지니어 가이드를 참조하세요. 이 가이드에는 Pod, 노드, 클러스터 및 기타 기능 문제 해결을 위한 명령이 포함되어 있습니다.

필수 구성 요소

  • Azure CLI, 버전 2.31 이상. Azure CLI가 이미 설치된 경우 을 실행 az --version하여 버전 번호를 찾을 수 있습니다.

기본 문제 해결

AKS는 작업자 노드의 상태를 지속적으로 모니터링하고 비정상 상태가 되면 노드를 자동으로 복구합니다. Azure VM(Virtual Machine) 플랫폼은 문제가 발생하는 VM을 유지 관리합니다 . AKS와 Azure VM은 함께 작동하여 클러스터에 대한 서비스 중단을 줄입니다.

노드의 경우 두 가지 형태의 하트비트가 있습니다.

  • 개체의 .상태 파일에 Node 업데이트.

  • kube-node-lease 네임스페이스 내에서 개체를 임대합니다. 각 Node 개체에는 연결된 개체가 Lease 있습니다.

의 .상태 파일에 대한 업데이트와 NodeLease 비교할 때 은 경량 리소스입니다. 하트비트에 개체를 사용하면 Lease 대규모 클러스터에 대한 이러한 업데이트의 성능 영향이 줄어듭니다.

kubelet은 개체에 대한 .상태 파일을 만들고 업데이트합니다Node. 또한 개체와 관련된 개체를 Lease 업데이트해야 합니다 Node .

다음 조건 중 하나가 true인 경우 kubelet은 .상태 파일을 업데이트 Node 합니다.

  • 상태 변경이 발생합니다.

  • 구성된 시간 간격 후에는 업데이트가 수행되지 않습니다.

에 대한 상태 업데이트의 Node 기본 간격은 5분입니다. 이 간격은 연결할 수 없는 노드에 대한 40초 기본 제한 시간보다 훨씬 깁니다. kubelet은 개체를 만들고 10초마다 한 번 업데이트합니다 Lease (기본 업데이트 간격). Lease 업데이트 상태 대한 업데이트와 독립적으로 수행됩니다 Node . 업데이트가 Lease 실패하면 kubelet은 200밀리초에서 시작하여 최대 7초로 제한되는 지수 백오프를 사용하여 다시 시도합니다.

또는 Unknown의 상태 NotReady 있는 에서 을 예약 PodNode 할 수 없습니다. 상태에 있는 Pod 노드에서만 을 예약할 Ready 수 있습니다.

노드가 MemoryPressure, DiskPressure또는 PIDPressure 상태인 경우 노드에서 추가 Pod를 예약하려면 리소스를 관리해야 합니다. 노드가 모드인 NetworkUnavailable 경우 노드에서 네트워크를 올바르게 구성해야 합니다. 다음 조건이 충족되는지 확인합니다.

  • 클러스터가 성공(실행 중) 상태입니다. Azure Portal 클러스터 상태 검사Kubernetes 서비스를 검색하여 선택하고 AKS 클러스터의 이름을 선택합니다. 그런 다음 클러스터의 개요 페이지에서 Essentials 확인하여 상태를 찾습니다. 또는 Azure CLI에서 az aks show 명령을 입력합니다.

    Azure Kubernetes Service(KS) 클러스터 개요 페이지의 Azure Portal 스크린샷 Essentials 섹션에서 상태는 '성공(실행 중)'입니다.

  • 노드 풀의 프로비저닝 상태는성공 이고 전원 상태는실행 중입니다. Azure Portal 노드 풀 상태 검사 AKS 클러스터의 페이지로 돌아가 노드 풀을 선택합니다. 또는 Azure CLI에서 az aks nodepool show 명령을 입력합니다.

    Azure Portal Azure Kubernetes Service(KS) 클러스터 노드 풀의 스크린샷 프로비전 상태가 성공입니다. 전원 상태가 실행 중입니다.

  • 필요한 송신 포트는 API 서버의 IP 주소에 연결할 수 있도록 NSG(네트워크 보안 그룹) 및 방화벽에서 열립니다. 자세한 내용은 AKS 클러스터에 필요한 아웃바운드 네트워크 규칙 및 FQDN을 참조하세요.

  • 노드 가 최신 노드 이미지를 배포했습니다.

  • 노드가 또는 Deallocated대신 Stopped 상태에 있습니다Running.

  • 클러스터에서 AKS 지원 버전의 Kubernetes를 실행하고 있습니다.

타사 연락처 고지

Microsoft는 이 항목에 대한 추가 정보를 찾는 데 도움이 되는 타사 연락처 정보를 제공합니다. 이 연락처 정보는 공지 없이 변경될 수 있습니다. Microsoft는 타사 연락처 정보의 정확성을 보장하지 않습니다.