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、ビルドを可視化できます。

そこから、作業項目にリンクされているブランチ、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 を作成して、メイン ブランチに加えた変更をマージし、チームの他のメンバーに変更をレビューしてもらいます。

   

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

   

   注意

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

   

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

   

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

   

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

   

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

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

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

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

既存の開発およびビルド オブジェクトにリンクする

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

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

リンクを削除する

リンクを削除する場合は、まず [開発] セクションでリンクを強調表示し、[リンクの削除] を選択します。

または、[リンク] タブからリンクを選択し、リンクの [アクション] を選択して、[リンクの削除] オプションを選択します。

関連記事

• サービス間の概要
• 作業の追跡をサポートするためのパイプラインの構成
• 作業項目の追加
• Git の概要
• GitHub コミットと pull request の作業項目とのリンク
• 他のオブジェクトから作業項目へのリンク

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

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

[開発] セクションに表示されるリンクの種類

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

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

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

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