ドキュメント

品質ポリシーとゲート

実行すべき作業内容を定義し、プロジェクトに紐付けて安全に変更する。

ポリシーとは、名前が付けられ、バージョン管理される品質ゲートのセットです。ポリシーはプロジェクトに紐付けるもので、実際に実行されるのはゲートです。

概念について — ブロッキングとアドバイザリーの違いや、ゲートの実行位置など — は、品質ゲートを先にご確認ください。このページではそれらの管理方法について説明します。

設定場所は品質 → ポリシー.

ポリシーの作成

ポリシーとは、チェック項目の集合であり、各チェック項目ごとに失敗時にブロッキングとするかアドバイザリーとするかが指定されます。

ほとんどの組織では、プロジェクトごとに1つずつではなく、2〜3種類のポリシーがあれば十分です。

  • 厳格なポリシーを本番環境のサービス用に設定します。
  • 標準的なポリシーを通常の業務用に設定します。
  • 場合によっては「緩やかなポリシーを社内ツールやプロトタイプ用に設定します。

それ以上の種類があると、どのプロジェクトにどのポリシーが適用されているかを誰も覚えられなくなります。

プロジェクトへの適用

各プロジェクトでは1つのポリシーが実行されます。変更するには、プロジェクトの品質設定で行います。

明示的なポリシーが設定されていないプロジェクトでは、組織のデフォルトポリシーが適用されます。そのデフォルト値は標準的なポリシーに設定し、最も厳格なポリシーは意図的に選択するようにしてください。最も厳格なポリシーは意図的に選択されるべきものだからです。

安全な導入方法

ゲートの問題点は、基準が緩すぎることではなく、善意のブロッキングゲートが組織内のすべてのタスクを一斉に停止させてしまうことです。

安全な手順は以下の通りです:

  1. まずゲートを「アドバイザリー.
  2. として追加し、1〜2週間実際の業務で実行させて、検出される内容を確認します。
  3. 得られた知見に基づいて調整します。
  4. 次に「ブロッキング」に昇格させ、1つのプロジェクトで試します。
  5. 正常に動作することが確認できたら、より広範囲に展開します。

バージョン管理とロールバック

ポリシーにはバージョン管理が適用されます。公開すると新しいバージョンが作成され、以前のバージョンにロールバックすることも可能です。

ロールバック機能があるからこそ、公開時に断固とした判断を下すことができます。新しいゲートの設定が不適切だった場合でも、元に戻すのは単一の操作で済み、過去の記録を探し出す手間が省けます。

オーバーライド

権限を持つユーザーは、ブロッキングゲートをオーバーライドできます。オーバーライドの履歴 — 誰が、いつ、何に対して行ったか — は記録されます。

オーバーライド率に注意してください。ゲートが発動するたびにほとんどの場合でオーバーライドされるようであれば、そのゲートは何も強制しておらず、ただ摩擦と記録を生み出しているだけです。ゲートを修正するか、削除するべきです。