エージェント ソフトウェア バージョン 5

パイプライン チームは、エージェント ソフトウェアをバージョン 4.x からバージョン 5.x にアップグレードしています (.NET 10 を使用)。 エージェントをバージョン 5.x にアップグレードすることを強くお勧めします。

サポートされているオペレーティング システムで 5.x エージェントにアップグレードする

.NET 10 でサポートされている新しいオペレーティング システムでセルフホステッド エージェントを実行している場合、新しいバージョンのエージェント ソフトウェアが必要な機能またはタスクがある場合、新しいエージェント バージョンへのアップグレードは自動的に行われます。

更新プログラムを手動で開始するには、「 セルフホステッド エージェントの更新」を参照してください。

5.x エージェントでは、次のオペレーティング システムがサポートされています。

• Linux
  • x64
    • Debian 13 および 12
    • Fedora 44、43、42
    • openSUSE Leap 16.0
    • Red Hat Enterprise Linux 10、9、8
    • SUSE Enterprise Linux 16.0 および 15.7
    • Ubuntu 25.10、24.04、22.04
    • Azure Linux 3.0
    • CentOS Stream 10 および 9
    • Oracle Linux 9 および 8
  • ARM64
    • Debian 13 および 12
    • Fedora 44、43、42
    • Red Hat Enterprise Linux 10 および 9
    • Ubuntu 25.10、24.04、22.04
  • Alpine x64
    • Alpine Linux 3.23、3.22、3.21
• macOS
  • x64
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequoia"
    • macOS 26.0 "Tahoe"
  • ARM64
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequoia"
    • macOS 26.0 "Tahoe"
• Windows
  • x64
    • クライアント OS
      • Windows 10
        • 21H2、1809、1607
      • Windows 11
        • 26H1、25H2、24H2、23H2
    • サーバー OS
      • Windows Server 2025、2022、2019、2016、2012 R2、2012
  • ARM64
    • クライアント OS
      • Windows 11
        • 26H1、25H2、24H2、23H2

サポートされていないオペレーティング システムで 5.x エージェントにアップグレードする

.NET 10 をサポートしていないオペレーティング システムでセルフホステッド エージェントを実行している場合は、.NET 10 でサポートされている新しいサポートされているオペレーティング システムを使用するようにマシンを更新する必要があります。 更新後、エージェントを 5.x バージョンに更新する方法については、 セルフホステッド エージェントの更新に関するページを参照してください。

次のオペレーティング システムはセルフホステッド 4.x エージェントをサポートしていますが、.NET 10 ではサポートされていないため、バージョン 5.x エージェントの実行には使用できません。

• Linux
  • x64
    • Fedora 39 および 40
    • openSUSE 15.5 および 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 から 3.20
• macOS
  • x64
    • macOS 13.0 "ベンチュラ"
  • ARM64
    • macOS 13.0 "ベンチュラ"
• Windows
  • クライアント OS
    • Windows 11
      • 22H2、21H2

FAQ

4.x エージェントと 5.x エージェントの違いは何ですか?

4.x エージェントは .NET 8 を使用し、5.x エージェントは .NET 10 を使用します。

エージェントが 5.x にアップグレードできるかどうかを確認するにはどうすればよいですか?

エージェントのオペレーティング システムと、サポートされているオペレーティング システムの前の 「5.x エージェントへのアップグレード 」セクションのサポートされている一覧を比較します。

スクリプトを使用して、セルフホステッド プール内のエージェントが 5.x にアップグレードできるかどうかを予測することもできます。

今後、エージェントのセキュリティの問題はどのように修正されますか?

一般に、以前のバージョンのエージェント ソフトウェアはパッチを受け取りません。 5.x エージェントのみがパッチを取得します。 ただし、一部のAzure DevOps Serverのお客様は引き続き 4.x エージェントに依存しています。 そのため、製品チームは、ケース バイ ケースでセキュリティの問題を確認して決定します。

サポートされていない OS を使用している場合はどうすればよいですか?

.NET 10 がサポートする新しいオペレーティング システムに移行します。 そうしないと、エージェントがアップグレードを試みる可能性があり、OS に .NET 10 をインストールできないために失敗します。 製品チームは、エージェントの自動アップグレードを禁止する補足ブログ投稿でガイダンスをいくつか公開します。 ただし、このガイダンスは、エージェント マシンのアップグレードにより多くの時間を与える一時的なソリューションのみを目的としています。

プロジェクトの変更に取り組んでいなければ、3.x または 4.x エージェントを使用することはできますか?

No. パイプライン チームは、Azure Pipelinesに新しい機能を定期的に追加します。また、パイプラインがその機能に明示的に依存していない場合でも、それらの機能の一部でエージェントの更新が必要になる場合があります。 フォローアップ ブログのガイダンスを使用してエージェントの自動アップグレードを防ぐ場合、そのエージェントを使用してパイプラインをスケジュールすることはできません。 必要な機能を持つエージェントが見つからない場合、パイプラインの実行は失敗します。

5.x エージェント ソフトウェアをインストールする前に、.NET 10 をインストールする必要がありますか?

5.x エージェント ソフトウェアをインストールして構成する前に、エージェント コンピューターに .NET 10 をインストールする必要はありません。 5.x エージェントに必要なすべての.NET依存関係は、エージェント自体の一部です。

5.x エージェントを使用している場合、.NET 10 を使用してコードをビルドする必要がありますか?

5.x エージェントの実行に使用される.NETのバージョンは、エージェントのインストールに自己完結型であり、コードのビルドには使用されません。 コードのビルドに使用される .NET のバージョンは、パイプラインと、エージェント コンピューターにインストールした .NET のバージョンによって異なります。

Azure DevOps Services ではなく Azure DevOps Server を使用しています。 この変更は私に影響しますか?

Azure DevOps Serverの最新バージョンでは、4.x エージェント ソフトウェアが使用されます。

パイプライン チームは、今後も Azure DevOps Server のリリースに追随していく予定であれば、エージェント マシンを .NET 10 でサポートされるより新しいオペレーティング システムに今すぐ更新することをお勧めします。

Azure DevOps Serverは 5.x エージェントをサポートしていますか?

Azure DevOps Server のバージョンでは、そのバージョンと共にデプロイされるエージェントのバージョンがサポートされます。 Azure DevOps Serverの最新バージョンでは、4.x エージェント ソフトウェアが使用されます。

Azure DevOps Server は、製品の既存の機能に対して対象となる累積的なバグ修正プログラムを提供するセキュリティまたはサービス パッチを通じて処理されます。 最高かつ最も安全な製品エクスペリエンスを実現するために、Azure DevOps Serverの最新かつ最も安全なリリースを使用してください。 製品の最新バージョンは、Azure DevOps Serverダウンロード ページからダウンロードできます。

Azure DevOps Server の更新プログラムまたは新しいバージョンをインストールした後、エージェント 更新します。

エージェント バージョン 5 の展開のタイムラインは何ですか?

エージェント バージョン 5.x は 2026 年にリリースされます。

タスクでエージェントをエージェント バージョン 5 に更新する必要がある場合はどうなりますか?

通常、タスクに新しいバージョンのエージェントが必要な場合は、エージェント自体が自動的に更新されます。 現時点では、エージェント バージョン 4 は引き続き更新されますが、エージェント バージョン 4 からエージェント バージョン 5 への自動更新は無効になっています。 有効にすると、エージェント バージョン 5 と互換性のないオペレーティング システムでは、エージェント バージョン 4.x は v5 エージェントへの更新を試みません。 代わりに、まずオペレーティング システムをアップグレードする必要があることをユーザーに通知する警告が表示されます。 The operating system the agent is running on is <OS>, which will not be supported by the .NET 10 based v5 agent. Please upgrade the operating system of this host to ensure compatibility with the v5 agent. See https://aka.ms/azdo-pipeline-agent-version