次の方法で共有


Azure Boards の作業項目から Git 開発を推進する

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

チームが開発を推進し、同期を維持する方法の 1 つは、ブランチ、コミット、pull request、ビルドなど、開発中に作成されたオブジェクトに作業項目をリンクすることです。 そのリンクを開始するには、まず 1 つ以上の作業項目からブランチを作成します。 その後、pull request を作成し、コミットをすばやく開いて、特定の作業を完了するために実行された開発操作の記録を保持することができます。

この記事では、次のタスクを行う方法について説明します。

  • 作業項目から新しいブランチまたは pull request を作成する方法
  • pull request を完了する
  • スカッシュ マージを実行する
  • 複数の作業項目のブランチを作成する
  • 作業項目を既存の開発およびビルド オブジェクトにリンクする

この記事では、新しいブランチの作成、コミットへのリンクの追加、Azure DevOps でホストされている Git リポジトリへの pull request の追加について説明します。 GitHub のコミットとプル要求にリンクするには、「GitHub コミットと pull request の作業項目とのリンク」を参照してください。

ヒント

作業項目を Git コミット、pull request、ビルドなどにリンクする、自動リンクやその他の設定を行うことができます。 詳細については、次のリソースを参照してください。

開発コントロール

開発コントロールは、作業項目の完了をサポートするすべての Git 開発プロセスを記録します。 このコントロールでは、次の開発ステップを実行するために必要な情報をチームで確認し、一般的な開発タスクの遂行に必要な操作を最小限に抑えることができます。 また、追跡可能性もサポートされており、作業項目に関連するすべてのブランチ、コミット、pull request、ビルドを可視化できます。

作業項目フォーム、[開発] コントロールのスクリーンショット。

作業項目フォーム、[開発] コントロールのスクリーンショット (Azure DevOps Server 2019)。

そこから、作業項目にリンクされているブランチ、pull request、コミットにすばやくアクセスできます。 また、作業項目から作成またはリンクしたブランチの pull request を開始できます。

開発コントロールは、Web ポータルの作業項目フォーム内にのみ表示されることに注意してください。 Visual Studio またはその他のサポートされているクライアントに表示される作業項目の追跡エクスペリエンスとフォームには、Web ポータルから使用できる機能の一部は表示されません。

前提条件

  • プロジェクトへの接続。 プロジェクトがまだない場合は、作成します。
  • 共同作成者またはプロジェクト管理者セキュリティ グループのメンバーとしてプロジェクトに追加される必要があります。 追加するには、プロジェクトまたはチームにユーザーを追加します。
  • 作業項目を表示または変更するには、[このノードの作業項目の表示] および [このノードの作業項目の編集] アクセス許可を [許可] に設定している必要があります。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。
  • プロジェクトへの接続。 プロジェクトがまだない場合は、作成します。
  • 共同作成者またはプロジェクト管理者セキュリティ グループのメンバーとしてプロジェクトに追加される必要があります。 追加するには、プロジェクトまたはチームにユーザーを追加します。
  • 作業項目を表示または変更するには、[このノードの作業項目の表示] および [このノードの作業項目の編集] アクセス許可を [許可] に設定している必要があります。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。

ワークフロー プロセス

リンクされたコード成果物がない場合は、新しいブランチを作成することを検討してください。 ブランチが存在するが、pull request がない場合は、pull request の作成を検討してください。 Git リポジトリを使用する場合の一般的なワークフロー シーケンスを次に示します。

  1. ブランチを作成して作業項目の作業を開始します。 新しい Git ブランチは [開発] セクションから追加できます。

    開発コントロールのスクリーンショット、[ブランチの作成] リンク。

    ...または、フォームの [アクション] メニューから。

    ユーザー ストーリー作業項目フォーム、[アクション] メニュー、[新しいブランチを作成する]。

    ブランチに名前を付け、リポジトリを選択します。

    [ブランチの作成] ダイアログ ボックス

    作成したブランチは作業項目に自動的にリンクされます。

    Note

    ブランチは、メイン ブランチにファイルを追加した後にのみ作成できます。main やその他の固有のラベルを付けることをお勧めします。 システムは、新しいプロジェクトごとに作成される初期リポジトリに、README ファイルを自動的に追加します。

  2. 作成したリポジトリとブランチが開きます。

    ファイルの編集は Web ポータル内で行えます。

    または、広範なファイル編集がある場合や、ファイルを追加する必要がある場合は、Visual Studio や、サポートされているその他の IDE から作業します。 作成したブランチから新しいローカル ブランチを追加します。 詳細については、「fetch と pull を使用してコードを更新する」の「フェッチを使用して変更をダウンロードする」を参照してください。 (コードの編集とコミットのプロセスはいずれも機能しますが、Visual Studio のエディションの方が最適に動作します)

  3. 作成したブランチ内のファイルを追加または変更します。

    Visual Studio またはその他のサポートされている IDE から、変更をコミットし、ローカル ブランチからリポジトリにプッシュします。

    変更のコミットとプッシュ

    新しいブランチから初めて変更をプッシュする場合、変更をプッシュする前にブランチを公開します。 詳細については、「push を使用してコードを共有する」を参照してください。

  4. 作業項目フォームから pull request を作成します。

    pull request を作成して、メイン ブランチに加えた変更をマージし、チームの他のメンバーに変更をレビューしてもらいます。

    開発コントロールのスクリーンショット、[pull request の作成] リンク。

  5. ビューが [コード]、[Pull Requests] ページに切り替わります。 次に示すように、pull request の作成を完了します。

    コード ビューの Pull Request ページ。

    注意

    pull request を作成したら、前の pull request を完了するまで、同じブランチに対して新しい pull request を作成することはできません。

    Pull Request ページ、pull request の作成。

    [マージする場合にスカッシュが変更] のチェック ボックスをオンにし、マージを完了します。

    [Pull Request の完了] ダイアログ ボックス、スカッシュ マージのチェックマーク

  6. 完了すると、次のような画面が表示されます。

    pull request、完了の通知

  7. 作業項目フォームを開くか、フォームを更新し、[ 開発 ] セクションを展開します ( Maximize Development を選択します)。完了した操作をサポートするために追加されたリンクが表示されます。

    作業項目フォーム、[開発] セクション、追加されたリンクのスクリーンショット。

複数の作業項目のブランチを作成する

作業項目を開かなくても、バックログまたはボードに一覧表示されている作業項目から新しい分岐を追加することもできます。 複数選択を使用すると、複数の作業項目を選択し、新しいブランチを作成できます。項目はすべてブランチにリンクされます。

たとえば、この例では、新しいブランチにリンクする最初の 5 つの項目を選択しています。

バックログから複数の項目を選択する画面のスクリーンショット (ブランチの作成リンク)。

さらに、ブランチの名前を指定しています。

新しいブランチの作成ダイアログ

[開発] セクションに一覧表示されているすべての項目は、[ Links ] タブにも表示されます。[開発] セクションから開始されたすべての開発アクションは、 History タブにも記録されます。

[リンク] タブ、開発のリンク

作業項目を既存のオブジェクトにリンクするには、[リンクの追加] [リンクの追加] アイコンを選択し、リンクの種類を選択します。

[リンクの追加] アイコンを選択し、リンクの種類を選択します。

リンクを削除する場合は、 Development セクションでリンクを強調表示してから、[リンクの削除 ] を選択

[開発] セクション、リンクの削除

または、 Links タブからそれを選択し、リンクの Actions を選択し、 Remove link オプションを選択します。

ビルド内の関連する作業項目

Git コミットでは、コミットにリンクされているすべての作業項目が、ビルドの概要ページの [関連付けられた作業項目] の下に一覧表示されます。

ビルドの概要ページの [関連付けられた作業項目] の下に表示される、リンクされた作業項目。

このセクションに示すリンクは、次のアクションのために表示されます。

  • 作業項目から、ブランチ、コミット、または pull request を作成する
  • コミット、pull request、またはその他のサポートされている Git または TFVC 操作中に、作業項目 ID を指定する
  • 具体的には、 Development セクションまたは Links タブから、ソース コードブランチ、ビルド、またはその他のサポートされている Git または TFVC 操作に作業項目をリンクします。

[開発] セクションの下に一覧表示されているエントリにカーソルを合わせると、関連付けられているオブジェクトへのハイパーリンクがアクティブになります。

開発セクション内で追加できるリンクの種類は、ブランチ、ビルド、変更セット、コミット、発見されたビルド、ビルドに統合、Pull Request、バージョン管理された項目です。

成果物間のリンクの種類

リンク コントロールの詳細、または開発リンク コントロールのカスタマイズについては、「 LinksControlOptions 要素、開発リンク コントロールを参照してください。