ALB Ingress Controller アップグレード事前チェック失敗のトラブルシューティング - ACK

このトピックでは、ALB Ingress Controller コンポーネントをアップグレードする際に発生する可能性のある事前チェックの失敗に関するエラーメッセージと、そのソリューションについて説明します。

注意事項

アップグレード前

説明

コンポーネントをアップグレードする前に、その新機能についてご確認ください。詳細については、「ALB Ingress Controller」をご参照ください。

事前チェックの前に、kubectl get event コマンドを実行して、クラスター内のリコンサイルの失敗を確認します。失敗が存在する場合は、問題を解決してリコンサイルを完了してください。
ALB コンソールの構成が Albconfig の構成と一致していることを確認してください。一致しない場合は、アップグレードする前に一致させてください。事前チェックの前に、ALB コンソールで ALB インスタンス、リスナー、転送ルール、ACL、またはサーバーグループの構成を変更しないでください。変更すると、ALB コンソールの構成が Albconfig または Ingress の構成と一致しなくなり、アップグレードの事前チェックが失敗します。
- ALB コンソールの構成を使用する場合は、Albconfig または Ingress の構成を変更して、ALB コンソールの構成と一致させてください。
- Albconfig または Ingress の構成を使用する場合は、kubectl edit コマンドを実行して、Albconfig または Ingress 構成ファイルの非キーフィールドを変更し、リコンサイルの更新をトリガーします。これにより、ALB コンソールの構成が更新されます。または、ALB コンソールの構成を直接変更して、Albconfig または Ingress の構成と一致させることもできます。この操作を実行した後、ALB インスタンスの設定変更保護を有効にします。詳細については、「設定変更保護の有効化または無効化」をご参照ください。

アップグレード中

事前チェック中は、誤った結果を防ぐために Albconfig または Ingress の構成を変更しないでください。変更を加えた場合は、事前チェックを再実行してください。

ALB Ingress Controller のアップグレード事前チェックの失敗に関するエラーメッセージとソリューション

説明

事前チェックが失敗した場合は、Container Service for Kubernetes コンソールにログインします。[事前チェック] をクリックし、次に [詳細の表示] をクリックして [チェックレポート] を表示し、失敗の原因を特定します。

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

エラーメッセージ	原因	ソリューション
エラーメッセージ	原因	シナリオ 1: ALB コンソールの ALB インスタンスのバックエンドサーバー構成を変更していない場合	シナリオ 2: ALB コンソールの ALB インスタンスのバックエンドサーバー構成を手動で変更した場合
CreateALB	ALB インスタンスの構成が Albconfig の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に Albconfig を変更しないでください。	ALB インスタンスの構成を Albconfig の構成と一致させてください。その後、事前チェックを再実行してください。
ReuseALB
UnReuseALB
DeleteALB
UpdateALBAttribute	インスタンス名や設定変更保護のステータスなど、ALB インスタンスの属性が Albconfig の設定と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に Albconfig を変更しないでください。	`kubectl describe albconfig [$Albconfig_Name]` コマンドを実行して、ALB インスタンスと Albconfig の属性構成を比較します。コンソールで、ALB インスタンスの属性構成を Albconfig と一致するように復元します。その後、事前チェックを再実行してください。
UpdateALBDeletionProtection	ALB インスタンスの削除保護ステータスが Albconfig の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に Albconfig を変更しないでください。	`kubectl describe albconfig [$Albconfig_Name]` コマンドを実行して、Albconfig の削除保護ステータスを確認します。ALB コンソールで、ALB インスタンスの削除保護構成を Albconfig と一致するように復元します。その後、事前チェックを再実行してください。
UpdateALBAccessLog	ALB インスタンスのアクセスログ構成が Albconfig の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に Albconfig を変更しないでください。	ALB インスタンスのアクセスログ構成を Albconfig の構成と一致させてください。ALB コンソールのアクセスログ構成を使用する場合は、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行して、Albconfig のアクセスログ構成を更新します。その後、事前チェックを再実行してください。
UpdateALBEdition	ALB インスタンスのエディション (標準または WAF 有効) が Albconfig の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に 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 が削除され、名前解決が変更されます。注意して進めてください。
UpdateALBBandWidthPackage	ALB インスタンスの共有帯域幅パッケージが Albconfig の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に Albconfig を変更しないでください。	ALB インスタンスの共有帯域幅パッケージを Albconfig の構成と一致させてください。ALB コンソールの共有帯域幅パッケージ構成を使用する場合は、`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 の間で一致しません。	事前チェックを再実行してください。事前チェック中にリスナーを変更しないでください。	証明書、圧縮アルゴリズム、アクセスコントロールポリシー、アイドル接続タイムアウト、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 を変更しないでください。	Albconfig と ALB コンソールの ACL 構成が同じであることを確認してください。コンソールの構成を採用するには、`kubectl edit albconfig [$Albconfig_Name]` コマンドを実行して、Albconfig 内の対応するアクセスコントロールポリシーグループを更新します。その後、事前チェックを再度実行してください。
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 の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に ServerGroup を変更しないでください。	削除されたサーバーグループを追加します。その後、事前チェックを再実行してください。
UpdateALBServerGroup	ALB インスタンスのサーバーグループ構成が Ingress の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に ServerGroup を変更しないでください。	ALB インスタンスと Ingress のサーバーグループ構成を一致させてください。ALB コンソールのサーバーグループ構成を使用する場合は、`kubectl -n [$Namespace] edit ingress [$Ingress_Name]` コマンドを実行して、Ingress のサーバーグループ構成を更新します。その後、事前チェックを再実行してください。
DeleteALBServerGroup	ALB インスタンスのサーバーグループ構成が Ingress の構成と一致しません。	事前チェックを再実行してください。アップグレードの事前チェック中に ServerGroup を変更しないでください。	追加されたサーバーグループを削除します。その後、事前チェックを再実行してください。

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

エラーメッセージ	原因	ソリューション
		ケース 1: ALB コンソールの ALB インスタンスのバックエンドサーバー構成が変更されていない場合。	ケース 2: ALB コンソールの ALB インスタンスのバックエンドサーバー構成が手動で変更された場合。
RegisterALBServers	クラスターと ALB インスタンスが異なるバックエンドサーバーを使用しています。	事前チェックを再度実行してください。事前チェック中にバックエンドサーバーを変更しないでください。	ALB インスタンスのバックエンドサーバー構成を、ACK または Serverless Kubernetes クラスターのサーバーノードと一致するように復元します。その後、事前チェックを再度実行してください。
DeregisterALBServers
ReplaceALBServers

Container Service for Kubernetes:ALB Ingress Controller コンポーネントのアップグレード事前チェックの失敗

目次