ソフトウェア構成管理は、ソフトウェアと関連資料の組み合わせを識別し、変更と状態を追跡する取り組みです。ソースコードがGitに入っているだけでは、どの要件、設定、テスト結果と対応する版なのかまでは分からない場合があります。
対象の識別、変更の判断、状態の記録、整合の確認をつなぐことで、「どの版を何に基づいて確認したか」を説明できる状態を作ります。本記事はCI/CDの実行手順ではなく、管理対象と変更の根拠を扱います。
コード以外に、何を管理するかを決める
NASAの構成管理の説明では、計画と管理、構成識別、変更管理、構成状況の記録、検証を一連の活動として整理しています。航空宇宙分野の詳細手続をすべての開発へ適用するものではありませんが、版を保存するだけにとどまらない考え方の参考になります。出典:NASA Configuration Management
業務アプリの例なら、コード、依存するライブラリの定義、設定のひな型、データベース変更、要件・設計、試験結果などを管理対象として検討できます。どこまで必要かは、変更の影響と後から説明したいことに合わせます。
認証情報などの秘密そのものをコードと一緒に保存する意味ではありません。秘密の値と、設定名・用途・適用先の情報を分けて管理します。
構成識別では、対象と基準版の組み合わせを残す
構成アイテムに識別子や版を付け、どの組み合わせを基準とするか決めます。基準となる組み合わせはベースラインと呼ばれます。NASAも、合意された構成を基に変更を管理する考え方を説明しています。出典:NASA
仮想の受注アプリで、コードの版は分かっても、データベースの変更が適用済みか分からないとします。この状態では、同じコードを配布しても同じ動作になるか判断できません。
管理表の例として、リリースIDに対して、コードの識別子、DB変更の版、設定の版、テスト結果の識別子を対応付けます。ファイル名の「最終」「最新版」だけに頼らず、対象を一意にたどれる情報を残しましょう。
変更管理では、修正内容と承認理由を追う
変更が必要になったら、何を変えるかだけでなく、理由、影響する構成アイテム、確認方法を整理します。実施するかどうかの判断者は、案件の権限とリスクに合わせます。
たとえば注文金額の計算を変えるなら、コードに加えて要件、試験項目、操作説明への影響を検討します。修正したコードだけが新しく、説明書や試験の期待結果が古い状態を避けるためです。
NASAの説明でも、変更の提案・評価・承認した変更の反映・実施確認を扱います。ただし、すべての小さな変更に大規模な会議体が必要という意味ではありません。必要な判断と記録を、規模に合わせて維持します。出典:NASA
構成状況の記録は、進行中と反映済みを分ける
変更を承認したこと、実装したこと、試験したこと、本番へ反映したことは異なる状態です。基準版と変更要求の対応を残し、どこまで進んだかを追えるようにします。
| 状態の例 | 記録する内容の例 |
|---|---|
| 提案中 | 変更の理由、対象、確認が必要な点 |
| 承認済み | 判断した人、理由、実施条件 |
| 検証済み | 確認した版と環境、結果、残った問題 |
| 反映済み | 適用先、適用した版、実施結果 |
表は本記事の簡略例です。実際の状態名は既存の課題管理やレビューの仕組みに合わせて構いません。重要なのは、「承認済みだから本番も変わっている」といった推測をせず、状態を区別することです。
監査・検証では、記録と実物の一致を確かめる
構成の検証では、要求や確認結果と実物が一致するか、必要な構成品目や資料がそろっているかを確かめます。NASAは機能面・物理面の構成監査を区別する説明もしています。出典:NASA
業務アプリでの確認例なら、配布物の識別子がレビューした版と一致するか、必要なDB変更と設定がそろっているか、試験結果が対象版へ対応するかを見ます。「ビルドが成功した」だけで、必要な変更がすべて含まれているとは判断しません。
不一致を見つけたら、実物と記録のどちらを修正するかを判断し、理由を残します。基準版へ勝手に合わせるために、検証記録を書き換えるものではありません。
CI/CDと組み合わせても、管理する責任は残る
CI/CDはビルドやテスト、配布の実行を支援できますが、管理対象、承認条件、基準版を誰が決めるかは別に必要です。自動処理の結果を構成状況の記録とつなぐと、どの版が何を通過したかを確認できます。
最初は一つのリリースについて、要件から変更、確認、反映まで追えるか試してみてください。足りない情報を補うことが、運用に合う構成管理を作る出発点になります。技術的な管理方法の整理は、テクノヴァースのお問い合わせからご相談ください。