Azure Kubernetes Application Network 멤버에 대한 업그레이드 구성(미리 보기)

중요합니다

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

Azure Kubernetes Application Network는 멤버에 부 버전 업그레이드를 적용하는 방법을 유연하게 제어할 수 있습니다. Azure Kubernetes Application Network 리소스에 등록된 각 멤버 클러스터는 필요한 제어 수준(자체 관리() 또는 SelfManaged형(FullyManaged)에 따라 두 가지 업그레이드 모드 중 하나를 사용할 수 있습니다. 이러한 모드는 멤버 수준에서 작동하므로 각 클러스터에 대해 수동으로 또는 자동으로 업그레이드를 수행할지 여부를 선택할 수 있습니다.

이 문서에서는 이러한 업그레이드 모드 간의 차이점, Azure Kubernetes Application Network 멤버에 대해 해당 모드를 구성하는 방법 및 업그레이드를 관리할 때 유의해야 할 중요한 고려 사항에 대해 설명합니다.

일반 업그레이드 모드 고려 사항

Azure Kubernetes Application Network 멤버에 대한 업그레이드 모드를 구성할 때는 다음과 같은 제한 사항 및 고려 사항을 염두에 두어야 합니다.

Azure Kubernetes Application Network 업그레이드 모드는 부 버전의 Azure Kubernetes Application Network 구성 요소에 만 적용됩니다. Kubernetes 버전 또는 노드 이미지 업데이트와 같은 클러스터 수준 업그레이드를 제어하거나 영향을 주지 않습니다 .
패치 업데이트는 모드에 관계없이 항상 자동으로 적용됩니다.
조인 프로세스 중에 각 멤버에 대한 업그레이드 모드를 선택합니다. 선택한 후에는 Azure Kubernetes Application Network 리소스에서 제거될 때까지 해당 멤버에 대한 모드가 적용됩니다. 먼저 멤버를 제거하고 Azure Kubernetes Application Network 리소스에 다시 가입하지 않고는 멤버의 업그레이드 모드를 변경할 수 없습니다.
멤버 조인 중에 업그레이드 모드를 지정하지 않으면 기본적으로 .로 설정 SelfManaged됩니다.

자체 관리 모드

모드에서는 SelfManaged 업그레이드가 발생하는 시기를 설치하고 제어할 Azure Kubernetes Application Network의 부 버전을 지정합니다. 이 모드는 자동화된 업데이트에 의존하지 않고 사소한 업그레이드 프로세스를 수동으로 관리하려는 시나리오를 위한 것입니다. 이 모드에서 --version가 지정되지 않은 경우, 기본적으로 사용 가능한 첫 번째 버전으로 N-1 설정됩니다. 멤버 조인 중에 업그레이드 모드가 지정되지 않은 경우에도 이 모드가 기본값입니다.

자체 관리 모드 고려 사항

SelfManaged 모드를 사용할 때 다음의 사항을 염두에 두십시오.

업그레이드는 연속된 부 버전(예: 부 버전 NN+1에서 )간에만 허용됩니다. 버전 건너뛰기(예: 이전 버전으로 1.11.3업그레이드)는 지원되지 않습니다.
이전에 동일한 클러스터에 설치되었으면 바로 이전 버전(N-1)으로만 롤백할 수 있습니다. 다른 이전 버전으로 롤백하는 것은 지원되지 않습니다.
여러 연속 롤백은 지원되지 않습니다. 최대 하나의 버전을 롤백할 수 있습니다.

자체 관리 모드에 등록하고 멤버 조인 중에 버전을 선택합니다.

모드에 SelfManaged 등록하고 멤버 가입 시 az appnet member join 명령을 사용하고, --upgrade-mode SelfManaged 및 --version 매개 변수를 원하는 버전으로 설정하여 버전을 명확하게 선택합니다.

az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged \
    --version $VERSION

현재 버전 확인

명령을 사용하여 az appnet member show 멤버에 현재 설치된 버전을 확인하고 출력의 Version 속성을 참조합니다.
```
az appnet member show --member-name $APPNET_MEMBER_NAME --appnet-name $APPNET_NAME --resource-group $APPNET_RG
```

사용 가능한 업그레이드 버전 확인

매개 변수가 관심 지역으로 설정된 명령을 az appnet list-versions 사용하여 --location 해당 지역의 각 모드 및 Kubernetes 버전에 사용할 수 있는 버전을 확인합니다. 출력에서 AvailableUpgrades 열을 참조하여 사용 가능한 버전을 보세요.
```
az appnet list-versions --location $LOCATION -o table
```

업그레이드 시작

업그레이드할 원하는 버전으로 설정된 매개 변수가 있는 az appnet member update 명령을 사용하여 --version 업그레이드를 시작합니다.
```
az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
```

이전 버전으로 롤백

az appnet member update 명령과 롤백할 원하는 버전으로 설정된 --version 매개 변수를 사용하여 이전에 설치된 버전으로 롤백합니다. 이전 버전(N-1)으로 롤백만 지원됩니다.
```
az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
```

완전 관리형 모드

모드에서 FullyManaged Azure Kubernetes Application Network는 선택한 릴리스 채널에 따라 각 멤버에 대한 버전 업그레이드를 자동으로 관리합니다. Azure Kubernetes Application Network가 수동 개입 없이 버전 안정성 평가, 출시 타이밍 및 지속적인 업데이트를 처리하는 것을 선호하는 경우 이 모드를 사용하는 것이 좋습니다.

업그레이드 모드를 사용하는 FullyManaged 경우 멤버 클러스터가 새 버전을 채택하는 빈도를 결정하는 릴리스 채널을 선택합니다. Azure Kubernetes Application Network는 릴리스 준비 상태를 모니터링하고 채널의 안정성 기준에 따라 멤버를 업그레이드합니다.

모드에 사용할 수 있는 FullyManaged 릴리스 채널은 다음과 같습니다.

빠른: 사용할 수 있게 되는 즉시 최신 Application Network 버전을 제공합니다. 이 채널은 새로운 기능 및 기능 테스트가 확장된 유효성 검사 시간보다 우선 순위가 지정된 비프로덕션 또는 초기 유효성 검사 환경을 위한 것입니다.
안정: 추가 유효성 검사 및 테스트를 완료한 버전을 제공합니다. 이 채널은 프로덕션 환경을 위한 것이며 일반적으로 부 버전 N-1에 맞춰 안정성을 높이고 이전 릴리스에서 식별된 문제를 해결합니다.

FullyManaged 모드를 선택하면 릴리스 채널을 stablerapid지정할 수 있습니다. 생략하면 기본 채널은 .입니다 stable.

중요합니다

FullyManaged 모드에서 Azure Kubernetes Application Network는 릴리스 채널을 통해 새 버전이 프로모션될 때 업그레이드를 자동으로 적용합니다. 업그레이드 타이밍 또는 버전 선택에 대한 수동 제어는 지원되지 않습니다.

완전 관리 모드에 사용 가능한 업그레이드 버전 확인

az appnet list-versions 명령과 FullyManaged 모드용 grep를 사용하여 지정된 Kubernetes 버전 및 지역에 대해 각 채널이 해당하는 버전을 확인하세요.
```
az appnet list-versions --location $LOCATION -o table | grep FullyManaged
```

완전히 관리되는 모드에 등록하고 멤버 조인 중에 릴리스 채널을 선택합니다.

사용자 조인 시 FullyManaged 모드에 등록하고, az appnet member join 명령을 사용해 --upgrade-mode FullyManaged 매개 변수를 원하는 채널로 설정하여, --release-channel 매개 변수와 함께 릴리스 채널을 선택합니다. 멤버가 참여하는 동안 Rapid 채널을 선택하는 방법을 다음 예제에서 보여 줍니다.

az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode FullyManaged \
    --release-channel Rapid \
    --member-location $LOCATION

릴리스 채널 선택 업데이트

선택한 릴리스는 언제든지 업데이트할 수 있습니다. 릴리스 채널에 대한 모든 변경 내용은 즉시 적용됩니다.

az appnet member update 명령을 사용하고 --release-channel 매개 변수를 원하는 채널로 설정하여 기존 멤버의 릴리스 채널 선택을 업데이트하세요. 다음 예제에서는 기존 멤버의 Stable 채널로 전환하는 방법을 보여 줍니다.
```
az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --release-channel Stable
```

Azure Kubernetes Application Network에 대한 자세한 내용은 다음 문서를 참조하세요.

피드백

이 페이지가 도움이 되었나요?

2026-03-23 에 마지막으로 업데이트됨