スキップしてコンテンツを表示

Amazon EKS マネージドアドオンを作成または更新する際、設定の競合を防ぐ方法を教えてください。

所要時間3分
0

Amazon Elastic Kubernetes Service (Amazon EKS) マネージドアドオンの作成または更新を行う際、設定が競合しないようにしたいです。

簡単な説明

AWS コマンドラインインターフェイス (AWS CLI) を使用して Amazon EKS マネージドアドオンの設定を変更すると、設定が競合することがあります。これらの競合を管理する方法を指定しない場合、次のエラーメッセージが表示されます。

"Conflicts found when trying to apply.Will not continue due to resolve conflicts mode."

この問題を解決するには、次のいずれかの操作を行います。

  • 設定の競合を自動的に管理する Amazon EKS コンソールを使用して設定を更新する。
  • AWS CLI で resolve-conflicts OVERWRITE パラメータを使用して、既存の設定を明示的に上書きする。

解決策

注: AWS CLI コマンドを実行したときにエラーが発生した場合は、「AWS CLI のエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。

設定を JSON ファイルに書き込む

使用するアドオンに基づいて JSON ファイルに設定を書き込みます。アドオン設定オプションの詳細については、GitHub ウェブサイトの「amazon-vpc-cni-k8s」、「aws-ebs-csi-driver」、「coredns」を参照してください。

Amazon Virtual Private Cloud (Amazon VPC) CNI アドオン

cat <<EOF > example-json-file
{
    "env": {
        "MINIMUM_IP_TARGET": "example-minimum-ip-target",
        "WARM_ENI_TARGET": "example-warm-eni-target",
        "WARM_IP_TARGET": "example-ip-target"
      }
}
EOF

注: example-minimum-ip-target を、各ノードが維持すべき最小の IP アドレス数に置き換えてください。また、example-warm-eni-target を、ポッド割り当てのためにアドオンが利用可能な状態を保持すべき Elastic network interface の数に置き換えてください。最後に、example-ip-target を、ポッド割り当てのためにアドオンが利用可能な状態を保持すべき IP アドレスの数に置き換えてください。

Amazon Elastic Block Store (Amazon EBS) CSI ドライバーアドオン

cat <<EOF > example-json-file  
{  
    "node": {  
        "volumeAttachLimit": example-volume-limit  
    }  
}  
EOF

注: example-volume-limit を、Amazon EBS CSI ドライバーアドオンがノードにアタッチできるボリュームの最大数に置き換えてください。この値は、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスタイプのボリュームアタッチメントクォータ以下でなければなりません。

CoreDNS

cat <<EOF > example-json-file  
{  
    "resources": {  
        "limits": {  
            "cpu": "example-cpu-limit",  
            "memory": "example-memory-limit",  
        },  
        "requests": {  
            "cpu": "example-cpu-request",  
            "memory": "example-memory-request"  
        }  
    }  
}  
EOF

注: example-cpu-limit を CoreDNS が使用可能な最大 CPU に、example-memory-limit を CoreDNS が使用可能な最大メモリリソースに置き換えてください。また、example-cpu-request を CoreDNS の実行に必要な最小 CPU に、example-memory-request を CoreDNS の実行に必要な最小のメモリリソースに置き換えてください。

JSON ファイルをアドオンに適用する

Amazon EKS コンソールを使用する

次の手順を実行します。

  1. Amazon EKS コンソールを開く。
  2. [アドオン] タブを選択する。
  3. アドオンをクリックし、[編集] を選択する。
  4. [オプションの設定] を選択する。
  5. 設定値には、JSON ファイルの設定を入力する。

AWS CLI を使用する

アドオンを初めてインストールするときに JSON ファイルを適用するには、次の create-addon コマンドを実行します。

aws eks create-addon --addon-name add-on --cluster-name example-cluster-name --resolve-conflicts OVERWRITE --configuration-values file://example-json-file

注: example-cluster-name を Amazon EKS クラスターの名前に置き換えてください。また、Amazon VPC CNI アドオンの場合は add-on を vpc-cni に、Amazon EBS CSI ドライバーアドオンの場合は aws-ebs-csi-driver に、CoreDNS アドオンの場合は coredns に、それぞれ置き換えてください。最後に、example-json-file を JSON 設定ファイルの名前に置き換えてください。

JSON ファイルを既存のアドオンに適用するには、次の update-addon コマンドを実行します。

aws eks update-addon --addon-name add-on --cluster-name example-cluster-name --resolve-conflicts OVERWRITE --configuration-values file://example-json-file

注: example-cluster-name を Amazon EKS クラスターの名前に置き換えてください。また、Amazon VPC CNI アドオンの場合は add-on を vpc-cni に、Amazon EBS CSI ドライバーアドオンの場合は aws-ebs-csi-driver に、CoreDNS アドオンの場合は coredns に、それぞれ置き換えてください。最後に、example-json-file を JSON 設定ファイルの名前に置き換えてください。

アップデートをテストする

アドオンが更新された設定を使用していることを確認するには、使用しているアドオンに応じて次のコマンドを実行します。

Amazon VPC CNI と CoreDNS

kubectl get pods -n kube-system example-aws-node-pod-ID -o jsonpath='{.spec.containers[*].env}'

注: example-aws-node-pod-ID をノードポッド ID または CoreDNS ポッド ID に置き換えてください。

Amazon EBS CSI ドライバー

kubectl get ds -n kube-system ebs-csi-node -o jsonpath='{.spec.template.spec.containers[*].args}'

許容範囲を更新

アドオンのノード許容範囲を更新する必要がある場合は、設定ファイルにその情報を含めることができます。他の設定変更と同様、これらの更新は Amazon EKS コンソールまたは AWS CLI の resolve-conflicts OVERWRITE を使用して適用することができます。

  1. YAML 形式で許容範囲設定を作成する。

    cat <<EOF > example-yaml-file
    tolerations:
          - effect: example-effect
            key: example-key
            operator: example-operator
            value: example-value
    EOF

    注: example-yaml-file を YAML 設定ファイル名に置き換えてください。また、example-effect を NoSchedule、PreferNoSchedule、NoExecute のいずれかに置き換え、example-operator をEqual または Exists に置き換えてください。最後に、example-key をノードテイントキーに、example-value をノードテイント値に置き換えてください。

  2. 設定を適用する。次のいずれかのオプションを使用する。

    • Amazon EKS コンソール: 「Amazon EKS コンソールを使用する」セクションと同じ手順に従います。
      または、
    • AWS CLI: 「AWS CLI を使用する」セクションに示されているように、create-addon または update-addon コマンドを**--resolve-conflicts OVERWRITE** パラメータとともに使用します。

関連情報

Amazon EKS アドオンのためにカスタマイズできるフィールドを決定する

Amazon EKS アドオン: Advanced configuration

AWS公式更新しました 1年前
コメントはありません

関連するコンテンツ