Amazon EKS アドオンの更新

クラスターにインストールされている現在のアドオンおよびアドオンのバージョンを確認します。my-cluster を自分のクラスター名に置き換えます。

eksctl get addon --cluster my-cluster

出力例は次のとおりです。

NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0                v1.23.8-eksbuild.2
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0                v1.12.0-eksbuild.1,v1.11.4-eksbuild.1,v1.11.3-eksbuild.1,v1.11.2-eksbuild.1,v1.11.0-eksbuild.1

クラスターにあるアドオンおよびバージョンによって、出力が異なる場合があります。前述の出力例では、クラスターの既存のアドオン 2 つは UPDATE AVAILABLE 列に新しいバージョンがあることがわかります。

アドオンを更新します。

1. デバイスに沿ったコマンドをコピーします。必要に応じてコマンドに次の変更を加えます。

   • my-cluster を自分のクラスター名に置き換えます。

   • region-code をクラスターのある AWS リージョン に置き換えます。

   • vpc-cni を更新する前のステップの出力で返されたアドオンの名前に置き換えます。

   • 利用可能な最新バージョンよりも前のバージョンに更新する場合、latest を使用する前のステップの出力で返されたバージョン番号に置き換えます。一部のアドオンには推奨バージョンがあります。詳細については、更新するアドオンのドキュメントを参照してください。

   • アドオンが Kubernetes サービスアカウントおよび IAM ロールを使用する場合、111122223333 をアカウント ID に置き換え、role-name を作成した既存の IAM ロールの名前に置き換えます。ロールの作成手順については、作成するアドオンのドキュメントを参照してください。サービスアカウントロールを指定するには、クラスター用に IAM OpenID Connect (OIDC) プロバイダーが必要です。クラスター用に持っているかどうかを確認、あるいは作成するには、「クラスターの IAM OIDC プロバイダーを作成する」を参照してください。

     アドオンが Kubernetes サービスアカウントおよび IAM ロールを使用しない場合、serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name 行を削除してください。

   • preserve オプションはアドオンの既存値を保存します。アドオン設定にカスタム値を設定していて、このオプションを使用しない場合、Amazon EKS は値をデフォルト値で上書きします。このオプションを使用する場合、実稼働クラスターのアドオンを更新する前に、非稼動クラスターのフィールドおよび値変更をテストすることをお勧めします。この値を overwrite に変更する場合、すべての設定が Amazon EKS のデフォルト値に変更されます。いずれかの設定にカスタム値を設定した場合、Amazon EKS のデフォルト値で上書きされる可能性があります。この値を none に変更した場合、Amazon EKS は設定の値を一切変更しませんが、更新が失敗する可能性があります。更新に失敗した場合、競合の解決に役立つエラーメッセージが返されます。

     cat >update-addon.yaml <<EOF
     apiVersion: eksctl.io/v1alpha5
     kind: ClusterConfig
     metadata:
       name: my-cluster
       region: region-code
     
     addons:
     - name: vpc-cni
       version: latest
       serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name
       resolveConflicts: preserve
     EOF
     

2. 変更コマンドを実行して update-addon.yaml ファイルを作成します。

3. クラスターに設定ファイルを適用します。

   eksctl update addon -f update-addon.yaml
   

アドオンの更新の詳細については、eksctl ドキュメントの「アドオンの更新」を参照してください。

Amazon EKS コンソール (https://console.aws.amazon.com/eks/home#/clusters) を開きます。

左のナビゲーションペインで [クラスター] を選択します。

アドオンを更新するクラスターの名前を選択します。

[アドオン] タブを選択します。

更新するアドオンを選択します。

[編集] を選択します。

[アドオンの名前を設定] ページで、次を実行します:

1. 使用する [バージョン] を選択します。アドオンには推奨バージョンがある場合があります。詳細については、更新するアドオンのドキュメントを参照してください。

2. [IAM ロールの選択] では、ノードの IAM ロール ([未設定])、またはアドオンで使用するために作成した既存のロールを使用できます。選択するロールがない場合、既存のロールがありません。選択したオプションを問わず、作成するアドオンのドキュメントを参照し、IAM ポリシーを作成してロールにアタッチしてください。IAM ロールを選択するには、クラスター用に IAM OpenID Connect (OIDC) プロバイダーが必要です。クラスター用に持っているかどうかを確認、あるいは作成するには、「クラスターの IAM OIDC プロバイダーを作成する」を参照してください。

3. [オプションの構成設定] を展開します。

4. [設定値] で、アドオン固有の設定情報を入力します。詳細については、更新するアドオンのドキュメントを参照してください。

5. [コンフリクト解決方法] で、いずれかのオプションを選択します。アドオン設定にカスタム値を設定している場合、[保存] オプションをお勧めします。このオプションを選択しない場合、Amazon EKS は値をデフォルト値で上書きします。このオプションを使用する場合、実稼働クラスターのアドオンを更新する前に、非稼動クラスターのフィールドおよび値変更をテストすることをお勧めします。

[Save changes] (変更の保存) をクリックします。

インストールされているアドオンのリストを参照してください。my-cluster を自分のクラスター名に置き換えます。

aws eks list-addons --cluster-name my-cluster

出力例は次のとおりです。

{
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni"
    ]
}

更新するアドオンの現在のバージョンを表示します。my-cluster をクラスターの名前に置き換えて、vpc-cni を更新するアドオンの名前に置き換えます。

aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni --query "addon.addonVersion" --output text

出力例は次のとおりです。

v1.10.4-eksbuild.1

クラスターのバージョンで使用できる アドオンのバージョンを確認します。1.31 をクラスターのバージョンに置き換えて、vpc-cni を更新するアドオンの名前に置き換えます。

aws eks describe-addon-versions --kubernetes-version 1.31 --addon-name vpc-cni \
    --query 'addons[].addonVersions[].{Version: addonVersion, Defaultversion: compatibilities[0].defaultVersion}' --output table

出力例は次のとおりです。

------------------------------------------
|          DescribeAddonVersions         |
+-----------------+----------------------+
| Defaultversion  |       Version        |
+-----------------+----------------------+
|  False          |  v1.12.0-eksbuild.1  |
|  True           |  v1.11.4-eksbuild.1  |
|  False          |  v1.10.4-eksbuild.1  |
|  False          |  v1.9.3-eksbuild.1   |
+-----------------+----------------------+

Defaultversion 列に True と表示されているバージョンは、デフォルトでアドオンが作成されたバージョンです。

アドオンを更新してください。デバイスに沿ったコマンドをコピーします。必要に応じてコマンドに次の変更を加え、変更したコマンドを実行します。このコマンドの詳細については、「Amazon EKS コマンドラインリファレンス」の「update-addon」を参照してください。

aws eks update-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version version-number \
    --service-account-role-arn arn:aws:iam::111122223333:role/role-name --configuration-values '{}' --resolve-conflicts PRESERVE

更新のステータスを確認します。my-cluster をクラスターの名前に置き換えて、vpc-cni を更新するアドオンの名前に置き換えます。

aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni

出力例は次のとおりです。

{
    "addon": {
        "addonName": "vpc-cni",
        "clusterName": "my-cluster",
        "status": "UPDATING",
[...]

ステータスが ACTIVE に変わると更新が完了します。