AKS 자동 클러스터 및 관리되는 시스템 노드 풀 마이그레이션

적용 대상: ✔️ AKS 자동 ✔️ AKS 표준

이 문서에서는 지원되는 관리되는 시스템 노드 풀 과 AKS 표준 구성 간에 AKS 자동 클러스터를 마이그레이션하는 방법을 보여 줍니다.

지원되는 마이그레이션 경로

마이그레이션 경로 Support
관리되는 시스템 노드 풀을 사용하는 AKS 자동에서 AKS Standard(base SKU)로 Supported
관리되는 시스템 노드 풀이 없는 AKS Automatic에서 관리되는 시스템 노드 풀이 있는 AKS Automatic으로 관리되는 시스템 노드 풀을 일반적으로 사용할 수 있는 지역에서 미리 보기에서 지원됨
관리되는 시스템 노드 풀을 사용하는 AKS Standard (base SKU)에서 AKS Automatic으로 곧 출시 예정
관리되는 시스템 노드 풀이 있는 AKS Automatic에서 관리되는 시스템 노드 풀이 없는 AKS Automatic으로 지원되지 않음

관리되는 시스템 노드 풀이 있는 AKS 자동 클러스터에서 AKS 표준 클러스터로 마이그레이션

마이그레이션 작동 방식

관리되는 시스템 노드 풀이 있는 AKS 자동 클러스터는 AKS가 프로비전, 크기 조정 및 업그레이드하는 시스템 노드 풀에서 해당 시스템 구성 요소를 실행합니다.

Important

AKS 표준(base SKU) 클러스터는 관리되는 시스템 노드 풀을 사용하도록 설정하지 않으므로 시스템 노드 풀 및 시스템 구성 요소를 실행, 관리 및 업그레이드해야 합니다.

AKS 자동에서 AKS 표준으로 마이그레이션하려면 다음 개략적인 단계를 완료합니다.

  1. AKS 자동 클러스터에 자체 관리형 시스템 노드 풀을 추가합니다.
  2. 클러스터 SKU를 automatic에서 base(으)로 업데이트합니다.

SKU를 업데이트한 후 클러스터는 AKS 표준 클러스터로 실행되고 시스템 구성 요소는 추가 및 관리하는 시스템 노드 풀에서 실행됩니다.

AKS 표준 클러스터로 마이그레이션

  1. 명령을 사용하여 기존 AKS 자동 클러스터에 자체 관리형 시스템 노드 풀을 추가합니다 az aks nodepool add . 마이그레이션 후 시스템 구성 요소를 실행할 수 있도록 노드 풀 모드 System 를 설정합니다.

    az aks nodepool add \
    --resource-group "${RESOURCE_GROUP}" \
    --cluster-name "${RESOURCE_NAME}" \
    --name systempool \
    --mode System \
    --node-count 3

  2. az aks update 명령을 사용하여 클러스터 SKU를 automatic에서 base로 업데이트합니다.

    az aks update \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --sku base

마이그레이션 확인

  1. az aks show 명령을 사용하여 이제 클러스터가 base SKU를 사용하는지 확인합니다.

    az aks show \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --query "sku" \
    --output table

  2. az aks nodepool list 명령을 사용하여 클러스터의 노드 풀을 나열하고, 자체 관리형 시스템 노드 풀이 존재하며 System 모드인지 확인합니다.

    az aks nodepool list \
    --resource-group "${RESOURCE_GROUP}" \
    --cluster-name "${RESOURCE_NAME}" \
    --query "[].{Name:name, Mode:mode, Count:count}" \
    --output table

관리되는 시스템 노드 풀이 없는 AKS 자동 클러스터에서 관리되는 시스템 노드 풀을 사용하여 AKS Automatic으로 마이그레이션(미리 보기)

AKS Automatic은 관리되지 않는 시스템 노드 풀에서 관리되는 시스템 노드 풀을 일반적으로 사용할 수 있는 지역의 관리되는 시스템 노드 풀로 미리 보기 마이그레이션을 지원합니다. 이 마이그레이션은 클러스터를 automatic SKU에 유지하고 AKS 시스템 구성 요소를 AKS에서 관리하는 시스템 노드 풀로 이동합니다.

사전 요구 사항

Important

AKS 미리 보기 기능은 셀프 서비스에서 사용할 수 있습니다(옵트인 방식). 미리 보기는 "있는 그대로" 및 "사용 가능한 상태로" 제공되며 서비스 수준 계약 및 제한적 보증에서 제외됩니다. AKS 미리 보기의 일부는 고객 지원팀에서 최선을 다해 지원합니다. 따라서 이러한 기능은 프로덕션 용도로 사용할 수 없습니다. 자세한 내용은 다음 지원 문서를 참조하세요.

  • 관리되는 시스템 노드 풀이 없는 기존 AKS 자동 클러스터입니다.
  • Azure CLI 버전 2.86.0 이상. 버전을 확인하려면 az --version을 실행합니다. 설치 또는 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.
  • 최신 버전의 aks-preview Azure CLI 확장.
  • Microsoft.ContainerService/NonHoboToHoboConversionPreview 구독에 등록된 기능 플래그입니다.

NonHoboToHoboConversionPreview 다음 명령을 사용하여 기능 플래그를 등록합니다.az feature register

az feature register \
    --namespace Microsoft.ContainerService \
    --name NonHoboToHoboConversionPreview

다음 명령을 사용하여 등록 상태를 확인합니다.az feature show

az feature show \
    --namespace Microsoft.ContainerService \
    --name NonHoboToHoboConversionPreview \
    --query properties.state \
    --output tsv

계속하기 전에 명령이 반환 Registered 될 때까지 기다립니다. 그런 다음, 리소스 공급자 등록을 Microsoft.ContainerService 새로 고칩니다.

az provider register --namespace Microsoft.ContainerService

확장을 설치하거나 업데이트합니다.aks-preview

az extension add --name aks-preview
az extension update --name aks-preview

AKS 관리형 가상 네트워크 클러스터 마이그레이션

AKS 관리 네트워킹을 사용하는 AKS 자동 클러스터의 경우 --enable-hosted-system 매개 변수와 함께 az aks update 명령을 사용하여 관리형 시스템 노드 풀로 마이그레이션합니다.

az aks update \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --enable-hosted-system

사용자 지정 가상 네트워크 클러스터 마이그레이션

사용자 지정 가상 네트워크를 사용하는 AKS 자동 클러스터의 경우 --system-node-subnet-id 매개 변수를 사용하여 관리형 시스템 노드 풀의 서브넷을 지정합니다. 시스템 노드 서브넷은 다음을 수행해야 합니다.

  • 클러스터와 동일한 가상 네트워크 및 지역에 있어야 합니다.
  • 적어도 /26.
  • 다른 서비스에 위임되지 않습니다.
  • 노드 서브넷과 달라야 합니다.

--node-subnet-id 매개 변수는 선택 사항입니다. 제공하지 않으면 AKS는 기존 시스템 노드 풀 서브넷을 사용합니다.

az aks update \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --enable-hosted-system \
    --system-node-subnet-id "${SYSTEM_NODE_SUBNET_ID}" \
    --node-subnet-id "${NODE_SUBNET_ID}"

마이그레이션 확인

클러스터가 다음 명령을 사용하여 관리되는 시스템 노드 풀을 사용하는지 확인합니다.az aks show

az aks show \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --query hostedSystemProfile \
    --output json

다음 예제 출력은 hostedSystemProfile.enabled 속성이 true로 설정된 것을 보여 줍니다:

{
  "enabled": true,
  "nodeSubnetId": "<node-subnet-resource-id>",
  "systemNodeSubnetId": "<system-node-subnet-resource-id>"
}
  • Last updated on