Azure Kubernetes Service (AKS) クラスターのアップグレードUpgrade an Azure Kubernetes Service (AKS) cluster

AKS クラスターのライフサイクルの一環として、最新の Kubernetes バージョンへのアップグレードが必要になることはよくあります。As part of the lifecycle of an AKS cluster, you often need to upgrade to the latest Kubernetes version. 最新の Kubernetes セキュリティ リリースを適用するか、アップグレードして最新の機能を入手することが重要です。It is important you apply the latest Kubernetes security releases, or upgrade to get the latest features. この記事では、AKS クラスター内のマスター コンポーネントまたは 1 つの既定のノード プールをアップグレードする方法について説明します。This article shows you how to upgrade the master components or a single, default node pool in an AKS cluster.

複数のノード プールまたは Windows Server ノード (どちらも現在 AKS でプレビュー段階) を使用する AKS クラスターについては、AKS 内のノード プールのアップグレードに関するページを参照してください。For AKS clusters that use multiple node pools or Windows Server nodes (both currently in preview in AKS), see Upgrade a node pool in AKS.

開始する前にBefore you begin

この記事では、Azure CLI バージョン 2.0.65 以降を実行している必要があります。This article requires that you are running the Azure CLI version 2.0.65 or later. バージョンを確認するには、az --version を実行します。Run az --version to find the version. インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。If you need to install or upgrade, see Install Azure CLI.

利用できる AKS クラスターのアップグレードを確認するCheck for available AKS cluster upgrades

ご使用のクラスターに利用できる Kubernetes リリースを確認するには、az aks get-upgrades コマンドを使用します。To check which Kubernetes releases are available for your cluster, use the az aks get-upgrades command. 次の例では、myResourceGroup という名前のリソース グループ内の myAKSCluster という名前のクラスターに対して利用できるアップグレードを確認します。The following example checks for available upgrades to the cluster named myAKSCluster in the resource group named myResourceGroup:

az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster --output table


AKS クラスターをアップグレードする際に、Kubernetes マイナー バージョンをスキップすることはできません。When you upgrade an AKS cluster, Kubernetes minor versions cannot be skipped. たとえば、1.11.x -> 1.12.x または 1.12.x -> 1.13.x の間のアップグレードは許可されていますが、1.11.x -> 1.13.x は許可されていません。For example, upgrades between 1.11.x -> 1.12.x or 1.12.x -> 1.13.x are allowed, however 1.11.x -> 1.13.x is not.

1.11.x -> 1.13.x にアップグレードするには、ます 1.11.x -> 1.12.x にアップグレードした後、1.12.x -> 1.13.x にアップグレードしてください。To upgrade, from 1.11.x -> 1.13.x, first upgrade from 1.11.x -> 1.12.x, then upgrade from 1.12.x -> 1.13.x.

次の出力例は、クラスターをバージョン 1.12.7 または 1.12.8 にアップグレードできることを示しています。The following example output shows that the cluster can be upgraded to version 1.12.7 or 1.12.8:

Name     ResourceGroup    MasterVersion  NodePoolVersion  Upgrades
-------  ---------------  -------------  ---------------  --------------
default  myResourceGroup  1.11.9         1.11.9           1.12.7, 1.12.8

AKS クラスターのアップグレードUpgrade an AKS cluster

AKS クラスターに利用できるバージョンの一覧を参照し、az aks upgrade コマンドを使用してアップグレードします。With a list of available versions for your AKS cluster, use the az aks upgrade command to upgrade. アップグレード プロセス中に、AKS は指定された Kubernetes バージョンを実行する新しいノードをクラスターに追加した後、実行中のアプリケーションへの中断を最小限に抑えるために古いノードのいずれかを慎重に切断およびドレインします。During the upgrade process, AKS adds a new node to the cluster that runs the specified Kubernetes version, then carefully cordon and drains one of the old nodes to minimize disruption to running applications. 新しいノードが実行中のアプリケーション ポッドとして確認されたら、その古いノードが削除されます。When the new node is confirmed as running application pods, the old node is deleted. このプロセスは、クラスター内のすべてのノードがアップグレードされるまで繰り返されます。This process repeats until all nodes in the cluster have been upgraded.

次の例では、クラスターをバージョン 1.12.8 にアップグレードします。The following example upgrades a cluster to version 1.12.8:

az aks upgrade --resource-group myResourceGroup --name myAKSCluster --kubernetes-version 1.12.8

ノード数にもよりますが、クラスターのアップグレードには数分かかります。It takes a few minutes to upgrade the cluster, depending on how many nodes you have.

アップグレードが成功したことを確認するには、az aks show コマンドを使用します。To confirm that the upgrade was successful, use the az aks show command:

az aks show --resource-group myResourceGroup --name myAKSCluster --output table

次の出力例は、クラスターが現在 1.12.8 を実行していることを示しています。The following example output shows that the cluster now runs 1.12.8:

Name          Location    ResourceGroup    KubernetesVersion    ProvisioningState    Fqdn
------------  ----------  ---------------  -------------------  -------------------  ---------------------------------------------------------------
myAKSCluster  eastus      myResourceGroup  1.12.8               Succeeded  

次の手順Next steps

この記事では、既存の AKS クラスターをアップグレードする方法について説明しました。This article showed you how to upgrade an existing AKS cluster. AKS クラスターのデプロイと管理の詳細については、一連のチュートリアルを参照してください。To learn more about deploying and managing AKS clusters, see the set of tutorials.