移行

どのようなものか

移行とは、既に使っているものを、新しいバージョンやプラットフォームへ
段階的かつ計画的に移し、最後に古い方を廃止する作業です。対象は、ワー
クロード全体、アプリケーション、データ一式、データを保存する構造など
です。作り直すこととの違いは、移動中も使い続ける点です。利用者、記
録、連携先も引き継ぎ、新しいものが役割を引き継ぐまで、古いバージョン
は動き続けます。

エンジニアは、この言葉を二つの規模で使います。どちらを指すか明示しな
いことも多くあります。

大きい方は、新しいプラットフォームや新しいメジャーバージョンへの移動
です。MicrosoftのCloud Adoption
Frameworkは、オンプレミスのサーバーや別のクラウドからAzureへワーク
ロードを移す作業を、計画、ワークロードの準備、実行、最適化、移行元の
廃止という五段階で扱います。Esriの顧客は、地図とデータをArcMapから
ArcGIS
Proへ移します。Next.jsアプリケーションは、Pages RouterからApp
Routerへ移り、`getServerSideProps`の代わりにServer
Components内でデータを取得します。PostgreSQLクラスターは、新しいメ
ジャーバージョンへ移ります。システムテーブルの構造が変わることが多い
ため、`pg_upgrade`か、ダンプと復元でデータを移します。

小さい方の移行は、データベースの構造に加える一つの変更です。バージョ
ンを付け、リポジトリーのファイルとして保存し、ツールが決まった順に適
用します。Djangoは、自らの移行を、データベーススキーマのバージョン管
理システムと呼びます。各ファイルは、モデルの変更を記録し、コードと一
緒にコミットされ、開発者のノートPC、ステージング、本番で同じ順に動き
ます。GitLabは、アップグレード後に大きなテーブルを少しずつ書き換え
る、バッチ単位のバックグラウンド移行を提供します。整数列を、あふれる
前に`bigint`へ広げる例などです。データ移行もこちらに含まれます。列で
はなく行を変えるもので、二つの古いフィールドから、新しいフィールドを
埋めるといった処理です。

同じ考えを、二つの規模で行っています。どちらにも、既知の開始状態、順
序のある手順、移行先、手順が失敗したときの戻り方があります。プラット
フォームの移動は、通常、スキーマ移行を含みます。一方、長年のスキーマ
移行の積み重ねは、利用者が使うプラットフォームを、何年もかけて少しず
つ変えることになります。

なぜ重要なのか

ソフトウェアは、作った当時の基盤より長く残ります。クラウド契約は再交
渉され、フレームワークは仕組みを変え、提供元は製品を廃止します。十年
間使い続けるシステムは、その間に何度も移行します。そのため、最初にど
れだけ良いプラットフォームを選んだかより、チームがどれだけうまく移行
できるかの方が、最後には重要になります。

1. 費用がかかるのは、新旧に分かれた期間です。
一部が古いプラットフォーム、一部が新しい方で動く間は、両方を運用、監
視し、一貫した状態に保つ必要があります。Cloud Adoption
Frameworkは、その期間を短くし、直接依存する部品を同じ移行グループと
してまとめて移すよう勧めます。

2. データベースは、再デプロイでは置き換えられません。
コードは再ビルドして置き換えられますが、本番の行ではできません。ス
キーマ移行は、使用中の構造の変更を、レビューし、コピーに対して試し、
順に適用し、大半の変更では元に戻せるファイルにします。そうしなけれ
ば、本番のスキーマは、最後にコンソールを使った人が残した状態そのもの
になります。

3. 計画した移動は、元に戻せます。 Cloud Adoption
Frameworkは、移行を始める前にロールバックの基準と手順を決め、ロール
バックを試し、途中に続行か中止かを判断する地点を置くよう求めます。

利点と代償が集中するのは、切り替えです。Cloud Adoption
Frameworkは、停止を伴う移行と、ほぼ停止しない移行を分けます。後者で
は、データを継続して複製し、最後に切り替えます。PostgreSQLのメジャー
バージョン更新では、`pg_upgrade`が切り替えを短くします。既存のデータ
ファイルを再利用し、この種の更新で通常必要なダンプと復元を省きます。
ファイルをコピーしない`--link`モードでは、さらに大幅に速くなります。

実際の活用例

このサイトの三つのプロジェクトに、三つの規模が見られます。プラット
フォーム全体から、一つのリポジトリーのファイルの順序までです。

一つは、クラウド提供元から離れる移行でした。顧客のAWS環境では、必要
以上のリソースが確保されており、実際に何を使っているかの確認から始め
ました。不要なサービスを除き、残りの容量を調整した後、ワークロードは
AWSから移りました。案件の記録が裏付けるのは、このインフラ変更です。
移動前に使わないサービスを減らせば、運ぶものは減ります。ただし、同じ
条件で比べた費用の比率、生産性の成果、停止のない移行を示す記録ではあ
りません。

二つ目は、移行先の構造も新しく設計した、エンジンの変更でした。地図ア
プリケーションのデータベースを、MSSQLから、PostGIS拡張を加えた
PostgreSQLへ移しました。移行先は、古い構造のコピーではありません。新
しいスキーマは、空間データ向けに設計し、GiSTとSP-GiSTのインデック
ス、空間座標の検証規則を強制する厳密な外部キー制約とチェック制約を置
きました。5,000万件を超える空間レコードを、EPSG:4326へ変換するETLパ
イプラインで移しました。新しい設計へ移ることは、データの規則をスキー
マ自体に書く機会です。ページは、空間クエリー性能が10倍になり、バック
エンドのCPU負荷が65%下がったと報告します。

三つ目は、何年も続けた、小さい方の移行です。一つのプラットフォームの
スキーマは、036から1102まで番号を付けた1,022件の移行の積み重ねで、
ページは、その順序を保つ規律を、地味でも譲れないものと呼びます。リポ
ジトリーの履歴は、本番の状態の説明です。開発者が新しく作るコピーか
ら、復元したものまで、どのデータベースでも、最初のファイルから最後ま
で再適用して作り直せる間だけ、その説明は正しく保たれます。

問題が起きるところ

計画は切り替えに集中しますが、問題は前後の数週間に集まりがちです。よ
くある形は四つあります。

新旧二つのシステムが、予定より長く並行稼働します。
移行が途中で止まり、難しい部分が残り、チームは何か月も両方を運用しま
す。利用者にも継ぎ目が見えます。Next.jsのガイドは、Pages
RouterのページとApp
Routerのページの間の移動は、ページ全体を読み直す遷移になり、
`next/link`は、両者をまたいで事前取得しないと記します。移行グループ
を小さくし、次の一歩の負担を小さくします。ここのフロントエンドの一つ
は、一往復でページを読み込む共通のファクトリーへ、一ページずつ移して
おり、移したページは、すべてその動作を引き継ぎます。

切り替え後に戻れません。 移行先だけでなく、移行元も変える手順があり
ます。`pg_upgrade
i--link`では、新しいクラスターが起動した時点で、古い方と共有するファ		engineer.company	70
iイルへ書き込むため、古い方はバックアップから復元する必要が生じます。		engineer.company	70
iEsriは、ArcGIS		engineer.company	70
Pro向けに更新したデータ集合が、ArcMapでは使えなくなる可能性を警告
し、先にコピーするよう求めます。Djangoの`RunSQL`で、逆向きのSQLを書
かなければ、元に戻す移行をした瞬間に`IrreversibleError`が出ます。最
初の手順より前に、ロールバックの基準を決め、戻り方を練習し、検査にし
ます。ここのリポジトリーの一つでは、検証項目に移行をロールバックでき
るかの検査を含むガードエンジンを動かしています。

実行済みの移行を編集します。
移行ツールは、どのファイルを適用したかを記録し、以後は飛ばします。本
番へ届いたファイルを変えると、本番は古い版を保ち、新しいデータベース
は変更後を受け取ります。一つの履歴に二つのスキーマが生まれます。適用
済みの移行は変えず、新しい移行で直します。何もない状態から履歴を再適
用し、移行済みのコピーと比べるビルドなら、そのずれを見つけられます。

更新初日にデータベースが遅くなります。
`pg_upgrade`は、プランナーの統計の大半を移しますが、全部ではありませ
ん。残りを作り直すまでは、プランナーは推測します。`--check`モードは
何も変えず、古いサーバーが処理中でも動かせるため、先に実行します。更
新直後に不足分の統計を再作成し、その後、残りを収集します。

```sh
pg_upgrade --check -b "$OLD/bin" -B "$NEW/bin" -d "$OLD/data" -D "$NEW/data"
pg_upgrade -b "$OLD/bin" -B "$NEW/bin" -d "$OLD/data" -D "$NEW/data"
vacuumdb --all --analyze-in-stages --missing-stats-only
vacuumdb --all --analyze-only
```

参考資料

  * 移行を計画する —
移行グループ、切り替えの選択、ロールバック計画を含む、Azureへワーク
ロードを移すMicrosoftの方法です。

  * 移行 — バージョン管理したスキーマ変更、元に戻す方法、データ移行
を扱う、Djangoのガイドです。

  * pg_upgrade — 検査モード、リンクモード、元に戻す方法、その後の統
計処理を含む、PostgreSQLの更新ツールです。

  * PagesからApp Routerへ移行する方法 —
Next.jsアプリケーションを、新しいルーターへ一ページずつ移す方法で
す。

  * 既存の作業を移行する — ArcMapからArcGIS Proへ引き継げるもの、変
換が必要なもの、先にバックアップするものです。

  * 更新前に移行を確認する —
更新後にGitLabのバックグラウンド移行が大きなテーブルをバッチ単位で書
き換える仕組みと、完了の確かめ方です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/migration/	engineer.company	70
