다음을 통해 공유


Azure Arc 지원 Kubernetes 에이전트 업그레이드

Azure Arc 지원 Kubernetes는 에이전트에 대한 자동 및 수동 업그레이드 기능을 모두 제공하므로 에이전트가 최신 버전으로 업그레이드됩니다. 자동 업그레이드를 사용하지 않도록 설정하고 대신 수동 업그레이드를 사용하는 경우 Arc 에이전트 및 기본 Kubernetes 클러스터에 버전 지원 정책이 적용됩니다.

클러스터를 Azure Arc에 연결할 때 자동 업그레이드를 켜거나 끕니다.

Azure Arc 지원 Kubernetes는 에이전트에 즉시 사용 가능한 자동 업그레이드 기능을 제공합니다. 자동 업그레이드를 사용하도록 설정하면 에이전트가 매시간 Azure를 폴링하여 최신 버전을 확인합니다. 최신 버전을 사용할 수 있게 되면 Azure Arc 에이전트에 대한 Helm 차트 업그레이드를 트리거합니다.

클러스터를 Azure Arc에 연결할 경우 기본 설정은 자동 업그레이드를 사용하도록 설정하는 것입니다.

다음 명령은 자동 업그레이드가 사용하도록 설정된 클러스터를 Azure Arc에 연결합니다.

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

Important

필요한 모든 엔드포인트에 대한 연결을 허용해야 합니다. 특히 자동 업그레이드에는 dl.k8s.io 연결이 필요합니다.

자동 업그레이드를 옵트아웃하려면 클러스터를 Azure Arc에 연결하는 동안 --disable-auto-upgrade 매개 변수를 지정합니다.

다음 명령은 자동 업그레이드가 사용하지 않도록 설정된 클러스터를 Azure Arc에 연결합니다.

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade

자동 업그레이드를 사용하지 않도록 설정하려는 경우 Azure Arc 지원 Kubernetes에 대한 버전 지원 정책을 숙지합니다.

클러스터를 Azure Arc에 연결한 후 자동 업그레이드를 켜거나 끕니다.

클러스터를 Azure Arc에 연결한 후 az connectedk8s update 명령을 사용하고 --auto-upgrade를 true 또는 false로 설정하여 자동 업그레이드 선택을 변경할 수 있습니다.

다음 명령은 연결된 클러스터에 대한 자동 업그레이드를 끕니다.

az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false

수동으로 에이전트 업그레이드

자동 업그레이드를 사용하지 않도록 설정한 경우 az connectedk8s upgrade 명령을 사용하여 에이전트에 대한 업그레이드를 수동으로 시작할 수 있습니다. 이때 업그레이드할 버전을 지정해야 합니다.

Azure Arc 지원 Kubernetes는 에이전트 버전 관리를 위해 MAJOR.MINOR.PATCH의 표준 유의적 버전 체계를 따릅니다. 버전의 각 번호는 이전 버전과의 일반적인 호환성을 나타냅니다.

  • 주 버전은 호환되지 않는 API 업데이트가 있거나 이전 버전과의 호환성이 손상될 수 있을 때 변경됩니다.
  • 부 버전은 기능 변경 내용이 이전 버전의 다른 부 릴리스와 호환될 때 변경됩니다.
  • 패치 버전은 이전 버전과 호환되는 버그 수정이 수행되면 변경됩니다.

일정은 다를 수 있지만 Azure Arc 지원 Kubernetes 에이전트의 새로운 부 버전은 대략 한 달에 한 번 릴리스됩니다.

다음 명령은 에이전트를 버전 1.8.14로 수동으로 업그레이드합니다.

az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.8.14

에이전트 버전 확인

연결된 클러스터 및 보고된 에이전트 버전을 나열하려면 다음 명령을 사용합니다.

az connectedk8s list --query '[].{name:name,rg:resourceGroup,id:id,version:agentVersion}'

클러스터에서 자동 업그레이드가 사용하도록 설정되어 있는지 확인

자동 업그레이드를 위해 클러스터가 사용하도록 설정되었는지 확인하려면 다음 kubectl 명령을 실행합니다. Azure Arc 지원 Kubernetes용 공용 API에서는 자동 업그레이드 구성을 사용할 수 없습니다.

kubectl -n azure-arc get cm azure-clusterconfig -o jsonpath="{.data['AZURE_ARC_AUTOUPDATE']}"

버전 지원 정책

Azure Arc 지원 Kubernetes에 대한 지원 요청 만들기 시 다음 버전 지원 정책이 적용됩니다.

  • Azure Arc 지원 Kubernetes 에이전트에는 “N-2”의 지원 기간이 있습니다. 여기서 ‘N’은 에이전트의 최신 부 릴리스입니다.

    • 예를 들어, Azure Arc 지원 Kubernetes가 오늘 0.28.a를 도입하는 경우 버전 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e 및 0.26.f가 지원됩니다.
  • Azure Arc에 연결된 Kubernetes 클러스터에는 “N-2”의 지원 기간이 있습니다. 여기서 ‘N’은 업스트림 Kubernetes의 안정적인 최신 부 릴리스입니다.

    • 예를 들어, Kubernetes가 오늘 1.20.a를 도입하면 버전 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e 및 1.18.f가 지원됩니다.

지원 요청을 만들고 지원 정책 외부의 버전(에이전트 및 업스트림 Kubernetes 클러스터의 "N-2" 지원 버전보다 이전 버전)을 사용하는 경우 클러스터와 에이전트를 지원되는 버전으로 업그레이드하라는 메시지가 표시됩니다.

다음 단계