• ログイン無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

CodeStreamでのプルリクエストの管理

ほとんどの開発チームにとって、開発プロセスの最終ステップはプルリクエストです。たとえあなたのチームが New Relic CodeStream のフィードバックリクエストを、PR ベースのエンドオブサイクルコードレビューの前触れではなく、その代わりとして使用することを決めたとしても、CodeStream ではそのワークフローのすべてを IDE 内に維持することができます。CodeStream ペインの Pull Requests セクションでは、あなたに関連するすべてのオープンなプルリクエストがリストアップされ、カスタムクエリによってリストをコントロールすることができます。

重要

プルリクエストの作成は、GitHub, GitHub Enterprise, GitLab, GitLab Self-Managed, Bitbucket, Bitbucket Serverで利用可能です。プルリクエストのレビューは、GitHub, GitHub Enterprise, GitLab, GitLab Self-Managedでのみ利用可能です。

A screenshot showing the pull request section

プルリクエストセクションでは、レビュー待ちのPR、自分に割り当てられたPR、自分が作成したPR、最新のPRで分けられています。

デフォルトでは、プルリクエストは以下のセクションに分割されて表示されます。

  • Waiting on My Review: 自分がレビュアー、またはリクエストされたレビュアーになっているプルリクエストを開きます。
  • Assigned to Me: 自分に割り当てられたプルリクエストを開く。
  • Created by Me: 自分で作成したプルリクエストを公開します。
  • Recent: ステータスに関係なく、あなたが作成した最新のプルリクエスト5件。

リスト内のプルリクエストをクリックすると、コードの編集やレビュー、さらにはマージができます。プルリクエストの行にカーソルを置くと、レポ、ブランチ、ステータスなどの詳細が表示されます。また、プルリクエストの行の最後には、お使いのコードホスティングサービスでプルリクエストを表示するオプションが表示されます。

各セクションの見出しにカーソルを合わせると、リストの更新、セクションのクエリの編集、セクションの削除などのオプションが表示されます。

A screenshot showing the header icons

最初のセクションでは、URL経由で任意のプルリクエストを読み込むことができます。任意のプルリクエストのURLを取得して貼り付けるだけで、CodeStreamの中でプルリクエストを見ることができます。

A screenshot showing how to open a PR through a url

Pull Requestsセクションの見出しにカーソルを合わせると、右側にアイコンが表示されます。

A screenshot showing the pull request section heading icons

オプションに含まれるもの

  • すべてのセクション(またはクエリ)を一度に更新します。
  • 新しいプルリクエストを作成します。
  • カスタムクエリに基づいて新しいセクションを作成します。なお、 GitHub および GitHub Enterprise または GitLab および GitLab Self-Managed のカスタムクエリを作成する際には、いくつかの特別なガイドラインがあります。
  • 歯車のアイコンをクリックすると、IDEで開いているリポジトリに関連するものだけでなく、すべてのリポジトリからのプルリクエストを表示する機能や、リストにラベルを含める機能など、より多くのオプションが表示されます。

CodeStreamを使ったレビューの特典

CodeStreamは、いくつかの重要な点でGitHubやGitLabの経験を改善しています。GitHubやGitLabでは、変更点を一連のdiffハンクとしてしか見ることができません。CodeStreamにもそのような表示がありますが、ファイル全体の文脈の中で変更点を確認したい場合は、リストビューやツリービューを使うことができます。コメントしたいコードを選択し、 Comment ボタンをクリックするか、コンテキストメニューから Comment を選択します。コメントする際には、単一のコメントを追加することも、レビューを開始することもできます。

A screenshot showing how to comment in a PR

CodeStreamでは、変更されていないコードの行にコメントを付けることができます。チェンジセットに含まれるコードだけでなく、差分に含まれるすべてのコード行を選択することができます。これらのコメントはプルリクエストに1つのコメントとして追加され、進行中のレビューには含まれません。

プルリクエストの作成

プルリクエストをいつでも開くには、CodeStreamペインの上部にある[ + ]ボタン、または[プルリクエスト]セクションのヘッダーにある[ + ]ボタンをクリックします。キーボードショートカットを使用することもできます(Macの場合はctlr+shift+/ pctrl+/ p 、GitLabユーザーの場合はm )。 CodeStreamには、プルリクエストを開く前に変更を確認するためのツリービュー、リストビュー、および差分ビューのオプションが用意されています。

A screenshot showing how to open a pull request

ワンクリックで、最後のコミットメッセージ、ブランチ名、またはチケットを選択して作業を開始した場合はチケットタイトルに基づいてプルリクエストの名前を付けることができます。チケットを選択して作業を開始した場合は、チケットのタイトルをプルリクエストの名前にすることができます。また、チケットを選択している場合は、そのチケットとプルリクエストを明示的に結びつけることができます。プルリクエストを提出する前に、フォームの下に表示されているファイルをクリックして、変更内容を確認してください。

作業中の機能ブランチにリモート追跡用ブランチがない場合は、プルリクエストを作成する際にリモート追跡用ブランチを設定することができます。

プルリクエストを作成するための以下のオプションもご覧ください。

GitHubのカスタムクエリ

デフォルトでは、GitHub の検索 API は GitHub 全体を対象としたグローバル検索を行います。そのため、検索結果が適切に制限されるようにするには、クエリに次のような修飾子を少なくともひとつ含める必要があります。

  • user:USERNAME
  • org:ORGNAME
  • repo:USERNAME/REPOSITORY
  • author:USERNAME
  • assignee:USERNAME
  • mentions:USERNAME
  • team:ORGNAME/TEAMNAME
  • commenter:USERNAME
  • involves:USERNAME
  • reviewed-by:USERNAME
  • review-requested:USERNAME
  • team-review-requested:TEAMNAME
  • project:PROJECT_BOARD

GitHubの検索構文についての詳細は、こちら をご覧ください。

GitLabカスタムクエリ [#gitlab]

すべての検索は、各パラメーターの間に&を含むattribute=value形式を使用して実行されます。スペースが含まれるパラメーターの場合は、そのままにし、パラメーターに引用符を付けないでください(たとえば、 labels=foo,help wanted )。 @meを使用して、ユーザーIDとユーザー名を指定できます。指定しない場合は、GitLabで見つけることができます。デフォルトでは、すべてのフィルターにパラメーターscope=allがあります(最小修飾子を参照)。これを上書きするには、 scope=Xを使用します。以下の例を参照してください。

検索構文は、GitLab のカスタム検索 API に由来します。 マージリクエスト検索 または 課題検索 の詳細については、GitLab のドキュメントを参照してください。

プルリクエストのレビュー

注意

Bitbucketでは現在、プルリクエストのレビューは利用できません。

プルリクエストがどこで作成されたかにかかわらず、CodeStreamの中で編集、レビュー、さらにはマージすることができます。GitHubやGitLabでプルリクエストを扱う方法を知っていれば、CodeStreamでも同じように扱うことができます。

プルリクエストを確認するには

  1. 詳細を確認してください。
  • GitHubのプルリクエストの詳細(レビュアー、アサイニー、ラベルなど)を編集できます。
  • GitLab マージリクエストでは、編集モード(ページ上部のドロップダウンから)またはサイドバーを使用することができます。デフォルトでは、GitLabマージリクエストには1人のレビュアーと1人のアサイニーしか追加できません。組織が複数のレビュアーとアサイニーをサポートしている場合は、CodeStream ペインの Merge Requests セクションの見出しにある歯車メニューをクリックして有効にしてください。
A screenshot showing how to assign multiple users to PR
  1. 会話の内容を確認してコメントを追加したり、共同作業者を@メンションすることができます。
A screenshot showing a conversation in a request
  1. 変更点を確認し、コメントを追加し、レビューを投稿することができます。
Copyright © 2022 New Relic Inc.