Kubernetesへの移行のトラブルシューティング

移行のどこにいますか？

まず、status.conditions[type=Migrating] 条件の reason フィールドを読み取ります。

優先順位は Validating > Extending > Pruning > InProgress です。Kubernetes 側の削除と拡大の両方を行うプルーンは Extending を報告します。これもまた、変更を1つずつ行う別の理由です。

Pruningとextendingを同時に行うことはできません。

移行の完了をスクリプトで処理するには、status.phaseをポーリングするのではなく、kubectl wait --for=condition=Migrating=Falseを使用してください。

• 状態が Extending のままである場合、Kubernetes 演算子 が追加している Kubernetes ノードはまだプロビジョニング中です。目標状態に達するまで待機してください。

• 理由が InProgress のままで、外部ノード数に変更がない場合、リソースへの最後の編集はノーオペレーションでした。Kubernetes 演算子 はアクションを必要とする変更を検出しませんでした。

プラグインのインポートの失敗

kubectl mongodb migrate-to-mck プラグインは、リソースを生成する前にソースオートメーション設定を検証します。次の各ケースでは、不完全または不正なリソースを生成するのではなく、エラーで終了します。

• MongoDB Ops ManagerまたはCloud Managerプロジェクトには、複数の配置があります。

• このプロジェクトには、複数のシャーディングされたクラスターがあります。

• プロジェクトには、シャーディングされたクラスターの一部ではないレプリカセットがあります。

• プロジェクトには、レプリカセットやシャーディングされたクラスターはありません。このプラグインは、レプリカセットとシャーディングされたクラスターの配置のみを移行できます。

• オートメーション設定にはプロセスがありません。

• シャーディングされたクラスター内のシャードは、コンフィギュレーションサーバーと同じレプリカセットによってバックアップされています。この組み込みコンフィギュレーションサーバーのトポロジーは移行にはサポートされていません。

• プラグインは、レプリカセット内で投票可能かつ優先順位の対象となるノードを見つけることができないため、そのレプリカセットのソースプロセスを特定できません。

• プロセスは mongod または mongos 以外の processType を持っています。

設定不可能なパスと設定の不一致

プラグインは、Kubernetes 演算子 が期待する設定と一致しない場合に、次のオートメーション構成設定にフラグを立てます。

• auth.keyFile Kubernetes 演算子が spec.downloadBase から引き出されるパスとは異なります。

• auth.keyFileWindows が設定されています。

• monitoringAgentConfig.logPath または、backupAgentConfig.logPath がデフォルト以外のパスに設定されている場合。

• プロセスには、Kubernetes 演算子のデフォルトとは異なる authSchemaVersion があります。

認証エラー

• auth.autoUser は、認証が有効な間は空です。

• auth.autoUser そのデータベースの auth.usersWanted に一致するエントリがありません。一致するエントリがない場合、移行後にエージェントの認証が失敗します。

• MONGODB-X509 エージェント認証には、オートメーション構成で tls.autoPEMKeyFilePath を設定する必要があります。詳細については、「spec.security.authentication.agents.autoPEMKeyFilePath」を参照してください。

• simple 以外の LDAP bindMethod は、移行ではサポートされていません。

ノードの不均一性

Kubernetes 演算子は、単一のソースプロセスからspec.additionalMongodConfigとspec.agent.mongod.systemLogを取得します。レプリカセットのノードの構成が異なる場合は、移行前にすべてのノードを検討して差異を調整してください。生成されたリソースは、すべてのKubernetesノードに1つの構成を適用します。

対処すべき警告

以下のプロセスごとのオートメーション設定は、新しいKubernetesノードには引き継がれません。移行する前に、それらの設定を計画してください。

• secondaryDelaySecs

• 非表示メンバー

• buildIndexes: false

ソース配置に分析ノードまたは遅延ノードが含まれている場合は、開始する前に Kubernetes 内でそれらをどのように表現するかを計画してください。

その他に検討する項目:

• このプラグインは無効なプロセスをスキップするため、外部ノードとしては表示されません。

• TLSが設定されていないプロセスがある場合は、移行前に、既存の仮想マシン配置のMongoDB Ops ManagerまたはCloud Managerで、net.tls.modeをdisabledに設定してください。生成されたMongoDBリソースにはこれを設定しないでください。そうしないと、KubernetesノードのTLS設定がソースプロセスと一致せず、移行によって予期しない配置変更が発生します。

• プロセスの logRotate または auditLogRotate 設定がプロジェクトレベルの構成と異なる場合、Kubernetes 演算子 はプロジェクトレベルの値を使用します。

バージョン ミスマッチ

mongodb.com/migrate-tool-version アノテーションは、リソースを生成した kubectl mongodb migrate-to-mck プラグインのバージョンを記録します。Kubernetes 演算子は、ドライ実行する中を含め、reconcile ごとにこのアノテーションを自身のバージョンと照合して検証します。バージョンに互換性がない場合は、互換性のあるプラグイン バージョンを使用してリソースを再生成してください。

ドライランの問題

TLS CA ミスマッチ

Kubernetesノードの証明書は、仮想マシンのノードの証明書に署名した認証局と同じ認証局によって発行される必要があります。そうでない場合、仮想マシンとKubernetesノード間の接続検証とレプリケーションは失敗します。

memberConfig 問題点

• spec.memberConfig spec.members よりエントリーが少ない。ノードごとに1つのエントリを追加してください。

• Kubernetes 演算子は、シャーディングされたクラスターの最上位のspec.memberConfigフィールドを無視します。

命名の問題

リソース名またはレプリカセット名が長すぎるか、有効な RFC 1123 名ではありません。有効なKubernetes名を指定するには、spec.replicaSetNameOverrideまたは--resource-name-overrideを使用してください。

検証の驚き

• 検証は、実際の移行を開始した後だけでなく、ドライランアノテーション（mongodb.com/migration-dry-run）が設定されている間も実行される可能性があります。

• 制限を超える変更が間接的に適用された場合、投票ノードの制限検証は admission time ではなく、reconcile 時に発生する可能性があります。

• 1つの編集にあまりにも多くの変更をバッチすると、配置がクォーラムを失う可能性があります。変更は一度に1種類のみを行ってください。Kubernetes ノードの追加、外部ノードの削除、または投票と優先順位の変更など。

収集する診断

上記のセクションを実行しても問題が持続する場合は、サポートに問い合わせる前に次の情報を収集してください。

• status.conditions を含む MongoDB リソース YAML:

  kubectl get mdb <resource-name> -n <namespace> -o yaml

• 配置の MongoDBUser リソース。

• Kubernetes 演算子のログ。

• 接続バリデーター ジョブの pod ログ。

• MongoDB Ops ManagerまたはCloud Managerのオートメーション設定JSON。

次に、テクニカル サポートに問い合わせてください。

詳細

• 自己管理型配置を Kubernetes に移行する

• レプリカセットを Kubernetes に移行する

• MongoDB 移行リソース設定

• 移行する-to-mck プラグイン コマンド 参照