Azure Stack Hub에서 Kubernetes 클러스터 크기 조정Scale a Kubernetes cluster on Azure Stack Hub

Scale 명령을 사용 하 여 AKS 엔진으로 클러스터를 확장할 수 있습니다.You can scale your cluster with the AKS engine using the scale command. 크기 조정 명령은 출력 디렉터리 내의 클러스터 구성 파일 ( apimodel.json )을 새 Azure Resource Manager 배포에 대 한 입력으로 재사용 합니다.The scale command reuses your cluster configuration file (apimodel.json) inside the output directory as input for a new Azure Resource Manager deployment. 엔진은 지정 된 에이전트 풀에 대해 크기 조정 작업을 실행 합니다.The engine executes the scaling operation against the specified agent pool. 크기 조정 작업이 완료 되 면 엔진은 apimodel.json 업데이트 된 현재 클러스터 구성을 반영 하기 위해 새 노드 수를 반영 하도록 동일한 파일의 클러스터 정의를 업데이트 합니다.When the scaling operation is done, the engine updates the cluster definition in that same apimodel.json file to reflect the new node count in order to reflect the updated, current cluster configuration.

클러스터 크기 조정Scale a cluster

aks-engine scale명령은 Kubernetes 클러스터에 있는 기존 에이전트 풀의 노드 수를 늘리거나 줄일 수 있습니다 aks-engine .The aks-engine scale command can increase or decrease the number of nodes in an existing agent pool in an aks-engine Kubernetes cluster. 노드는 항상 에이전트 풀의 끝에서 추가 되거나 제거 됩니다.Nodes will always be added or removed from the end of the agent pool. 노드가 삭제 되기 전에 통제 되 고 방전 됩니다.Nodes will be cordoned and drained before deletion.

Scale 명령의 값Values for the scale command

다음 매개 변수는 scale 명령에서 클러스터 정의 파일을 찾고 클러스터를 업데이트 하는 데 사용 됩니다.The following parameters are used by the scale command to find your cluster definition file and update your cluster.

매개 변수Parameter 예제Example DescriptionDescription
azure-envazure-env AzureStackCloudAzureStackCloud Azure Stack 허브를 사용 하는 경우 환경 이름을으로 설정 해야 AzureStackCloud 합니다.When using Azure Stack Hub, the environment names needs to be set to AzureStackCloud.
위치location 로컬local Azure Stack 허브 인스턴스의 지역입니다.This is the region for your Azure Stack Hub instance. ASDK의 경우 지역은로 설정 됩니다 local .For an ASDK, the region is set to local.
resource-groupresource-group kube-rgkube-rg 클러스터를 포함 하는 리소스 그룹의 이름입니다.The name of the resource group that contains your cluster.
subscription-idsubscription-id 클러스터에서 사용 하는 리소스를 포함 하는 구독의 GUID입니다.The GUID of the subscription that contains the resources used by your cluster. 크기를 조정 하기 위해 구독에 충분 한 할당량이 있는지 확인 합니다.Make sure you have enough quota on your subscription to scale.
클라이언트 idclient-id AKS 엔진에서 클러스터를 만드는 데 사용 되는 서비스 주체의 클라이언트 ID입니다.The client ID of the service principal used in creating your cluster from the AKS engine.
클라이언트-비밀client-secret 클러스터를 만들 때 사용 되는 서비스 주체 암호입니다.The service principal secret used when creating your cluster.
api-모델api-model kube-rg/apimodel.jsonkube-rg/apimodel.json 클러스터 정의 파일 (apimodel.js)의 경로입니다.The path to your cluster definition file (apimodel.json). _Output/ <dnsPrefix> /apimodel.js에 있을 수 있습니다.This may be at: _output/<dnsPrefix>/apimodel.json
새 노드 수new-node-count 99 원하는 노드 수입니다.Desired node count.
apiserverapiserver 마스터 FQDN.Master FQDN. 규모를 축소 하는 데 필요 합니다.Needed when scaling down.
id-시스템identity-system adfsadfs 선택 사항입니다.Optional. AD FS (Active Directory 페더레이션된 서비스)를 사용 하는 경우 id 관리 솔루션을 지정 합니다.Specify your identity management solution if you are using Active Directory Federated Services (AD FS).

Azure Stack 허브에서 클러스터의 크기를 조정할 때 --azure-env 매개 변수를 지정 해야 합니다.You must specify the --azure-env parameter when scaling a cluster in Azure Stack Hub. AKS 엔진의 scale 명령에 사용 되는 매개 변수 및 해당 값에 대 한 자세한 내용은 scale-parameters를 참조 하세요.For more information about parameters and their values used in the scale command for the AKS engine, see Scale - parameters.

클러스터 크기를 조정 하는 명령Command to scale your cluster

클러스터의 크기를 조정 하려면 다음 명령을 실행 합니다.To scale the cluster you run the following command:

aks-engine scale \
    --azure-env AzureStackCloud   \
    --location <for an ASDK is local> \
    --resource-group <cluster resource group>
    --subscription-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
    --client-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
    --client-secret xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
    --api-model <path to your apomodel.json file>
    --new-node-count <desired node count> \
    --apiserver <master FQDN> \
    --identity-system adfs # required if using AD FS

다음 단계Next steps