スプリントブランチのマージ

スプリントブランチ内でAPIの定義が開発・デプロイされた後、その変更の一部または全てをメインブランチにマージするオプションがあります。

スプリントブランチのマージ方法

スプリントブランチにいる場合、API管理モジュールの横にあるブランチ切り替えボタンの隣に「マージ」ボタンが表示されます。また、API管理モジュールの右下にも「メインにマージ」ボタンが表示されます。

自動テストでは、個々のテストシナリオは個別にマージする必要があり、API管理モジュールのリソースとは自動的にマージされません。スプリントブランチにいる場合、自動テストのテストシナリオ横にある...ボタンにカーソルを合わせると、「メインにマージ」ドロップダウンオプションが表示されます。

保護されていないメインブランチへのマージ

メインブランチが保護されていない場合、プロジェクトのマージ権限を持つユーザーは変更を確認し、直接メインブランチにマージできます。

保留中のマージの概要

API管理モジュールで「マージ」ボタンをクリックすると、マージ概要ポップアップが開きます。

このポップアップでは、以下の主要な要素が表示されます：

フィルター: 現在のスプリントブランチでメインブランチと比較して変更されたリソースのみを表示するか、現在のスプリントブランチの全てのリソースを表示するかを選択できます。デフォルトでは、変更されたリソースが表示され、ユーザーが変更点に集中できるようになっています。

マージプレビュー: このセクションでは、現在のスプリントブランチをマージした後のメインブランチのディレクトリ構造が表示されます。このディレクトリを使用して、マージ後のリソースの配置と内容を確認できます。ディレクトリ内のリソースは、色付きのドット（灰色：未変更、オレンジ：変更済み、緑：新規）でステータスが示されます。右側のチェックボックスを使用して、メインブランチにマージするリソースを選択または選択解除できます。

マージ後のAPIステータス: マージ後のリソースのステータスを調整する方法を選択できます。オプションは現在のブランチに従う、メインに従う、または指定されたステータスです。

保留中のマージの詳細確認

マージ概要ポップアップでは、フォルダ内のコンテンツに対して追加の操作を行い、リソースをメインブランチにマージすべきかどうかを確認できます。リソースをクリックすると、ポップアップが展開され、詳細な内容が表示され、マージの判断を支援します。

異なるリソースには異なるマージロジックと詳細があります：

新規リソース:

新規リソースとは、現在のスプリントブランチで作成され、メインブランチには存在しないリソースを指します。

マージすると、指定された場所にリソースがメインブランチに作成されます。

クリックすると、このリソースの完全な内容が表示されます。以下の画像を参照してください。

変更済みリソース:

変更済みリソースとは、メインブランチから現在のスプリントブランチにフォークされ、メインブランチのリソースに関連付けられているリソースを指します。

マージすると、メインブランチのリソースが上書きされます。

クリックすると、メインブランチのリソースとの変更点と完全な内容が表示されます。以下の画像を参照してください。

未変更リソース:

未変更リソースとは、メインブランチからフォークされ、現在のスプリントブランチで変更されていないリソースを指します。

未変更リソースはマージ対象として選択できません（また、選択する必要もありません）。

クリックしても、このリソースの詳細な内容は表示されません。以下の画像を参照してください。

右下のマージボタンをクリックすると、フォルダ内の選択された全てのリソースがスプリントブランチの設定に従ってメインブランチにマージされます。親リソースが選択されていない場合、その子リソースは個別にマージできないことに注意してください。

マージ後、トーストメッセージが表示され、操作の成功が確認されます。マージポップアップが閉じ、メインブランチへの変更を確認するためのサマリーポップアップが開きます。

メインブランチでのマージ詳細の確認 / マージの取り消し

メインブランチでリソースの変更履歴にアクセスすると、マージを通じて変更された内容が表示され、詳細な変更を確認できます。また、他のバージョンとの内容を比較することもでき、変更の追跡やロールバックが容易になります。

保護されたメインブランチへのスプリントブランチのマージ

保護されたメインブランチにスプリントブランチの変更をマージする場合、編集権限のみを持つユーザーはマージリクエストを作成する必要があります。プロジェクト管理者がリクエストを確認し、承認した後に変更が適用されます。

マージリクエストの作成

プロジェクトでマージをクリックすると、保護されていないメインブランチへのマージと同様に動作し、現在のブランチの全ての変更を確認できます。ここから、メインブランチにマージする特定のリソースを選択できます。選択後、右下のマージリクエストを作成ボタンをクリックして、レビューのためにリクエストを提出します。

マージリクエストのレビュー

マージリクエストが作成されると、レビュアーはプロジェクト概要に新しいマージリクエストが提出されたことを示す明確な通知を見ることができます。レビューするには、プロジェクト概要 > マージリクエストに移動し、リクエストのリストと詳細情報を確認します。

保留中のマージリクエストをクリックすると、レビュアーはマージリクエストの内容を評価できます。マージ前後の内容を詳細に比較し、リクエストを承認するかどうかを決定できます。マージを進める場合、右下のマージボタンをクリックすると、現在のリクエストの全ての変更がメインブランチにマージされます。

マージプロセスは保護されていないメインブランチへのマージと同じロジックに従います。

マージが完了すると、変更がメインブランチにマージされ、メインブランチへの変更を示す概要表が表示されます。

マージリクエストのステータスもマージ済みに更新されます。クリックすると、マージされたリクエストの詳細が表示されます。

提出済みマージリクエストの修正

マージリクエストを提出した後、レビュアーから変更を求められる場合や、承認前に調整が必要な場合があります。そのような場合、スプリントブランチで直接内容を修正できます。これらの変更は既存のマージリクエストと自動的に同期され、新しいリクエストを作成する必要はありません。修正内容はマージリクエストのレビューページに表示されます。

マージリクエストの拒否

レビュアーがマージリクエストがスプリントブランチに適していないと判断した場合、マージリクエストのレビューページで拒否をクリックできます。拒否されると、マージリクエストはクローズとマークされます。変更を加えて再度マージを試みるには、新しいマージリクエストを作成する必要があります。

クローズされたマージリクエストをクリックすると、全ての詳細が表示されます。

自動テストシナリオのマージ

自動テストシナリオとAPIは現在、独立して個別にマージされます。テストシナリオは個別にマージする必要があり、全体のマージページはありません。

重要な注意点:

テストシナリオをマージする前に、まずAPI管理モジュールのリソースをマージしてください。これを怠ると、マージ後にメインブランチの関連テストシナリオが正常に動作しなくなる可能性があります。

現在、保護されたメインブランチにテストシナリオをマージできるのはプロジェクト管理者のみです。ただし、将来的には、APIマージリクエストと同様に、テストシナリオのマージリクエストを提出できる機能を実装する予定です。これにより、保護されたメインブランチへのテストシナリオのマージが容易になります。

スプリントブランチにいる場合、自動テストのテストシナリオ横にある...ボタンにカーソルを合わせると、「メインにマージ」オプションが表示されます。

これをクリックすると、テストシナリオのマージポップアップが開き、以下の情報が表示されます：

基本情報: マージ対象のスプリントブランチのテストシナリオと、関連するメインブランチのテストシナリオ（存在する場合）が表示されます。

最終実行結果: スプリントブランチでのテストシナリオの最後の手動実行結果が表示されます。アイコンにカーソルを合わせると、結果の概要が表示されます。テスターはこの情報を使用して、マージを進めるかどうかを判断できます。結果が未テストまたは失敗の場合、マージ前にテストシナリオが完全に合格することを確認することを推奨します。

マージアクション: オプションは上書きと追加です。テストシナリオがメインブランチからフォークされた場合、メインブランチのリソースを上書きしてマージされます。テストシナリオが新規の場合、メインブランチに追加されます。

スプリントブランチのマージ