シームを選ぶ
変更されるインターフェイスまたはワークフローの境界線を特定します. サポートされたトランザクションの例とバージョン化されたベースラインを使用して、現在の行動を再検討できます。
境界面(シーム)となるのは、API、非同期の引き継ぎ、業務ワークフローの境界などです。誰がそれを呼び出し、どの状態を変更し、呼び出し元がどの結果に依存しているのかを文書化しましょう。例外、順序、部分的な完了も含めます。正常系だけが一致する置き換えでは、サービスのビジネス上の意味が変わってしまうおそれがあります。
- 消費者名とダウンストリームサービス
- インターフェイスのバージョンを範囲内で記録します。
- 変化のないビジネスの成果を定義する。
比較可能な選択肢を作る
作業負荷と入力条件を安定させ、提案されたサービスの行動や依存性を変更します。
可能であれば、申告された要素を一度にひとつずつ変更しましょう。候補によって需要、データ分布、障害モデルも変わる場合は、それらの違いを明示的に記録します。そうしないと、見かけ上の改善が、より優れたサービス設計ではなく、より軽いワークロードによるものかもしれません。
同一の申告されたワークロードでの対になった経路
入力ケース、需要、関連するデータの前提を安定させます。
- ピンベースラインと候補モデル
- 予想された失敗と部分的な完了を含む。
- ドキュメント サポートされていないプロデューサーとプロトコルパス。
解放決定の準備
ビジネス・インバリアンとクライアントの結果を比較し、その後、どの証拠が計画された実施で再現されるかを決定します。
重要な差異はそれぞれ、維持された振る舞い、意図した変更、後退、未解決の不一致のいずれかとして説明します。エビデンスは、実際のターゲットプラットフォームでさらにテストが必要な事項をレビュー担当者が判断する助けとなるべきです。シミュレーションでの受け入れはリハーサルのマイルストーンであり、本番環境への切り替えを承認するものではありません。
作成した置き換えで、レガシーな予約の引き継ぎを維持できるか?
同じ合成データの予約と例外ケースを、現行の経路と候補の経路の両方に投入します。識別子、最終的な予約状態、重複リクエスト、部分的な完了を比較します。
正常系が一致しても、重複リクエストによって予約が 2 回変更されるのであれば不十分です。その差異と、解消に必要なネイティブ統合テストを記録します。
- リグレーションの証拠と例外を保持します。
- ロールバックと回復の仮定を特定します。
- 生産カットの承認から別々のモデルを受け入れる。
互換性を観測可能にする
互換性は、利用者が依存する結果の観点から定義しましょう。レスポンスの構造は契約の一部にすぎません。タイミングの前提、状態遷移、ID、リトライ、例外のセマンティクスも重要になる場合があります。
選択したサービス境界で、独立したアサーションを使用します。ベンダーの挙動やプロトコルの経路がサポート対象外の場合は、汎用モデルをネイティブシステムのエビデンスとして扱うのではなく、そのギャップを明記し、別途統合テストを設計します。
判断の前に差異を分類する
| 差異 | 解釈 | レビューでの対応 |
|---|---|---|
| 同一のビジネス結果 | 申告されたケースでは振る舞いが維持されています。 | 除外された経路とデプロイの前提を確認します。 |
| 意図した契約の変更 | 利用者が新しい振る舞いを理解する必要があります。 | 変更した契約を明示的にバージョン管理し、テストします。 |
| 予期しない状態または重複した影響 | 置き換えによって互換性が損なわれる可能性があります。 | 調査し、後退のエビデンスを保持します。 |
- 利用者の期待と副作用をマッピングします。
- インターフェースとモデルのバージョンを保持します。
- 意図した差異を明示的にテストします。
障害とロールバックの前提をリハーサルする
移行は、リクエストと下流への影響のあいだで失敗することがあります。作成するシナリオには、部分的な完了、遅延したレスポンス、リカバリーの順序を含めましょう。境界のどちら側にどの状態が属するかを特定します。
候補がデータを変更したり影響を発生させたりしている場合、ロールバックは単にエンドポイントを切り替えるだけでは済みません。何を元に戻せるのか、何に照合が必要なのか、そしてターゲット環境での別のリカバリー手順で何を扱う必要があるのかを文書化します。
エビデンスとその条件をひとまとめに保ちます。後の成功が以前の失敗を消したり、元のスコープを広げたりすることはありません。
- 変更前後の状態の所有者を記録します。
- 不明な結果と重複リクエストを含めます。
- 復元と照合のエビデンスを、リリースのレビューとあわせて保持します。
範囲を限定したモダナイゼーションのレビューに備える
有用な意思決定を支えられる、最小のサービス境界を選びましょう。対になった結果を、利用側のチームと、置き換え案のオーナーの両方とともにレビューします。
レビューパッケージでは、維持された振る舞い、意図した差異、失敗、サポート対象外の経路を説明する必要があります。モデル化したリハーサルからデプロイの判断に進む前に、必要なお客様環境での統合テストと運用テストについて合意します。
レビューの準備
0 / 6 準備済み- ベースラインと候補の成果物を固定します。
- 未解決の互換性ギャップを明記します。
- 切り替えの承認は、別のゲートとして扱います。