**このページの改善にご協力ください**
このユーザーガイドに貢献するには、すべてのページの右側のペインにある「**GitHub でこのページを編集する**」リンクを選択してください。
# Kubernetes バージョンアップグレードの準備およびクラスターインサイトでの設定ミスのトラブルシューティング
Amazon EKS クラスターインサイトでは、問題の検出と解決のための推奨事項が提供され、クラスターの管理に役立ちます。すべての Amazon EKS クラスターは、Amazon EKS がキュレートしたインサイトのリストと照合して、自動的かつ定期的にチェックされます。これらの*インサイトチェック*は Amazon EKS によって完全に管理され、どのような検出結果にも対処するための推奨事項を提示します。
## クラスターインサイトタイプ
+ **設定インサイト**: クラスターまたはワークロードの機能を損なう可能性のある EKS Hybrid Nodes の設定ミスを特定します。
+ **アップグレードインサイト**: Kubernetes の新しいバージョンにアップグレードする機能に影響を与える可能性のある問題を特定します。
+ **ロールバックの準備状況インサイト**: アップグレード後に以前の Kubernetes バージョンにロールバックする機能に影響を与える可能性のある問題を特定します。
## 考慮事項
+ **頻度**: Amazon EKS は、クラスターインサイトを 24 時間ごとに更新します。また、最新のステータスを確認するときには、手動で更新することもできます。例えば、問題に対処した後でクラスターインサイトを手動で更新して、実際に問題が解決したかどうかを確認できます。
+ **アクセス許可**: Amazon EKS は、すべての EKS クラスターでクラスターインサイトのクラスターアクセスエントリを自動的に作成します。このエントリは、クラスターに関する情報を表示するアクセス許可を EKS に付与します。Amazon EKS は、この情報を使用してインサイトを生成します。詳細については、「[AmazonEKSClusterInsightsPolicy](access-policy-permissions.md#access-policy-permissions-AmazonEKSClusterInsightsPolicy)」を参照してください。
+ **ロールバックの準備状況の可用性**: ロールバックの準備状況インサイトは、過去 7 日以内にアップグレードされたクラスターでのみ使用できます。7 日間のロールバック資格期間が終了すると、これらのインサイトはクラスターに対して生成されなくなります。
## ユースケース
Amazon EKS のクラスターインサイトは、Kubernetes クラスターの健全性、信頼性、および最適な設定を維持するのに役立つ自動チェックを提供します。以下は、アップグレードの準備状況や設定のトラブルシューティングを含む、クラスターインサイトの主要なユースケースです。
### アップグレードインサイト
アップグレードインサイトは、クラスターインサイト内の特定のタイプのインサイトチェックです。これらのチェックは Kubernetes バージョンアップグレードの準備状況に関するインサイトを返します。Amazon EKS は、すべての EKS クラスターでアップグレードインサイトチェックを実行します。
**重要**
Amazon EKS では、特定のクラスターインサイトの問題が発生した際に `--force` フラグでのクラスターアップグレードが必要となる機能が一時的にロールバックされています。詳細については、GitHub の「[Temporary rollback of enforcing upgrade insights on update cluster version](https://github.com/aws/containers-roadmap/issues/2570)」を参照してください。
クラスターの更新に関する詳細については、「[ステップ 3: クラスターコントロールプレーンを更新する](update-cluster.md#update-cluster-control-plane)」を参照してください。
クラスターの Kubernetes バージョンを更新する前に、[Amazon EKS コンソール](https://console.aws.amazon.com/eks/home#/clusters)のオブザーバビリティダッシュボードにある **[アップグレード]** タブを使用できます。クラスターに問題が見つかった場合は、確認して適切な修正を行います。問題には、Amazon EKS および Kubernetes のドキュメントへのリンクも含まれます。問題を修正したら、オンデマンドでクラスターインサイトを更新して、最新のインサイトを取得してください。すべての問題が解決したら、[クラスターを更新](update-cluster.md)します。
Amazon EKS は Kubernetes バージョンアップグレードの準備状況に関するインサイトを返します。アップグレードインサイトは、Kubernetes クラスターのアップグレードに影響する可能性のある問題を特定します。これにより、管理者がアップグレードの準備に費やす労力が最小限に抑えられ、新しい Kubernetes バージョンでのアプリケーションの信頼性が高まります。クラスターは、Amazon EKS によって Kubernetes バージョンアップグレードに影響する可能性のある問題のリストと照合して自動的にスキャンされます。Amazon EKS は、各 Kubernetes バージョンリリースで行われた変更のレビューに基づいて、インサイトチェックのリストを頻繁に更新します。
Amazon EKS のアップグレードインサイトにより、新しいバージョンのテストと検証のプロセスがスピードアップします。また、クラスター管理者やアプリケーション開発者は、懸念事項を浮き彫りにし、修正に関するアドバイスを提供することで、最新の Kubernetes 機能を活用できます。
### 設定インサイト
EKS クラスターインサイトは、ハイブリッドノードを使用して Amazon EKS クラスターを自動的にスキャンし、Kubernetes コントロールプレーンからウェブフックへの通信、exec やログなどの kubectl コマンドなどに障害をもたらす設定の問題を特定します。設定インサイトは問題を明らかにし、修復に関する推奨事項を提供し、完全に機能するハイブリッドノードのセットアップまでの時間を短縮します。
### ロールバックの準備状況インサイト
ロールバックの準備状況インサイトは、クラスターインサイト内の特定のタイプのインサイトチェックです。これらのチェックは Kubernetes バージョンのロールバック準備状況に関するインサイトを返します。Amazon EKS は、過去 7 日以内にアップグレードされたクラスターに対してロールバックの準備状況インサイトチェックを実行します。ロールバックの準備状況インサイトはポイントインタイムチェックであり、継続的にではなく、評価時のクラスターの状態を反映します。
クラスターの Kubernetes バージョンをアップグレードした後、[Amazon EKS コンソール](https://console.aws.amazon.com/eks/home#/clusters)のオブザーバビリティダッシュボードにある **[アップグレードインサイト]** タブを使用して、ロールバック準備インサイトをレビューできます。クラスターに問題が見つかった場合は、確認して適切な修正を行います。問題には、Amazon EKS および Kubernetes のドキュメントへのリンクも含まれます。問題を修正したら、オンデマンドでクラスターインサイトを更新して、最新のインサイトを取得してください。すべての問題が解決したら、ロールバックを続行できます。
Amazon EKS は `ROLLBACK_READINESS` カテゴリの下に Kubernetes バージョンのロールバック準備状況に関するインサイトを返します。ロールバックの準備状況インサイトは、Kubernetes クラスターバージョンのロールバックに影響を与える可能性のある問題を特定します。これにより、管理者がロールバックの準備に費やす労力が最小限に抑えられ、以前のバージョンへの復元の信頼性が高まります。クラスターは、API の使用の互換性 (以前の API バージョンが削除された API バージョン卒業中の非互換性チェック、目的のバージョンに存在しない新しいリソース、および新しいフィールドや列挙型の変更をカバーする)、クラスターの状態、kubelet と kube-proxy のバージョンスキュー、EKS マネージドアドオンの互換性、および Auto Mode クラスターの中断予算と注釈チェックなど、ロールバックに影響する可能性のある問題のリストに対して Amazon EKS によって自動的にスキャンされます。
**注記**
ロールバックの準備状況インサイトは、EKS マネージドアドオンバージョンのみをチェックします。セルフマネージドアドオンの場合、または EKS アドオンライフサイクルの外部でマネージドアドオンのバージョンを上書きした場合、インサイトはバージョンの非互換性を検出しません。ユーザーには、ロールバックする前に、これらのアドオンとターゲットバージョンとの互換性を検証する責任があります。
ERROR または UNKNOWN ステータスがあるインサイトは、問題が解決されるまでロールバックをブロックします。自分のリスクで続行する場合は、`--force` フラグを使用してインサイトチェックをバイパスできます。WARNING ステータスがあるインサイトは助言的なものであり、ロールバックを妨げません。詳細については、「[以前の Kubernetes バージョンにクラスターをロールバックする](rollback-cluster.md)」を参照してください。
## はじめに
実行されたインサイトチェックのリストと、Amazon EKS によって特定された関連する問題を確認するには、AWS マネジメントコンソール、AWS CLI、AWS SDK、および Amazon EKS `ListInsights` API オペレーションを使用できます。開始するには、[クラスターインサイトを表示する](view-cluster-insights.md) を参照してください。