Azure Kubernetes Fleet Manager 리소스에 대한 허브 클러스터 유형 업그레이드

아티클
10/15/2024

이 문서에서는 허브 클러스터가 없는 Kubernetes Fleet(Azure Kubernetes Fleet Manager) 리소스를 허브 클러스터가 있는 Kubernetes Fleet 리소스로 업그레이드하는 방법을 알아봅니다. 허브 클러스터 없이 Kubernetes Fleet 리소스가 만들어지면 Kubernetes Fleet 리소스에 대해 중앙 AKS(Azure Kubernetes Service) 클러스터가 만들어지지 않습니다. 허브 클러스터가 포함된 Kubernetes Fleet 리소스가 만들어지면 워크로드 오케스트레이션 및 계층 4 부하 분산과 같은 시나리오를 지원하기 위해 중앙 관리 AKS 클러스터가 만들어집니다.

자세한 내용은 Azure Kubernetes Fleet Manager 옵션 선택을 참조하세요.

필수 구성 요소 및 제한 사항

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

Azure CLI를 설치하거나 최신 버전으로 업그레이드합니다.
활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
허브 클러스터가 없는 기존 Kubernetes Fleet 리소스가 있어야 합니다. 이 문서의 단계에서는 허브 클러스터 없이 Kubernetes Fleet 리소스를 만드는 방법을 보여 줍니다. 이미 있는 경우 초기 설정을 건너뛰고 Kubernetes Fleet 리소스에 대한 허브 클러스터 유형 업그레이드부터 시작할 수 있습니다.
이 문서에는 멤버 클러스터 조인 단계도 포함되어 있습니다. 계속 진행하려면 AKS 클러스터가 하나 이상 필요합니다.

Important

허브 클러스터가 없는 Kubernetes Fleet 리소스는 허브 클러스터가 있는 Kubernetes Fleet 리소스로 업그레이드될 수 있습니다. 그러나 이미 허브 클러스터가 있는 Kubernetes Fleet 리소스는 허브 클러스터가 없는 Kubernetes Fleet 리소스로 다운그레이드될 수 없습니다. 허브 클러스터가 있는 Kubernetes Fleet 리소스와 관련된 모든 구성 옵션 및 설정은 변경할 수 없으며 만들기 또는 업그레이드 후에는 변경할 수 없습니다. 허브 클러스터가 없는 Kubernetes Fleet 리소스에서 허브 클러스터가 있는 리소스로 업그레이드하는 것은 Azure CLI를 통해서만 수행할 수 있습니다. 현재는 이에 상응하는 Azure Portal 환경이 없습니다.

초기 설정

시작하려면 허브 클러스터 없이 리소스 그룹과 Kubernetes Fleet 리소스를 만들고 기존 AKS 클러스터를 멤버로 조인합니다. Fleet 리소스와 연결하려는 각 개별 멤버 클러스터에 대해 az fleet member create 명령을 반복해야 합니다.

RG=myResourceGroup
LOCATION=eastus
FLEET=myKubernetesFleet
FLEET_MEMBER=<name-identifying-member-cluster>
SUBSCRIPTION_ID=<your-subscription-id>
CLUSTER=<your-aks-cluster-name>

# Create resource group
az group create -n $RG -l $LOCATION

# Create a hubless fleet resource 
az fleet create -g $RG -n $FLEET

# Join member cluster to hubless fleet resource
az fleet member create --name $FLEET_MEMBER --fleet-name $FLEET --resource-group $RG --member-cluster-id /subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER

Kubernetes Fleet 리소스에 대한 허브 클러스터 유형 업그레이드

Kubernetes Fleet 리소스의 허브 클러스터 유형을 업그레이드하려면 --enable-hub 플래그가 설정된 az fleet create 명령을 사용합니다. 이 작업이 완료된 후에는 Fleet 리소스를 변경할 수 없으므로 다른 관련 구성 옵션을 포함해야 합니다.

# Upgrade the Kubernetes fleet resource without a hub cluster to one with a hub cluster
az fleet create --name $FLEET --resource-group $RG --enable-hub

업그레이드 유효성 검사

az fleet create 명령을 실행하여 Fleet 리소스를 업그레이드한 후 출력을 확인하여 업그레이드가 성공했는지 확인합니다. provisioningState는 Succeeded로 읽어야 하고 hubProfile 필드가 존재해야 합니다. 예를 들어, 다음 출력을 참조하세요.

{
  ...
  "hubProfile": {
    "agentProfile": {
      "subnetId": null,
      "vmSize": null
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": false,
      "enableVnetIntegration": false,
      "subnetId": null
    },
    "dnsPrefix": "contoso-user-xxxx-xxxxxxx",
    "fqdn": "contoso-user-flth-xxxxxx-xxxxxxxx.hcp.eastus.azmk8s.io",
    "kubernetesVersion": "1.28.5",
    "portalFqdn": "contoso-user-flth-xxxxxxx-xxxxxxxx.portal.hcp.eastus.azmk8s.io"
  },
  "provisioningState": "Succeeded"
  ...
}

멤버 클러스터 다시 조인

새로 업그레이드된 Fleet 리소스에 멤버 클러스터를 다시 조인하려면 각 개별 멤버 클러스터에 대해 az fleet member reconcile 명령을 사용합니다.

az fleet member reconcile -g $RG -f $FLEET -n $FLEET_MEMBER

참고 항목

업그레이드가 이미 수행된 후 처음으로 Fleet 리소스에 조인하는 AKS 클러스터는 az fleet member reconcile를 사용하여 조정할 필요가 없습니다.

멤버 클러스터가 성공적으로 조인되었는지 확인

새로 업그레이드된 집합에 다시 조인하는 각 멤버 클러스터에 대해 출력을 보고 provisioningState가 Succeeded로 표시되는지 확인합니다. 예시:

{
  ...
  "provisioningState": "Succeeded"
  ...
}

기능 확인

허브 클러스터의 Kubernetes API에 액세스해야 합니다. 액세스 권한이 없는 경우 Access Fleet 허브 클러스터 Kubernetes API를 참조하세요.

새로 업그레이드된 Kubernetes Fleet 리소스가 제대로 작동하고 멤버 클러스터가 성공적으로 조인되었는지 확인하려면 kubectl get memberclusters 명령을 사용하여 허브 클러스터의 API 서버에 액세스할 수 있는지 확인합니다.

성공하면 출력은 다음 출력 예와 유사해야 합니다.

NAME           JOINED   AGE
aks-member-1   True     2m
aks-member-2   True     2m
aks-member-3   True     2m

리소스 정리

완료되면 리소스 그룹을 삭제하여 Fleet 리소스 및 관련 리소스를 제거할 수 있습니다. AKS 클러스터가 다른 리소스 그룹에 있는 경우 이 작업은 AKS 클러스터를 제거하지 않는다는 점에 유의해야 합니다.

az group delete -n $RG

다음 단계

이제 Kubernetes Fleet 리소스가 허브 클러스터를 갖도록 업그레이드되었으므로 이전에는 사용할 수 없었던 기능을 활용할 수 있습니다. 예를 들어 다음을 참조하세요.

Fleet 멤버 클러스터 전반의 계층 4 부하 분산

다음을 통해 공유