Cells: コホート 0 移行
概要
コホート 0 は、Legacy Cell から Protocell への 100 のトップレベルグループ（TLG）の初期移行を表します。まず 100 の TLG が Organization に変換され（1:1 マッピング）、次にこれらの Organization が Protocell に移行されます。 このコホートは、後続のコホートで使用される移行パターンを確立・検証するための基盤として機能します。
注意: コホート 0 にはテストアカウントとテストユーザーのみが含まれるため、ロールバック計画や Legacy Cell に戻す計画はありません。移行は前進のみの繰り返し可能なプロセスとして設計されており、複数回テストできます（プロビジョニング、移行、削除）。ロールバック戦略は本番データを含む後続のコホートで評価されます。
移行プロセス
sequenceDiagram
participant Legacy as Legacy Cell<br/>(GCP)
participant DMS as データベース移行<br/>サービス (DMS)
participant Proto as Protocell<br/>(AWS)
rect rgb(200, 220, 240)
Note over Legacy,Proto: Organization 変換
end
rect rgb(200, 220, 240)
Note over Legacy,Proto: Legacy Cell と Protocell のプロビジョニング/設定
end
Note over Legacy,Proto: 移行ステップ 1: データベース移行 (DMS)
Legacy->>Legacy: デプロイを停止
Proto->>Proto: デプロイを停止
Legacy->>Proto: バージョン同等性を確保
Legacy->>Legacy: 実行中の PDM（デプロイ後移行）がないことを確認
Proto->>Proto: 実行中の PDM（デプロイ後移行）がないことを確認
Legacy->>Legacy: BBM（バッチバックグラウンド移行）を一時停止
Proto->>Proto: BBM（バッチバックグラウンド移行）を一時停止
Legacy->>DMS: DMS ジョブを初期化
Note over DMS: クロスクラウド VPN トンネル<br/>GCP → AWS
DMS->>Proto: レプリカの論理レプリケーションスロットを介した<br/>フルロード & CDC
Note over DMS,Proto: ⚠️ 初期テーブルコピーの完了を待機
Note over Legacy,Proto: 移行ステップ 2: Geo 同期
Note over Proto: 前提条件: DMS フルロード完了<br/>Geo はセカンダリサイトの PG データに依存
Legacy->>Proto: Geo 同期を有効化
Proto->>Legacy: Git リポジトリを同期
Proto->>Legacy: Object Storage を同期
Note over Legacy,Proto: 移行ステップ 3: 切り替え
Proto->>DMS: DMS ジョブを停止
Legacy->>Proto: Geo セカンダリを無効化
Note over Proto: Topology Service を更新<br/>Organization を Protocell にルーティング
Proto->>Proto: BBM（バッチバックグラウンド移行）を再実行
Legacy->>Legacy: BBM（バッチバックグラウンド移行）を再開
Legacy->>Legacy: デプロイを再開
rect rgb(200, 220, 240)
Note over Legacy,Proto: 移行の検証
end移行フェーズ
準備ステップ 1: Organization 変換（移行の十分前）
このステップでは、選択したトップレベルグループを Organization に変換し、Organization スコープの移行機能を有効にします。100 の新規作成されたテスト TLG を 1:1 マッピングで 100 の Organization に変換します。
手順:
- 100 TLG を 100 Organization に変換（1:1 マッピング） - Organization 変換プロセスの詳細については、../organization/index.md を参照してください。
準備ステップ 2: Protocell のプロビジョニングと設定（移行の十分前）
このステップでは、Protocell をプロビジョニングし、移行のために両方の Cell で Geo を設定します。これは移行ウィンドウよりも十分前に完了します。
- DDL ロック日付範囲を設定
database_upgrade_ddl_lock.ymlで移行ウィンドウ中の DDL ステートメントを防ぐ
Protocell:
- Protocell をプロビジョニング Geo（Geo トラッキング DB と DMS）付きで
- DMS フィルタークエリを設定 転送される Organization に対して
- Protocell ノード名を設定:
gitlab.ymlでgitlab_rails['geo_node_name'] = '<site_name_here>'を確認する - db_key_base を設定:
db_key_baseが Protocell で設定され、Legacy Cell と同じ値に設定されていることを確認する - Protocell フィーチャーフラグを設定:
geo_selective_sync_by_organizationsorg_migration_target_cell
Legacy Cell:
- Legacy Cell フィーチャーフラグを設定:
geo_selective_sync_by_organizations - メトリクスワーカーとチェックサミングを有効化 本番環境でフィーチャーフラグを使用
- main、CI、sec データベースのレプリカをプロビジョニング 移行プロセスをサポートするため
- 専用データベースレプリカ（プライマリではない）に論理レプリケーションスロットを作成 このレプリカはロードバランシングに使用されず本番トラフィックを受け取りませんが、DMS レプリケーション専用となります
- セカンダリサイトを追加（API または管理者経由）しますが、まだ Geo 同期は有効化しません
- Organization リストを追加（API または管理者経由）しますが、まだ Geo 同期は有効化しません
移行ステップ 1: データベース移行（DMS）（移行ウィンドウ）
AWS Database Migration Service（DMS）を使用して、Legacy Cell から Protocell に PostgreSQL データを転送します。 この移行は GCP（Legacy Cell）と AWS（Protocell）間のクロスクラウド VPN 接続を介して行われます。
手順:
- 両方の Legacy と Protocell で自動デプロイを停止
- バージョン同等性を確認: 両方の Cell が同じアプリケーションバージョンであることを確認し、必要に応じてデプロイして一致させる
- 両方の Cell でデプロイ後移行（PDM）が未完了でないことを確認
- 両方の Cell でバッチバックグラウンド移行（BBM）を一時停止
- DMS ジョブを初期化 Legacy から Protocell DB へのデータベースの同期を開始する
- DMS ダッシュボードを監視 ジョブの状態とエラーのため
- 移行ステップ 2 に進む前に DMS 初期テーブルコピーの完了を待機
主要な側面:
- 選択的移行のための Organization レベルフィルタリング
- 3 つのデータベースクラスター（main、ci、sec）を移行 - これらの DB は Rails モノリスが使用
- レプリカの論理レプリケーションスロットを使用したフルロード（フィルタリングを含む）と継続的なレプリケーション（CDC）
- クロスクラウド VPN が安全な暗号化トンネルを提供（GCP HA VPN → AWS Transit Gateway）
- 目標スループット: 6-9 MB/s
- 並行テーブル読み込み（16 テーブルを同時）
- データは移行プロセスを通じてコピーされる
- Geo 同期は移行ステップ 2 で開始する前に初期テーブルコピーが完了している必要がある
DMS 移行戦略の詳細については、DMS ブループリント（文書化予定）を参照してください。
移行ステップ 2: Geo 同期（移行ウィンドウ）
Geo 機能を活用して、Git リポジトリと Object Storage データを Protocell に選択的に同期します。
手順:
- 移行ステップ 1 の DMS 初期テーブルコピーが完了していることを確認
- Legacy Cell で以前追加されたサイトの Geo 同期を有効化
- ステータスとエラーのために Geo ダッシュボードを監視
- Legacy Cell でのすべてのチェックサムエラーを解決 参考: Geo 同期と検証のトラブルシューティング
主要な側面:
- Git リポジトリデータを Protocell に同期
- Object Storage（アップロード、アーティファクトなど）を Protocell に同期
- カットオーバーまで増分同期が継続
- 注意: Container Registry はコホート 0 のスコープ外です。テスト Organization は Container Registry イメージをアップロードしないでください。
移行ステップ 3: 切り替え（移行ウィンドウ）
移行を完了し、Protocell にトラフィックをルーティングするための最終手順。
手順:
- DMS ジョブを停止 して Protocell での PG データのレプリケーションを終了
- Geo セカンダリを無効化 して Geo レプリケーションを停止（Legacy Cell の管理インターフェースまたは API 経由）
- Topology Service を更新 して、転送された Organization が Protocell にルーティングされるように Organization マッピングを変更
- Protocell で バッチバックグラウンド移行（BBM）を再実行
- Legacy Cell で BBM を再開
- Legacy Cell でデプロイを再開
検証
移行が成功したことを確認します。
手順:
- テスト Organization の手動テスト: Git リポジトリアクセスとプロジェクト機能、アップロード、エクスポートなど。
- アカウントアクセスとログイン: ルーティングを検証
モニタリング
PostgreSQL データレプリケーション（DMS）
AWS DMS は CloudWatch を通じてモニタリング機能を提供します。これらのメトリクスをテナント Grafana インスタンスで利用可能にし、ダッシュボードを作成するために、GitLab Dedicated Instrumentor CloudWatch エクスポーター設定を更新します:
- レプリケーションメトリクス:
CDCLatencySource: ソースとレプリケーション間のラグ（秒）CDCLatencyTarget: レプリケーションとターゲット間のラグ（秒）FullLoadThroughputBandwidthTarget: データ転送スループット（KB/s）FullLoadThroughputRowsTarget: 行転送レート（行/s）
- タスクメトリクス:
- タスクの状態と進捗
- テーブル統計（ロード済み、ロード中、キュー済み、エラー）
- レプリケーションスロットラグ（論理レプリケーションの場合）
Git & Object Storage レプリケーション（Geo）
Geo は複数のインターフェースを通じて包括的なモニタリングを提供します:
管理 UI ダッシュボード
- プライマリサイトの管理エリア（管理 > Geo > サイト）
- リアルタイムの同期ステータス
- Organization ごとのレプリケーション進捗
Geo ダッシュボード（Grafana）
Prometheus メトリクスを使用して Geo ダッシュボードを作成します:
- 一般的な Geo メトリクス:
geo_cursor_last_event_id: 最後に処理されたイベントログ IDgeo_cursor_last_event_timestamp: 最後に処理されたイベントのタイムスタンプgeo_db_replication_lag_seconds: データベースレプリケーションラグ
- データタイプごとのメトリクス（例:
project_repositories、lfs_objects）:geo_<type>: プライマリ上の合計数geo_<type>_synced: 正常に同期された数geo_<type>_failed: 失敗した同期数geo_<type>_verified: 正常に検証された数
成功基準
コホート 0 は以下の場合に成功とみなされます:
- すべての 100 TLG が正常に Organization に変換されている
- コホート 0 の Organization のすべての Git リポジトリと Object Storage データが Protocell に同期されている
- コホート 0 の Organization のすべての PostgreSQL データがゼロデータ損失で移行されている
- データ整合性の検証が通過している（行数、チェックサム）
- すべてのバッチバックグラウンド移行が Protocell で正常に完了している
- Organization が Protocell で運用されている
- 移行結果が将来のコホートのために文書化されている
参考資料
- Organization 移行概要
- Organization 変換プロセス
- DMS 移行ブループリント（文書化予定）
