Amazon EKS マネージドアドオンを作成または更新する際、設定の競合を防ぐ方法を教えてください。
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 コンソールを使用する
次の手順を実行します。
- Amazon EKS コンソールを開く。
- [アドオン] タブを選択する。
- アドオンをクリックし、[編集] を選択する。
- [オプションの設定] を選択する。
- 設定値には、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 を使用して適用することができます。
-
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 をノードテイント値に置き換えてください。
-
設定を適用する。次のいずれかのオプションを使用する。
- Amazon EKS コンソール: 「Amazon EKS コンソールを使用する」セクションと同じ手順に従います。
または、 - AWS CLI: 「AWS CLI を使用する」セクションに示されているように、create-addon または update-addon コマンドを**--resolve-conflicts OVERWRITE** パラメータとともに使用します。
- Amazon EKS コンソール: 「Amazon EKS コンソールを使用する」セクションと同じ手順に従います。
関連情報
- トピック
- Containers
- 言語
- 日本語

関連するコンテンツ
AWS公式更新しました 2年前