ALB Ingressコントローラの更新事前チェックの失敗の原因 - Container Service for Kubernetes

このトピックでは、ALB Ingressコントローラーと対応するソリューションを更新するときに発生する可能性のある事前チェックの失敗に関するエラーメッセージを一覧表示します。

注意事項

Before the update

説明

ALB Ingressコントローラーを更新する前に、コンポーネントの最新機能を確認する必要があります。詳細については、「ALB Ingress Controller」をご参照ください。

ALB Ingressコントローラーを更新する前に、kubectl get eventコマンドを実行して、クラスターで調整エラーが発生しているかどうかを確認します。調整の失敗が発生した場合は、問題を修正してから調整を完了する必要があります。和解の失敗の原因を特定できない場合は、チケットを起票します。
ALBコンソールのApplication Load Balancer (ALB) インスタンスとAlbConfigが同じ設定を使用していることを確認します。そうでない場合は、コンポーネントを更新する前に、ALBインスタンスとAlbConfigを変更して同じ設定を使用する必要があります。事前チェックを実行する前に、ALBコンソールでALBインスタンス、リスナー、転送ルール、ネットワークアクセス制御リスト (ACL) 、またはサーバーグループを変更しないでください。それ以外の場合、ALBコンソールの設定はAlbConfigまたはIngressの設定とは異なります。その結果、ALB Ingressコントローラはプレチェックに合格しない。
- ALBインスタンスの設定を使用する場合は、それに応じてAlbConfigまたはIngressの設定を変更します。
- AlbConfigまたはIngressの設定を使用する場合は、kubectl editコマンドを実行して、AlbConfigまたはIngressの設定内の非キーパラメーターを変更し、リコンシリエーションをトリガーします。その後、ALBコンソールのALBインスタンスの設定が自動的に更新されます。 ALBインスタンスの設定を直接変更することもできます。設定を変更した後、ALBインスタンスの設定読み取り専用モードを有効にする必要があります。詳細については、「読み取り専用モードの有効化または無効化」をご参照ください。

アップデート中

事前チェック中に、AlbConfigまたはIngressの設定を変更しないでください。変更は事前チェックの結果に影響します。 AlbConfigまたはIngressの設定を変更した場合は、再度事前チェックを実行します。 ALB Ingressコントローラーが事前チェックに複数回合格しなかった場合、チケットを起票します。

ALB Ingressコントローラーの更新の事前チェックの失敗と解決策のエラーメッセージ

説明

ALB Ingressコントローラーが事前チェックに合格しなかった場合は、Container Service for Kubernetes (ACK) コンソールにログインし、[事前チェック] の下の [詳細の表示] をクリックし、事前チェックレポートを表示して原因を特定します。

ALBインスタンスに関連するエラーメッセージ

エラーメッセージ	原因	解決策
エラーメッセージ	原因	ケース1: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更していません	ケース2: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更しました
CreateALB	ALBインスタンスとAlbConfigは異なる設定を使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	同じ設定を使用するようにALBインスタンスとAlbConfigを変更し、再度事前チェックを実行します。
ReuseALB
UnReuseALB
DeleteALB
UpdateALBAttribute	ALBインスタンスとAlbConfigは、異なるALBインスタンス名や設定保護設定など、異なる属性設定を使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	`kubectl describe albconfig [$Albconfig_Name]` コマンドを実行し、ALBインスタンスとAlbConfigの属性設定を比較し、ALBインスタンスの属性設定を変更してから、再度事前チェックを実行します。
UpdateALBDeletionProtection	ALBインスタンスとAlbConfigは異なる削除保護設定を使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	`kubectl describe albconfig [$Albconfig_Name]` コマンドを実行し、ALBインスタンスとAlbConfigの削除保護設定を比較し、ALBインスタンスの削除保護設定を変更してから、再度事前チェックを実行します。
UpdateALBAccessLog	ALBインスタンスとAlbConfigは異なるアクセスログ設定を使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	同じアクセスログ設定を使用するようにALBインスタンスとAlbConfigを変更します。 ALBインスタンスのアクセスログ設定を使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行して、AlbConfigのアクセスログ設定を変更し、再度事前チェックを実行します。
UpdateALBEdition	ALBインスタンスとAlbConfigは異なるエディション (標準エディションまたはWAF対応エディション) を使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	同じエディションを使用するようにALBインスタンスとAlbConfigを変更し、再度事前チェックを実行します。
UpdateALBResourceGroup	ALBインスタンスとAlbConfigは異なるリソースグループ設定を使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	同じリソースグループ設定を使用するようにALBインスタンスとAlbConfigを変更し、再度事前チェックを実行します。
UpdateALBTag	ALBインスタンスとAlbConfigは異なるラベルを使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	同じラベルを使用するようにALBインスタンスとAlbConfigを変更し、再度事前チェックを実行します。
UpdateALBAddressType	ALBインスタンスとAlbConfigは異なるタイプのネットワークを使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	同じタイプのネットワークを使用するようにALBインスタンスとAlbConfigを変更します。 ALBインスタンスに指定されたネットワークを使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行してAlbConfigのネットワーク設定を変更し、再度事前チェックを実行します。重要ネットワークタイプをプライベートからパブリックに変更すると、elastic IPアドレス (EIP) 更新料金が発生します。作業は慎重に行ってください。ネットワークタイプをパブリックからプライベートに変更すると、関連するすべてのEIPの関連付けが解除され、DNSレコードが変更されます。作業は慎重に行ってください。
UpdateALBBandWidthPackage	ALBインスタンスとAlbConfigは、異なるEIP帯域幅プラン設定を使用します。	もう一度事前チェックを実行します。事前チェック中にAlbConfigの設定を変更しないでください。	同じEIP帯域幅プラン設定を使用するようにALBインスタンスとAlbConfigを変更します。 ALBインスタンスのEIP帯域幅プラン設定を使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行してAlbConfigを変更し、再度事前チェックを実行します。

リスナーに関するエラーメッセージ

エラーメッセージ	原因	解決策
エラーメッセージ	原因	ケース1: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更していません	ケース2: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更しました
CreateALBListener	ALBインスタンスとAlbConfigは異なるリスナーを使用します。	もう一度事前チェックを実行します。事前チェック中にリスナーを変更しないでください。	ALBインスタンスから削除したリスナーを再作成し、再度事前チェックを実行します。 ALBインスタンスのリスナーを使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行して、対応するリスナーをAlbConfigから削除し、再度事前チェックを実行します。
UpdateALBListenerExtraCertificates	ALBインスタンスとAlbConfigは別の追加証明書を使用します。	もう一度事前チェックを実行します。事前チェック中にリスナーを変更しないでください。	ALBインスタンスとAlbConfigを変更して、追加の証明書を使用します。 ALBインスタンスの追加の証明書を使用するには、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行してAlbConfigを変更し、再度事前チェックを実行します。
UpdateALBListenerAttribute	ALBインスタンスとAlbConfigは異なるリスナー属性を使用します。	もう一度事前チェックを実行します。事前チェック中にリスナーを変更しないでください。	証明書、圧縮アルゴリズム、ネットワークACL、アイドル接続のタイムアウト期間、XForwardConfigなどの構成の違いを確認します。 ALBインスタンスのリスナー属性を使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行してAlbConfigを変更し、再度事前チェックを実行します。
DeleteALBListener	ALBインスタンスとAlbConfigは異なるリスナーを使用します。	もう一度事前チェックを実行します。事前チェック中にリスナーを変更しないでください。	ALBインスタンスから追加したリスナーを削除し、再度事前チェックを実行します。 ALBインスタンスのリスナーを使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行して、対応するリスナーをAlbConfigに追加し、再度事前チェックを実行します。

ネットワークACLに関連するエラーメッセージ

エラーメッセージ	原因	解決策
		ケース1: ALBコンソールでネットワークACLのバックエンドサーバー設定を変更していません	ケース2: ALBコンソールでネットワークACLのバックエンドサーバー設定を変更しました
CreateAcl	ネットワークACLとAlbConfigは異なるアクセス制御設定を使用します。	もう一度事前チェックを実行します。事前チェック中にネットワークACLを変更しないでください。	同じアクセス制御設定を使用するようにネットワークACLとAlbConfigを変更します。ネットワークACLのアクセス制御設定を使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行して、AlbConfigのネットワークACLを変更し、再度事前チェックを実行します。
DeleteAcl
AddEntriesToAcl
RemoveEntriesFromAcl
AssociateAclWithListener
DisassociateAclWithListener

転送ルールに関連するエラーメッセージ

エラーメッセージ	原因	解決策
エラーメッセージ	原因	ケース1: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更していません	ケース2: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更しました
CreateALBListenerRules	ALBインスタンスとIngressは異なる転送ルールを使用します。	もう一度事前チェックを実行します。事前チェック中に転送ルールを変更しないでください。	転送ルールを追加してから、再度事前チェックを実行します。
UpdateALBListenerRules	ALBインスタンスとIngressは異なる転送ルールを使用します。	もう一度事前チェックを実行します。事前チェック中に転送ルールを変更しないでください。	同じ転送ルールを使用するようにALBインスタンスとIngressを設定します。 ALBインスタンスの転送ルールを使用する場合は、`kubectl -n [$Namespace] edit ingress [$Ingress_Name]` コマンドを実行してingressの転送ルールを変更し、再度事前チェックを実行します。
DeleteALBListenerRules	ALBインスタンスとIngressは異なる転送ルールを使用します。	もう一度事前チェックを実行します。事前チェック中に転送ルールを変更しないでください。	追加した転送ルールを削除し、再度事前チェックを実行します。

サーバーグループに関連するエラーメッセージ

エラーメッセージ	原因	解決策
エラーメッセージ	原因	ケース1: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更していません	ケース2: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更しました
CreateALBServerGroup	ALBインスタンスとIngressは異なるサーバーグループを使用します。	もう一度事前チェックを実行します。事前チェック中にサーバーグループを変更しないでください。	削除したサーバーグループを再作成してから、再度事前チェックを実行します。
UpdateALBServerGroup	ALBインスタンスとIngressは異なるサーバーグループを使用します。	もう一度事前チェックを実行します。事前チェック中にサーバーグループを変更しないでください。	同じサーバーグループを使用するようにALBインスタンスとIngressを変更します。 ALBインスタンスのサーバーグループを使用する場合は、`kubectl -n [$Namespace] edit ingress [$Ingress_Name]` コマンドを実行して、ingressのサーバーグループを変更し、再度事前チェックを実行します。
DeleteALBServerGroup	ALBインスタンスとIngressは異なるサーバーグループを使用します。	もう一度事前チェックを実行します。事前チェック中にサーバーグループを変更しないでください。	追加したサーバーグループを削除してから、再度事前チェックを実行します。

バックエンドサーバーに関連するエラーメッセージ

エラーメッセージ	原因	解決策
		ケース1: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更していません	ケース2: ALBコンソールでALBインスタンスのバックエンドサーバー設定を変更しました
RegisterALBServers	クラスターとALBインスタンスは異なるバックエンドサーバーを使用します。	もう一度事前チェックを実行します。事前チェック中にバックエンドサーバーを変更しないでください。	ALBインスタンスを変更して、ACKまたはACK Serverlessクラスターと同じバックエンドサーバーを使用し、再度事前チェックを実行します。
DeregisterALBServers
ReplaceALBServers

Container Service for Kubernetes:ALB Ingressコントローラの更新事前チェックの失敗の原因

目次