2TECH.WORK
2TECH.WORK / RESOURCES

保守を容易にする小さな習慣

リリース後もアプリケーションを理解しやすく保つための3つのルーチン。

詳細を読む
このページで説明されているアーキテクチャと接続。
01

メンテナ向けのリリースノートを書く

変更の理由、そのバージョン、ユーザーやメンテナが取るべきアクションを記録する。設定やデータの変更は別に記載する。役立つリリースノートはコミットログより短く、作業の効果を説明しているものである。デプロイ記録へのリンクを付ける。

02

観察を質問から始める

ユーザーは主要な操作を完了できるか?依存関係は応答しているか?リリースによって障害が変わったか?これらの質問に答えるために必要なイベントを収集し、すべてを記録するのではなく、関連するイベントを接続するためにリクエスト識別子を使用し、個人情報や認証データは除外する。

03

小規模なリカバリをリハーサルする

テストデータセットを復元する練習や、プレビューを以前のリリースに戻す練習を行いましょう。手動で判断が必要なステップを特定し、経験が新しいうちに手順を更新してください。演習は本番データとは分離して行ってください。短いリハーサルでも、権限の不足や文書化されていない依存関係が明らかになることがあります。