マージ前にチェックを提案または要求する
ユーザーにチェックを推奨し、全員にマージが許可されるようになる前に内容の検証を依頼できます。Atlassian では、プレミアム プラン向けのマージ チェックもいくつか提供しています。
- すべてのマージ チェックを解決するまでユーザーがマージできないようにする
- プルリクエストのソース ブランチが変更されるたびにレビューアに再度承認を要求する
マージ チェックでは、個別のブランチやブランチ パターンのマージについて、特定の条件を推奨または要求することができます。マージ チェックはブランチ権限と連携して機能し、柔軟性と開発ワークフローの制御機能をワークスペースのメンバーに提供します。
マージ チェックの目的
依存関係のマージ
- ユーザーが成功したビルドのみを使用して変更をマージするようにします。
- マージを行う前に成功すべきビルドの数を選択します。
- Bitbucket Pipelines (ビルド ツール連携) またはコミット ステータスの REST API を使用します。
コードレビューの完了
- マージをコードレビューに関連付けます。
- 同僚が協力してプル リクエストに取り組むようにします。
- マージを行うために必要な作業を開発者が把握できるよう、ワークフローに一貫性を持たせます。
タスクの完了
- プルリクエストでタスクを作成し、必要な変更をマークします。
- プルリクエストが承認に進行するまで管理します。
- マージの前にプルリクエストのすべてのタスクが完了していることを確認します。
マージ チェック
マージ チェックを使用して、マージ前に次の条件を推奨または要求できます。
プレミアム プランではない場合にこれらのいずれかのオプションを選択すると、未解決のマージ チェックがある状態でマージ可能なときに、ユーザーに警告が表示されます。ユーザーがマージを行うのを防ぐためには、プレミアムへアップグレードし、[未解決のマージ チェックがある場合はマージを行わない] を選択します。プレミアムの詳細についてはこちらをご参照ください。
| 設定 | 結果 |
|---|---|
承認が {#} 以上あるかどうかをチェック | プルリクエストの承認の数がその数を下回った場合、ユーザーに通知されます。 |
| 未解決のプルリクエストのタスクをチェック | オープンなプルリクエストのタスクがあった場合、ユーザーに通知されます。 |
| 最後のコミットで成功したビルドが {#} 以上あるかどうかをチェック | 最後のコミットで成功したビルドの数がこの数を下回った場合、ユーザーに通知されます。 |
プレミアム プランの場合、次の設定にもアクセスできます。
| 設定 | 結果 |
|---|---|
| 未解決のマージ チェックとのマージを防止する | プルリクエストに未解決のマージ チェックがある場合、ユーザーはマージできません。マージを完了するために解決が必要な項目のチェックリストが表示されます。 |
| ソース ブランチが変更されたら承認をリセットする | プルリクエストのソース ブランチに変更があった場合、プルリクエストは承認無しで更新され、レビューアはプルリクエストを再びレビューして承認する必要があります。 |
セットアップの例
マージ チェックは、ブランチ権限と連携して個別ブランチまたはブランチ パターンに適用されます。このセクションの残りの部分では、ブランチ権限の説明に使用した例と、マージ チェックについて説明します。
Let's say Alana (Principal Engineer), Harvey (QA lead), and another 5 engineers are working on a Teams in Space project. Everyone has write access to the repository, but you want to restrict access to the default and develop branches. From the branch permission dialog, you might want to assign permissions like this:
| ブランチ | ブランチの権限 | マージ チェック |
|---|---|---|
| 既定 | 書き込みアクセス権限: Alana プルリクエスト経由でのマージ: Alana、Harvey |
|
| develop | 書き込みアクセス権限: Alana、Harvey プルリクエスト経由でのマージ: Alana、Harvey、 |
|
Start by navigating to the repository where you want to add a branch permissions, then go to Repository settings > Branch permissions.
master ブランチに権限とマージ チェックを追加する
- [ブランチの権限の追加] をクリックします。
- 各フィールドに以下を入力します。
- ブランチまたはパターン: master
- 書き込みアクセス: Alana (Alana はプルリクエスト経由でのマージ権限を自動的に取得します)
- プルリクエスト経由でのマージ: Harvey
- [マージ チェックの追加] を展開します。
- [最後のコミットで {#} 件のビルドが成功していることをチェック] を選択します。
- ドロップダウンから 2 を選択します。
- [保存] をクリックします。
このセットアップにより、ワークスペースのメンバーは master ブランチへのアクセスをコントロールすることができます。本番対応のコードのみを master にマージするため、成功したビルドに対してのみマージ チェックを行います。
develop ブランチに権限とマージチェックを追加する
- [ブランチの権限の追加] をクリックします。
- 各フィールドに以下を入力します。
- ブランチまたはパターン: develop
- 書き込みアクセス: Alana および Harvey Persona (Alana と Harvey はプルリクエスト経由でのマージ権限を自動的に取得します)
- プルリクエスト経由でのマージ: teamsinspace:developers
- [マージ チェックの追加] を展開します。
- [承認が {#} 個以上あるかどうかをチェック] を選択した後、ドロップダウンから 2 を選択します。
- Select Check for at least {#} approval from default reviewers and select the number of default reviewers, if you have set any for this pull request, you want to approve the pull request.
- [未解決のプルリクエスト タスクをチェック] を選択します。
- [最後のコミットで {#} 件のビルドが成功していることをチェック] を選択し、ドロップダウンから 3 を選択します。
- [承認が {#} 個以上あるかどうかをチェック] を選択した後、ドロップダウンから 2 を選択します。
- 保存をクリックします。