ゲート チェックインによって制御されるフォルダーにチェックインする

  • [アーティクル]

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

Visual Studio 2019 | Visual Studio 2022

ゲート チェックイン ビルド プロセスによって制御されるバージョン コントロール フォルダーにファイルをチェックインする場合、チェックインを完了するにはさらに多くの手順を実行する必要があります。

[ゲート チェックイン] ダイアログ ボックスのスクリーンショット。

前提条件

ゲート チェックイン ビルド プロセス

チェックイン中に [ゲート チェックイン] ダイアログ ボックスが表示される場合は、変更を Azure Pipelines でビルドしてからチェックインする必要があります。

ゲート チェックインによって制御されるフォルダーに変更をチェックインする

  1. [ゲート チェックイン] ダイアログ ボックス で、[ビルド パイプライン] メニューが表示され、ビルドを実行する場合は、使用するビルド パイプラインを選択します。

  2. ビルド パイプライン名が既に [ゲート チェックイン] に表示されている場合、またはパイプラインを選択した後に、次のいずれかのオプションを選択します。

    • 変更をまだビルドしない場合は、[キャンセル] を選択します。 その後、必要に応じてプライベート ビルドでシェルブセットを手動でビルドできます。 詳細については、「CI/CD の概要」を参照してください。

    • 変更をビルドしたくない場合で、[ビルドによるチェックインの妥当性確認のオーバーライド] アクセス許可が [許可] に設定されている場合は、ゲート チェックイン ビルド要件をバイパスしてチェックインできます。

      [オプションの表示] を選択し、[ビルドの検証を省略して変更を直接チェックインする (アクセス許可が必要)] を選択します。

    • ゲート チェックインを続行し、ローカル ワークスペースの変更を破棄する場合は、[オプションの表示] を選択し、[保留中の変更をローカルに保存する] チェックボックスをオフにします。 [ビルドの変更] を選択し、ビルドが完了したら、「ゲート チェックイン後にワークスペースの最新の変更を削除する」の手順に従います。

    • 変更をビルドしてチェックインを続行するには、[ビルドの変更] を選択します。

      ローカル ワークスペースの変更を保持する場合は、ビルドの完了後、「ゲート チェックイン後にワークスペースの最新の変更を調整する」の手順に従います。

ビルド中、[チーム エクスプローラー] ウィンドウの [保留中の変更] ページには情報メッセージが表示され、こちらのリンクを選択すると、ビルド結果ウィンドウでビルドを監視できます。 チーム エクスプローラーの [ビルド] ページでビルドを監視することもできます。

ゲート チェックイン後にワークスペースの最新の変更を調整する

ゲートインチェック中にワークスペースで作業を続け、変更を保持する場合は、バージョン コントロールにチェックインされた変更と最新の変更を調整する必要があります。

ビルドの完了後:

  • ビルド結果ウィンドウに正常なビルドが表示される場合は、次のようにワークスペースを調整します。

    • ビルド通知アプリケーションを使用している場合は、[ゲート チェックイン] ダイアログ ボックスが表示されます。 [調整] を選択します。
    • または、チーム エクスプローラーの [ビルド] ページで、完了したビルドを右クリックし、[ワークスペースの調整] を選択します。 バージョン コントロールの競合を解決するには、[ワークスペースの調整] ダイアログ ボックスを使用します。

  • ビルドの結果ウィンドウにビルドが失敗したことが表示された場合は、失敗の原因となった問題を修正します。 チーム エクスプローラーの [ビルド] ページの [マイビルド] の下で失敗したビルドをダブルクリックするか、そのビルドを右クリックして [開く] を選択します。

    Azure Pipelines のビルド結果ウィンドウが開き、ビルドの失敗の原因となった問題の解決に役立つ情報が表示されます。 問題の種類によっては、エラーまたは問題を選択すると、修正が必要なファイルを表示できる場合があります。

ゲート チェックイン後にワークスペースの最新の変更を削除する

ゲート チェックイン後も変更に対する作業を続行する予定がない場合は、ワークスペースの最新の変更を削除できます。 変更はシェルブセットに保持されます。 ビルドが完了すると、変更がチェックインされます。 ビルドに失敗した場合は、シェルブセットをアンシェルブしてワークスペースに変更を戻すことができます。

  1. チェックイン時に、[ゲート チェックイン] ダイアログ ボックスで、[オプションの表示] を選択します。 [保留中の変更をローカルに保存する] チェック ボックスをオフにし、[ビルドの変更] を選択します。

  2. ビルドの完了後:

    • ビルド結果ウィンドウに正常なビルドとチェックインが表示された場合、変更がチェックインされたので、ワークスペースにこれらの変更が含まれるように最新バージョンのファイルを取得できます。 詳細については、「サーバーからのファイルのダウンロード (取得)」を参照してください。

    • ビルドの結果ウィンドウにビルドが失敗したことが表示された場合は、失敗の原因となった問題を修正します。 チーム エクスプローラーの [ビルド] ページの [マイビルド] の下で失敗したビルドをダブルクリックするか、そのビルドを右クリックして [開く] を選択します。

      Azure Pipelines のビルド結果ウィンドウで、ビルドの失敗の原因となった問題の解決に役立つ情報を探します。 問題の種類によっては、エラーまたは問題を選択すると、修正が必要なファイルを表示できる場合があります。

  3. シェルブセットから変更を取得します。 詳細については、「作業の中断とシェルブセットの管理」を参照してください。

  4. ファイルで、ビルドの失敗の原因となった問題を修正します。