次の方法で共有


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

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

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

    管理者の資格情報でログオンしている場合でも、管理者として Internet Explorer を起動する必要があり、資格情報の入力を求められる場合があります。

  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

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

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

    詳細については、「 ワークスペース」コマンドを参照してください。