クライアント コンピューターのデータ キャッシュの更新

  • [アーティクル]

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Azure DevOps のバージョン管理またはビルド操作中にワークスペース エラーが発生しないようにするには、特定のメンテナンス操作の後にクライアント コンピューター上のデータ キャッシュを更新する必要があります。

  • データ層サーバーまたはアプリケーション層サーバーを移動、復元、名前変更、またはフェールオーバーした後
  • ハードウェアの故障などの障害から復旧した後

どちらの場合も、作業項目を追跡するためにキャッシュを更新する必要があり、ユーザーはクライアント コンピューター上のバージョン管理キャッシュを更新する必要があります。

前提条件

StampWorkitemCache Web メソッドを呼び出すには、Azure DevOps のアプリケーション層サーバーの Administrators セキュリティ グループのメンバーである必要があります。 詳細については、「Azure DevOps Serverのアクセス許可リファレンス」を参照してください。

クライアント コンピューターで tf workspaces コマンドを使用するには、 読み取り アクセス許可を [許可] に設定する必要があります。

作業項目キャッシュの更新

この手順は省略可能です。 実行する必要があるのは、作業項目トラッキングでエラーが発生した場合だけです。

作業項目を追跡するためにキャッシュを更新するには、 StampWorkitemCache Web メソッドを呼び出します。 このメソッドは、次回アプリケーション層サーバーに接続する際に、クライアント コンピューターにキャッシュの更新を強制します。 また、このメソッドは、クライアント コンピューターで定義されているワークスペースを同期します。

注意

StampWorkitemCache Web メソッドを呼び出すと、Visual Studio Azure DevOps Serverのパフォーマンスが一時的に低下する可能性があります。 パフォーマンスへの影響は、 メソッドを呼び出すときに接続されている Azure DevOps ユーザーの数によって異なります。

クライアント コンピューター上の作業項目を追跡するためにキャッシュを更新するには:

  1. 新しいサーバーで、Internet Explorer を開きます。

  2. [アドレス] バーに、次のアドレスを入力して ClientService Web サービスに接続します。

    http://PublicURL/VirtualDirectory:8080/WorkItemTracking/v3.0/ClientService.asmx

    注意

    管理者資格情報でログオンしている場合でも、管理者としてインターネット エクスプローラーを開始する必要があり、資格情報の入力を求められる場合があります。

  3. [ StampWorkitemCache] を選択し、[ 呼び出し] を選択します。 StampWorkitemCache メソッドはデータを返しません。

バージョン管理キャッシュを更新する

バージョン 管理キャッシュを更新するために、各ユーザーは更新する必要がある各コンピューターで tf workspaces コマンドを実行します。 バージョン管理を使用し、データベースが再配置されたプロジェクト コレクションに接続するすべてのコンピューターを更新する必要があります。

クライアント コンピューターのバージョン管理キャッシュを更新するには:

  1. クライアント コンピューターで、管理者権限を持つコマンド プロンプト ウィンドウを開き、ディレクトリを Drive:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE に変更します。

  2. コマンド プロンプトで、次のコマンドを入力し、新しいサーバーのサーバー名とポート番号を含むコレクションの URL を指定します。

    tf workspaces /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName

    デプロイ例では、開発者は、DefaultCollection コレクションのメンバーであるプロジェクトのバージョン管理キャッシュを更新する必要があります。これは、Azure DevOps Serverの FabrikamPrime デプロイでホストされています。

    tf workspaces /collection:http://FabrikamPrime:8080/tfs/DefaultCollection

    詳細については、「 Workspaces コマンド」を参照してください。