PowerShell을 사용하여 Arc에서 사용하도록 설정된 AKS의 AKS 호스트 업그레이드

  • 아티클

적용 대상: Azure Stack HCI 22H2의 AKS, Windows Server의 AKS

이 문서에서는 Azure Arc에서 사용하도록 설정된 AKS에서 Azure Kubernetes Service 호스트를 업데이트하는 방법을 설명합니다.

AKS 호스트 업데이트 개요

AKS 호스트에 대한 업데이트 항상 사용 가능한 최신 버전을 포함합니다. 워크로드 클러스터 업데이트와 독립적으로 호스트를 업데이트할 수 있지만 워크로드 클러스터를 업데이트하기 전에 항상 호스트를 업데이트해야 합니다.

AKS 가용성의 중단 및 손실을 방지하기 위해 롤링 업데이트가 수행됩니다. 새 빌드가 있는 새 노드를 클러스터로 가져오면 리소스가 이전 노드에서 새 노드로 이동합니다. 리소스를 성공적으로 제거하면 이전 노드가 서비스 해제되고 클러스터에서 제거됩니다.

참고

Microsoft는 새 릴리스 후 30일 이내에 AKS 클러스터를 업그레이드하는 것이 좋습니다. 이 기간 내에 업데이트하지 않으면 내부 인증서 및 토큰이 만료되기까지 마지막 업그레이드로부터 최대 90일이 필요합니다. 인증서 및 토큰이 만료되면 클러스터는 계속 작동합니다. 그러나 업그레이드하려면 Microsoft 지원 호출해야 합니다. 90일 동안 클러스터를 다시 부팅하면 비기능 상태로 유지됩니다. 내부 인증서 및 토큰에 대한 자세한 내용은 인증서 관리 개요를 참조하세요.

AKS 호스트 업데이트

업데이트 흐름의 첫 번째 단계는 Update-AksHci 명령을 실행하여 AKS 호스트를 업데이트하는 것입니다. Update-AksHci 는 인수를 사용하지 않으며 항상 관리 클러스터를 최신 버전으로 업데이트합니다. Kubernetes 클러스터를 새 버전으로 업데이트하려면 Update-AksHciCluster 를 실행하기 전에 이 단계를 시작해야 합니다.

중요

업데이트 명령은 GA 릴리스 이상을 설치한 경우에만 작동합니다. 이전 릴리스에서는 작동하지 않습니다. 이 업데이트 명령은 AKS 호스트 및 온-프레미스 Microsoft 운영 클라우드 플랫폼을 업데이트합니다. 이 명령은 기존 AKS 워크로드 클러스터를 업데이트하지 않습니다. AKS 호스트를 업데이트한 후 만든 새 AKS 워크로드 클러스터는 OS 버전 및 Kubernetes 버전의 기존 AKS 워크로드 클러스터와 다를 수 있습니다.

AKS 호스트를 업데이트한 직후 AKS 워크로드 클러스터를 업데이트하여 최신 OS 버전 및 최신 수정 사항을 가져오는 것이 좋습니다. 워크로드 클러스터가 AKS Arc의 다음 버전에서 지원되지 않는 Kubernetes 버전에 있는 경우 업그레이드가 실패합니다.

AKS 호스트를 업데이트하기 위한 예제 흐름

PowerShell 모듈 업데이트

AKS 배포의 모든 물리적 노드에서 다음 명령을 실행하여 AKS 노드에 항상 최신 PowerShell 모듈이 설치되어 있는지 확인합니다.

중요

열려 있는 모든 PowerShell 창을 닫은 다음 새 세션을 열어 업데이트 명령을 실행해야 합니다. 모든 PowerShell 창을 닫지 않으면 사용 중이며 업데이트할 수 없는 모듈이 있을 수 있습니다.

Update-Module -Name AksHci -Force -AcceptLicense

현재 AKS Arc 버전 가져오기

Get-AksHciVersion                    

1.0.0.10517

사용 가능한 AKS Arc 업데이트 가져오기

Get-AksHciUpdates

출력에는 이 AKS 호스트를 업데이트할 수 있는 사용 가능한 버전이 표시됩니다.

1.0.2.10723

버전 관리

다음 표에서는 버전 1.0.2.10723을 예로 사용하여 AKS Arc 릴리스에 대해 버전 번호가 생성되는 방법을 보여 줍니다.

값 의미
1 주 버전: 큰 호환성이 손상되는 변경이 있는 각 릴리스에 대해 +1입니다.
0 부 버전: 주요 기능이 변경된 최신 주 버전 이후의 각 릴리스에 대해 +1입니다.
2 기능 & 패치 업데이트: 최신 주 버전 이후의 각 일반(일반적으로 매월) 릴리스에 대해 +1입니다.
1 빌드 유형: 공용 빌드의 경우 항상 1입니다.
0723 빌드 만들기 날짜: 빌드 만들기 날짜(mmdd 형식)입니다.

AKS Arc 업데이트 시작

Update-AksHci

AKS 호스트가 업데이트되었는지 확인

Get-AksHciVersion

출력은 AKS 호스트에서 업데이트된 AKS 버전을 보여 줍니다.

1.0.2.10723

다음 단계