変更要求に含まれるデータ
参照実装では、以下のセクションに変更要求のデータが設定される方法が標準化されています。
- 「説明」&「計画」
- 変更タスク (Change Tasks)
- ロールバック
変更要求には、コンプライアンス監査を簡素化するためのコンテンツが取り込まれます。 これは、継続的統合および継続的デプロイメント・プロセスによって生成される重要な証拠を指します。 そこには必要最小限の情報が示されますが、より詳細な情報は、必要に応じて永続的ストレージから取得することができます。 例えば、変更要求にはスキャン・ログの参照場所が記載されていますが、実際のログは含まれません。 また、ビルド BOM の参照場所が記載されていますが、ビルド BOM そのものは含まれません。
「説明と計画 (Description and plan)」セクション
「説明と計画 (Description and Plan)」セクションの内容は、以下のように編成されています。
-
CI INVENTORY COMMIT URL 継続的統合インベントリーを表す Git コミット ID へのポインター。 継続的統合インベントリーには、デプロイされるコード・レベルに関する情報と、この変更要求によってデプロイされる成果物 (署名とチェックサムを含む) に関する情報が記載されます。
-
CHANGE ログ デプロイされるコード・レベルに含まれているすべてのコミット ID と説明のリスト。
Git changelog for mymicroservice:
Git changelog of artifact '"uk.icr.io/mycontainerregistrynamespace/ mymicroservice:devsecops-pipeline4@sha256:733e74a13ad26d77a741204bcdc9c5f8f77023b26620ddaa7842d29b600014a0"'
COMMITS:
94de4256c346c00fee9fd5f7bbfb114ed4da7c81 - implemented myfunction
- プル要求
mymicroservicerepo: <PR #> - (Merge pull request #15 implemented myfunction)
- テストおよびスキャン結果 エビデンスの要約または失敗した ID のリストで障害が報告されない場合、問題は検出されません。 例えば、
com.ibm.cloud.image_vulnerability_scan: failed; com.ibm.unit_tests: failed)と入力すると、問題の要約が開きます。これにより、承認者は、何が失敗したかに関する詳細を表示できます。
追加の添付ファイル
変更要求には、エビデンス・サマリー、デプロイメント BOM、および終了サマリーの添付ファイルが含まれます。
-
エビデンスの要約 テスト結果とスキャン結果、およびそれらの実行中に作成された問題に関する主要な情報が含まれます。 エビデンス・サマリーの項目は、
summary.jsonをフォーマット変更したバージョンです。 -
デプロイメント BOM デプロイメントを正常に実行するためにターゲット環境に転送される、すべての成果物と、それらのデジタル署名またはチェックサムのリスト。
-
クローズ中の要約 変更要求がクローズされたときに現在のデプロイメントに関連するすべてのエビデンスの要約。
ロールバック
「ロールバック (Rollback)」セクションには以下の情報が記載されています。
- どのバージョンにロールバックするか。
- ロールバックに含まれるのが前のバージョンのデプロイメントだけではない場合に実行するステップ。