ローカル エージェントの更新

この記事では、ローカル エージェントを更新する方法について説明します。 最新バージョンのローカル エージェントは、2026 年 2 月にリリースされたバージョン 3.5.0 です。

Lifecycle Services から最新のローカル エージェントおよび構成をダウンロード

1. Lifecycle Services で、プロジェクト設定>オンプレミス コネクタ を選択します。

2. 環境へのコネクタを選択し、編集 を選択します。

3. ページの左側にあるメニューの、ホスト インフラストラクチャ設定を選択し、エージェント インストーラーのダウンロードを選択します。

   zip ファイルがダウンロードされ、ブロック解除されていることを確認する必要があります。

4. zip ファイルに移動し、右クリックして プロパティ を選択します。

5. プロパティ ダイアログ ボックスで、ブロック解除を選択してから適用を選択します。

6. エージェントのコンフィギュレーションタブで、コンフィギュレーションのダウンロードを選択し、localagent-config.json コンフィギュレーション ファイルをダウンロードします。

既存のローカル エージェントのクリーンアップ

1. 以前にローカル エージェントをインストールしたフォルダーを見つけます。

2. PowerShell ウィンドウで、そのフォルダーに移動し、次のコマンドを実行します。

   LocalAgentCLI.exe Cleanup <path of localagent-config.json>
   

   Note

   エージェントをクリーンアップするには、現在のエージェントのバイナリ ファイルを使用する必要があります。 現在のエージェントのバイナリ ファイルがない場合は、Service Fabric Explorer からローカル エージェント アプリケーションを削除できます。

3. クリーンアップ操作を終了するには、任意のキーを選択します。

4. Service Fabric Explorer を調べて、Orchestrator ノードの [デプロイされたアプリケーション] セクションにアプリがないことを確認して、ローカル エージェントが正常にクリーンアップされたことを確認します。

新しいローカル エージェントをインストールする

1. 以前ダウンロードしたzipファイルと localagent-config.json ファイルを、 インフラストラクチャ フォルダ(例: \\LBDFFILE01\Install)をファイル共有にコピーします。

2. エージェントインストーラーを \\LBDFFILE01\Install\LocalAgentに解凍してください。

3. localagent-config.json ファイルを \\LBDFFILE01\Install\LocalAgentにコピーしてください。

4. PowerShellウィンドウで \\LBDFFILE01\Install\LocalAgentに移動し、次のコマンドを実行します。

   LocalAgentCLI.exe Install <path of localagent-config.json>
   

5. ローカル エージェントが正常にインストールされてから、Lifecycle Services のオンプレミス コネクタに戻るようにします。

6. 検証の設定 タブで、エージェントにメッセージを送る を選択して、新しいローカル エージェントへの Lifecycle Services 接続をテストします。

ローカル エージェントの有効期限

ローカル エージェントの有効期限が切れると、ライフサイクル サービスと通信できなくなります。 そのため、ローカル エージェントをサポートされているバージョンに更新する必要があります。 今後、Microsoft では一度に数バージョンのローカル エージェントのみをサポートする予定です。 最近リリースされた 2 つのバージョンには、新しいバージョンがリリースされるまで有効期限はありません。 その時点で、有効期限のない最も古いバージョンが取得されます。 有効期限は数か月後に設定されるため、新しいバージョンにアップグレードする時間が得られます。

リリース

ローカル エージェント 3.5.0 の新機能

• Service Fabric SDK をバージョン 7.1 にアップグレードします。
• Azure Storage ライブラリをアップグレードします。
• ファイル共有が利用できない場合にローカルエージェントがフリーズする問題を修正します。
• デプロイ作業中にインストーラーが滞りやすい問題を修正します。

ローカル エージェント 3.4.0 の新機能

• Service Fabric SDK をバージョン 7.0 にアップグレードします。
• Azure Storage ライブラリをアップグレードします。
• Bridge サービスでライフサイクル サービスのエラー処理が改善されました。

ローカル エージェント 3.3.0 の新機能

• Service Fabric 動的ノード タグを管理するための新しい機能を追加します。 この機能は、インフラスクリプトのバージョン2.20.0が提供する追加セットアップを必要とします。

ローカル エージェント 3.2.3 の新機能

• topology.xml がキャッシュされ、ライフサイクル サービスから更新されなかったバグを修正しました。
• 証明書のローテーション後に config.json を更新する必要が削除されます。
• ローカル エージェントと SQL データベースの間で暗号化された通信を強制します。

ローカル エージェント 3.2.2 の新機能

• ローカルエージェントがワークスペースディレクトリを整理できないバグを修正します。なぜなら、ディレクトリには長いパスのファイルが含まれているからです。

ローカル エージェント 3.2.1 の新機能

• ローカルエージェントがAzure Storageからアーティファクトを正しくダウンロードできないバグを修正します。
• Azure Storage ライブラリをアップグレードします。
• 7zip 操作のログを追加します。

ローカル エージェント 3.2.0 の新機能

• ローカル エージェント 3.2.0 では、新しい Service Fabric Explorer SDK とランタイムが使用されます。
• このバージョンはAzure Storageライブラリを最新バージョンにアップグレードします。 チェックポイント機能は使用できなくなりましたが、カスタマイズできる自動再試行機能が追加されました。 Azure Storage ライブラリが再びチェックポイントをサポートしている場合、製品チームはチェックポイントを戻す可能性があります。
• アーティファクト管理ロジックの改善により、エージェントが既存のアーティファクトを再ダウンロードしないようにしました。
• Lifecycle Services アーティファクト ストア内のものとアーティファクト ストア内のアーティファクトが完全に一致することを保証するために、ファイル ハッシュ検証を追加しました。
• エージェントは MSAL ライブラリを使用して、Microsoft Entra IDで認証します。
• エージェントは、非推奨になったときを検出し、Service Fabric Explorer で明確なメッセージングを表示します。

ローカル エージェント 3.1.0 の新機能

• ローカル エージェント 3.1.0 では、新しい Service Fabric SDK とランタイムが使用されます。
• このバージョンでは、 回帰スイート自動化ツール (RSAT) を使用するように環境を構成する必要があることを指定する新しいデプロイ オプションが導入されています。 詳細については、配置オプションを参照してください。

ローカル エージェント 3.0.0 の新機能

• ローカル エージェント 3.0.0 には、スケール ユニット管理ポータルを通じて Edge Scale Unit のライフサイクルを管理するためのサポートが含まれます。 詳細については、分散ハイブリッド トポロジを参照してください。
• このバージョンでは、ライフサイクル サービスからの最新の変更を使用するには、.NET Framework バージョン 4.8 が必要です。

ローカル エージェント 2.7.2 の新機能

• ローカル エージェント 2.7.2 では、古いバージョンのアプリケーション上の環境のデプロイに失敗する問題が修正されます。

ローカル エージェント 2.7.1 の新機能

• ローカル エージェント 2.7.1では、新しい展開オプションが証明書の証明書失効リストのチェックをスキップするように指定するに導入されます。
• このリリースでは 、office365AdfsCompatibility のdeploymentOptionが正しく設定されていなかったバグを修正します。

ローカル エージェント 2.7.0 の新機能

• Local agent 2.7.0 は、10.0.21 以降のリリースを展開または更新する前提条件となるものです。
• このリリースを使用すると、環境に固有の配置オプションに対する、限定された一連の配置オプションを指定できます。 特に、このリリースでは Microsoft SQL Server 2019 を使用する環境への配置が可能になります。 すべての有効なコンフィギュレーションについては、ローカル エージェントの配置コンフィギュレーションを参照してください。
• さらに、このリリースでは、ローカル エージェントが実行されている gMSA アカウントが一部の証明書の秘密キーに対するアクセス許可を失うという問題が修正されます。
• イベント ビューアーが開いている場合でも、LBDTelemetry-Agent アプリケーションを正常に開始できます。

ローカル エージェント 2.6.0 の新機能

• ローカルエージェント2.6.0は新しいService Fabric SDKとランタイムを使用しています。
• このバージョンは、環境がダウンロードフェーズに停滞しているときにリフレッシュ状態がトリガーされると、環境が自動的にデプロイ済み状態に移行し、環境を更新するというバグを修正しています。 この場合、リフレッシュ状態操作はダウンロードフェーズを失敗としてマークします。
• アプリケーションのプロビジョニングのタイムアウトが増加します。

ローカル エージェント 2.5.0 の新機能

• ローカルエージェント2.5.0は、さまざまな依存関係の新しいバージョンを使用しています。 主な変更点は、Service Fabric と Entity Framework です。
• このバージョンでは、サービスがクリーンアップされずにクリーンアップが失敗した場合、その後の再挑戦が必ずクリーンアップ中に失敗するというバグも修正されています。

ローカル エージェント 2.4.0 の新機能

• ローカルエージェント2.4.0では、ライフサイクルサービスからの最新変更を使用するために.NETフレームワークバージョン4.7.2が必要です。 最新の要件を満たすために、Lifecycle Services で利用可能な最新のインフラストラクチャ スクリプトを実行してください。
• このバージョンはまた、タイムアウトがハードコーディングされたため、遅い環境での展開が失敗する問題も修正しています。

ローカル エージェント 2.3.0 の新機能

• ローカル エージェント 2.3.0 は、カスタム実行を有効にします 配置前および配置後のスクリプト。
• 2.2.0 では、以前のプラットフォーム更新プログラムを展開する際に発生する問題が修正されます。
• このバージョンではモニタリングエージェントが削除され、ETWManifestのインストールに使われるLBDTelemetryという新しいサービスが導入されました。

ローカル エージェント 2.1.0 の新機能

• ローカル エージェント 2.1.0 では、環境の準備および環境の更新が 2 つの異なる手順および明示的アクションである 2 フェーズのサービスを有効にします。 この変更により、事前に準備を行い、準備中にユーザーが環境を使用できるようにすることで、オンプレミス環境に更新プログラムを適用するときにお客様が要するダウンタイムの合計が短縮されます。 その後、実際の更新環境アクションがトリガーされたときにダウンタイムが通知されます。

ローカル エージェント 2.0.0 の新機能

• ローカル エージェント 2.0.0 はプラットフォーム更新プログラム 12 を展開できます。
• プラットフォーム更新プログラム 12 の配置の初回成功まで、再構成機能は有効になります。
• プラットフォーム更新プログラム 12 の配置の初回成功時は、再構成機能は無効になります。 配置が成功した後、定期的な更新エクスペリエンスを使用して環境を更新することができます。