[Cloud]Oracle Developer Cloudのビルドパイプラインの一部としてコードマージを行う方法／Code Merge as part of a Build Pipeline in Oracle Developer Cloud

この記事ではOracle Developer Cloudでのパイプライン構成の一部として、コードのマージを行う方法を説明します。簡単に使えるビルド・ジョブ機能だけをこれを使って実現することができます。また、開発者が日々の開発作業を行う際に、どのようにこの機能が役立つかについても理解することができるでしょう。

New Repositoryダイアログでは、リポジトリ名を入力します。例ではMyMergeRepoとしていますが、好きな名前を使ってください。Initialize repository with README fileオプションを選び、Createボタンを押しましょう。

ナビゲーションバーのGitをクリックします。GitページのRefsビューで、RepositoriesドロップダウンからMyMergeRepo.gitを選びます。+ New Branchボタンを押すと新規ブランチが作成されます。

New Branchダイアログでは、一意になるブランチ名を入力します。例ではchangeを使っていますが、好きな名前にしてください。適切なBaseブランチをドロップダウンリストから指定しましょう。例ではmasterブランチのみしか選択肢がありません。Createボタンを押し、新規ブランチを作成しましょう。

ナビゲーションバーからBuildsをクリックします。Jobsタブで、+ Create Jobボタンを押すと、新規ビルドジョブが作成されます。

New Jobダイアログでは、ジョブ名として一意となる名前を指定しましょう。例ではMergeCodeとしていますが、好きな名前を入力してください。Use for Merge Requestチェックボックスにチェックを入れ、Create Newオプションを選択したら、ドロップダウンリストから任意のソフトウェアテンプレートを選んでください。マージを行う際に特に必要となる特定のソフトウェアバンドルなく、いずれのソフトウェアテンプレートにもデフォルトで含まれているソフトウェアバンドルだけで十分です。最後にCreate Jobボタンをクリックしましょう。

注意：VMテンプレートの構成とVMの構築に詳しくない場合、Set Up the Build Systemを参照してください。

Use for Merge Requestにチェックを入れてビルドジョブを作成すると、Source ControlタブのRepositoryとBranchフィールドにマージリクエストパラメータが格納されます。そのままAutomatically perform build on SCM commitチェックボックスにチェックを入れましょう。

Build Parametersタブを見ると、GIT_REPO_URLやGIT_REPO_BRANCHなどのマージリクエストパラメータが自動的に追加されていることにお気づきでしょう。確認したら、Saveボタンを押しましょう。

ナビゲーションバーのMerge Requestsをクリックし、+ Create Merge Requestボタンを押しましょう。

New Merge Requestウィザードでは、Gitリポジトリ（MyMergeRepo）を選択し、ターゲットブランチ（master）とレビューブランチ（change）を選択します。まだ何もコミットしてないので、何も表示されません。Nextボタンをクリックして次のページに進みましょう。

Detailsページでは、Linked BuildフィールドでMergeCodeを選択し、また、レビュアーを設定します。このマージリクエストに紐づけたいissueがある場合は、Linked Issuesフィールドで設定しましょう。Nextボタンをクリックし、最後のページに移動します。

マージリクエストの説明欄のコメントは、デフォルトのものを使うこともできますし、編集することもできます。では、Createボタンを押してマージリクエストを作成しましょう。

Linked Buildsタブでは、MergeCodeビルドジョブがリンクされたビルドジョブとして表示されます。

GitページでリポジトリのドロップダウンリストからMyMergeRepo.gitリポジトリを選択し、ブランチのドロップダウンリストからchangeブランチを選択します。そしてREADME.mdファイルのリンクをクリックしましょう。

鉛筆のアイコンをクリックしてファイルを編集します。

任意のテキストを追記し、Commitボタンをクリックします。

コードのコミットによりMergeCodeビルドジョブがトリガーされます。

リンクされたジョブのビルドが起動されると、Conversationタブに自動的にコメントが追加されます。MergeCodeのビルドが完了すると、マージリクエストが自動的に承認され、MergeCode自身がReview StatusリストのApproveセクションに追加され、マージリクエストにアサインされているレビュアーの承認待ちの状態になります。

レビュアーがマージリクエストを承認すると、レビューブランチにあるコードをターゲットブランチにマージできる状態になります。Mergeボタンをクリックすると、コードがマージされます。

注意：この例のマージリクエストではログインしているユーザーであるAlex Adminがレビュアーです。

ビルドジョブにMerge Requestパラメータを含めておくことにより、全てのコミットに対してコンフリクトが発生していないか、承認されているかのチェックを自動的に行うようにすることができます。マージリクエスト用のビルドジョブをリンクしておくと、ひとつのマージリクエストに複数のコミットが紐付られているような場合に有用です。マージリクエストに対してアサインされたレビュアーからのコードレビューと変更の承認が行われたのち、コードがターゲットブランチにマージされます。

日々の開発作業において開発者がチームメンバーと効率的に協働することを手助けしてくれるような機能です。

良いコーディングを！