AKS(Azure Kubernetes Service) 클러스터에서 노드 수를 수동으로 크기 조정

애플리케이션의 리소스 요구 사항이 변경되면 CPU, 메모리, PID 공간 또는 디스크 크기의 낮은 용량으로 인해 클러스터 성능이 영향을 받을 수 있습니다. 이러한 변경 내용을 해결하기 위해 AKS 클러스터의 크기를 수동으로 조정하여 다른 수의 노드를 실행할 수 있습니다. 클러스터를 스케일인하면 실행 중인 애플리케이션의 중단을 최소화하기 위해 노드 수가 적절하게 제한 및 감소됩니다. 스케일 아웃할 때 AKS는 노드에 Pod가 예약되기 전에 Kubernetes 클러스터에서 노드가 준비로 표시될 때까지 기다립니다.

이 문서에서는 AKS 클러스터의 노드 수를 수동으로 늘리거나 줄이는 방법을 설명합니다.

참고

이 문서는 AKS 표준 클러스터에 적용됩니다. AKS 자동 클러스터는 노드 자동 프로비전을 사용하여 노드 크기 조정을 관리합니다.

시작하기 전에

  • AKS 서비스 할당량 및 한도를 검토하여 클러스터가 원하는 노드 수로 크기 조정될 수 있는지 확인합니다.

  • 노드 풀에서 클러스터 자동 크기 조정기를 사용하는 경우 노드 수를 수동으로 변경할 수 없습니다. 클러스터 자동 크기 조정기 최소값과 최대값을 업데이트하거나 수동으로 크기를 조정하기 전에 노드 풀에서 클러스터 자동 크기 조정기를 사용하지 않도록 설정할 수 있습니다.

  • Azure Linux 2.0 지원은 2025년 11월 30일에 종료되었습니다. 2026년 3월 31일부터 Azure Linux 2.0 노드 이미지가 제거되었으며 영향을 받는 노드 풀은 더 이상 크기를 조정할 수 없습니다. Azure Linux 2.0 노드 풀의 크기를 조정하기 전에 Azure Linux 3으로 마이그레이션합니다.

  • 노드 풀 이름은 다음 요구 사항을 충족해야 합니다.

    노드 풀 유형 이름 요구 사항
    Linux 1-12 소문자 영숫자 사이입니다. 소문자로 시작해야 합니다.
    Windows 1-6 소문자 영숫자 사이입니다. 소문자로 시작해야 합니다.

AKS에서 클러스터 노드 크기 조정

중요

명령을 사용하여 노드 풀에서 노드를 kubectl 제거하는 것은 지원되지 않습니다. 이 작업을 수행하면 AKS 클러스터에 크기 조정 문제가 발생할 수 있습니다.

  1. 명령을 사용하여 az aks show 노드 풀의 이름, 모드 및 노드 수를 가져옵니다. 다음 예제에서는 myResourceGroup 리소스 그룹에서 myAKSCluster라는 클러스터에 대한 노드 풀 세부 정보를 가져옵니다.

    az aks show --resource-group myResourceGroup --name myAKSCluster --query "agentPoolProfiles[].{Name:name,Mode:mode,Count:count}" --output table

    다음 예제 출력은 nodepool1 이 3개의 노드가 있는 시스템 노드 풀임을 보여 줍니다.

    Name       Mode    Count
---------  ------  -------
nodepool1  System  3

  2. 명령을 사용하여 클러스터 노드 크기를 조정합니다 az aks scale . 다음 예제에서는 myAKSCluster라는 클러스터의 nodepool1을 두 개의 노드로 확장합니다.

    az aks scale --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-name nodepool1 --query "agentPoolProfiles[?name=='nodepool1'].{Name:name,Mode:mode,Count:count}" --output table

    다음 예제 출력은 시스템 노드 풀이 두 노드로 확장되었음을 보여 줍니다.

    Name       Mode    Count
---------  ------  -------
nodepool1  System  2

    시스템 노드 풀에는 두 개 이상의 노드가 있어야 합니다. 프로덕션 클러스터의 경우 시스템 노드 풀에서 3개 이상의 노드를 사용합니다. 자세한 내용은 시스템 및 사용자 노드 풀참조하세요.

사용자 노드 풀을 0으로 크기 조정

항상 실행 중인 노드가 필요한 시스템 노드 풀과 달리 사용자 노드 풀은 0으로 확장할 수 있습니다. 시스템 및 사용자 노드 풀 간의 차이점에 대해 자세히 알아보려면 시스템 및 사용자 노드 풀을 참조하세요.

중요

사용자 노드 풀을 0개 노드로 확장하려면 클러스터 자동 크기 조정기를 사용하지 않도록 설정합니다. 자세한 내용은 노드 풀에서 클러스터 자동 크기 조정기 사용 안 함을 참조하세요.

사용자 노드 풀의 크기를 0으로 조정하려면 일반 노드 크기 조정에 사용되는 명령 대신 az aks scaleaz aks nodepool scale을 사용하고 다음으로 0설정합니다--node-count.

az aks nodepool scale --name <your node pool name> --cluster-name myAKSCluster --resource-group myResourceGroup  --node-count 0

0의 매개 변수를 --min-count로 설정하면 자동 크기 조정된 사용자 노드 풀에서 노드 수를 0개까지 자동 크기 조정하도록 허용할 수는 있지만, 이를 강제할 수는 없습니다.

다음 단계

이 문서에서는 노드 수를 늘리거나 줄이기 위해 AKS 클러스터를 수동으로 크기 조정했습니다. 클러스터 자동 크기 조정기를 사용하여 클러스터를 자동으로 크기 조정할 수도 있습니다.

  • 에 마지막으로 업데이트됨