Microsoft によってホストされるエージェント

[アーティクル]
04/15/2024

Azure DevOps Services

Microsoft ホステッドエージェントは、クラウドでホストされている Azure DevOps Services でのみ使用できます。 Microsoft ホステッドエージェントまたは Azure Pipelines エージェントプールは、オンプレミスの TFS または Azure DevOps Server では使用できません。これらのオンプレミスバージョンでは、セルフホステッドエージェントを使う必要があります。

重要

Azure DevOps コンテンツバージョンセレクターからバージョンを選択。

お使いのプラットフォームとバージョンに対応するこの記事のバージョンを選択します。バージョンセレクターは目次の上にあります。 Azure DevOps のプラットフォームとバージョンを検索します。

パイプラインが Azure Pipelines にある場合は、Microsoft ホステッドエージェントを使ってジョブを実行する便利なオプションがあります。 Microsoft によってホストされているエージェントを使用すると、メンテナンスとアップグレードが自動的に行われます。パイプラインで指定した VM イメージの最新バージョンが常に取得されます。パイプラインを実行するたびに、パイプラインの各ジョブに対して新しい仮想マシンが取得されます。仮想マシンは 1 つのジョブの後に破棄されます (つまり、コードのチェックアウトなど、ジョブが仮想マシンファイルシステムに加えた変更は、次のジョブで使用できなくなります)。 Microsoft ホステッドエージェントは、VM 上で直接またはコンテナー内でジョブを実行できます。

Azure Pipelines には、Azure Pipelines という名前の事前定義されたエージェントプールと、Microsoft ホステッドエージェントが用意されています。

多くのチームにとって、ジョブを実行するにはこれが最も簡単な方法です。まず試してみて、ビルドまたはデプロイに対して機能するかどうかを確認できます。そうされない場合は、スケールセットエージェントまたはセルフホステッドエージェントを使用できます。

ヒント

Microsoft ホステッドエージェントは無料で試すことができます。

ソフトウェア

Azure Pipelines エージェントプールには選択できる複数の仮想マシンイメージが用意されており、それぞれに広範なツールとソフトウェアが含まれます。

Image	クラシックエディターエージェントの指定	YAML VM イメージラベル	含まれるソフトウェア
Visual Studio 2022 を含む Windows Server 2022	windows-2022	`windows-latest` または `windows-2022`	リンク
Visual Studio 2019 を含む Windows Server 2019	windows-2019	`windows-2019`	リンク
Ubuntu 24.04	ubuntu-24.04	`ubuntu-24.04`	リンク
Ubuntu 22.04	ubuntu-22.04	`ubuntu-latest` または `ubuntu-22.04`	リンク
Ubuntu 20.04	ubuntu-20.04	`ubuntu-20.04`	リンク
macOS 15 Sequia プレビュー	macOS-15	`macOS-15`	リンク
macOS 14 Sonoma	macOS-14	`macOS-latest`または`macOS-14`	リンク
macOS 13 Ventura	macOS-13	`macOS-13`	リンク
macOS 12 Monterey	macOS-12	`macOS-12`	deprecated

クラシックビルドパイプラインの既定のエージェントイメージは windows-2019 で、YAML ビルドパイプラインの既定のエージェントイメージは ubuntu-latest です。詳しくは、「パイプライン内のプールを指定する」をご覧ください。

表の「含まれるソフトウェア」のリンクを選ぶと、各ホステッドエージェントにインストールされているソフトウェアを確認できます。 macOS イメージを使っている場合は、ツールのバージョンから手動で選択できます。詳細については、こちらを参照してください。

非推奨のホステッドイメージを使用しているパイプラインを確認する方法

非推奨のイメージを使っているパイプラインを確認するには、組織で https://dev.azure.com/{organization}/{project}/_settings/agentqueues を参照し、イメージ名でフィルター処理して調べます。次の例では、vs2017-win2016 イメージを調べています。

イメージ名によるパイプラインのフィルター処理のスクリーンショット。

次の例で示すように、こちらにあるスクリプトを使って、複数のプロジェクトを対象にジョブ履歴で非推奨のイメージを照会することもできます。

./QueryJobHistoryForRetiredImages.ps1 -accountUrl https://dev.azure.com/{org} -pat {pat}

YAML パイプラインでは、プールを指定しないと、パイプラインは既定で Azure Pipelines エージェントプールを使用します。使用する仮想マシンイメージを指定するだけでかまいません。

jobs:
- job: Linux
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - script: echo hello from Linux
- job: macOS
  pool:
    vmImage: 'macOS-latest'
  steps:
  - script: echo hello from macOS
- job: Windows
  pool:
    vmImage: 'windows-latest'
  steps:
  - script: echo hello from Windows

注意

YAML ファイルでは、複数のレベルでプールを指定できます。パイプラインが想定したイメージで実行されていないことに気付いた場合は、パイプライン、ステージ、ジョブのレベルでプールの指定を確認してください。

ハードコーディングされた参照を使わない

Microsoft ホステッドエージェントを使うときは、常に、変数を使ってビルド環境とエージェントリソースを参照します。たとえば、リポジトリを含むドライブ文字やフォルダーをハードコーディングしないでください。ホステッドエージェントトの正確なレイアウトは、警告なしに変更される可能性があります。

ハードウェア

Windows と Linux のイメージを実行する Microsoft ホステッドエージェントは、2 コアの CPU、7 GB の RAM、14 GB の SSD ディスク領域を備えた Azure 汎用仮想マシンにプロビジョニングされます。これらの仮想マシンは、Azure DevOps 組織と同じ地理的な場所に併置されます。

macOS イメージを実行するエージェントは、3 コアの CPU、14 GB の RAM、14 GB の SSD ディスク領域を備えた Mac Pro にプロビジョニングされます。これらのエージェントは、Azure DevOps 組織の場所に関係なく、常に米国で実行されます。データ主権が重要であり、組織が米国にない場合は、macOS イメージを使わないでください。詳細については、こちらを参照してください。

これらのマシンはすべて、少なくとも 10 GB の空きディスク領域を備えており、パイプラインの実行に使用できます。この空き領域は、パイプラインによるソースコードのチェックアウト、パッケージのダウンロード、Docker イメージのプル、中間ファイルの生成に使われます。

重要

Microsoft ホステッドエージェントでのディスク領域の増量や、より強力なマシンのプロビジョニングに対する要求には、お応えできません。 Microsoft ホステッドエージェントの仕様がニーズを満たしていない場合は、セルフホステッドエージェントまたはスケールセットエージェントを検討する必要があります。

ネットワーク

一部のセットアップでは、エージェントがデプロイされる IP アドレスの範囲を把握することが必要になる場合があります。たとえば、ホステッドエージェントにファイアウォール経由のアクセスを許可する必要がある場合は、そのアクセスを IP アドレスで制限できます。 Azure DevOps は Azure グローバルネットワークを使っているため、IP 範囲は時間が経つと変わります。 Microsoft は、リージョン別に Azure データセンターの IP 範囲の一覧を示す JSON ファイルを毎週公開しています。このファイルは、新しい計画された IP 範囲で毎週更新されます。ダウンロードできるのは最新バージョンのファイルのみです。以前のバージョンが必要な場合、毎週、利用可能になったときにダウンロードしてアーカイブする必要があります。新しい IP 範囲は、次の週に有効になります。常に最新のリストを維持するため、頻繁に (少なくとも毎週 1 回) 戻ってチェックすることをお勧めします。エージェントジョブが失敗し始めた場合、重要な最初のトラブルシューティング手順は、お使いの構成が最新の IP アドレスの一覧と一致していることを確認することです。ホステッドエージェントの IP アドレス範囲は、AzureCloud.<region> にある週単位のファイルに一覧表示されています (たとえば、米国西部リージョンの場合は AzureCloud.westus)。

ホステッドエージェントは、組織と同じ Azure の地域で実行されます。各地域には、1 つ以上のリージョンが含まれます。エージェントは組織と同じリージョンで実行されることもありますが、その保証はありません。エージェントで可能性のある IP 範囲の完全な一覧を取得するには、地域に含まれるすべてのリージョンの IP 範囲を使用する必要があります。たとえば、組織が米国地域にある場合は、その地域のすべてのリージョンの IP 範囲を使う必要があります。

ご自分の地域を確認するには、https://dev.azure.com/<your_organization>/_settings/organizationOverview に移動し、自分のリージョンを取得して、「Azure の地域」のテーブルから関連付けられている地域を見つけます。自分の地域がわかったら、その地域のすべてのリージョンに対する週単位のファイルの IP 範囲を使用します。

重要

ExpressRoute や VPN などのプライベート接続を使って、Microsoft ホステッドエージェントを企業ネットワークに接続することはできません。 Microsoft ホステッドエージェントとサーバー間のトラフィックは、パブリックネットワークを経由します。

Microsoft ホステッドエージェントで使用可能な IP 範囲を特定するには

[組織の設定] で、組織のリージョンを特定します。
組織のリージョンに対する Azure の地域を特定します。
地域内のリージョンの名前を、AzureCloud.<region> の形式に従って、週単位のファイルで使用される形式にマップします (AzureCloud.westus など)。 Azure 地域リストのリージョンの名前を週単位のファイルで使用される形式にマップするには、.NET 用 Azure 管理ライブラリから、Region クラスのソースコードで定義されているリージョンのコンストラクターに渡されるリージョン名を確認します。

注意

.NET 用 Azure 管理ライブラリには地域に対するリージョンを一覧表示する API がないため、次の例に示すように、それらを手動で一覧表示する必要があります。
週単位のファイルから、地域内のすべてのリージョンの IP アドレスを取得します。リージョンがブラジル南部または西ヨーロッパの場合は、次の注意で説明するように、フォールバック地域に基づいて追加の IP 範囲を含める必要があります。

注意

容量の制限により、ブラジル南部または西ヨーロッパ リージョンの一部の組織では、想定される地域の外部にあるホステッドエージェントが表示されることがあります。このような場合は、前のセクションで説明したように、地域内のすべてのリージョンの IP 範囲を含めるだけでなく、容量フォールバック地域のリージョンに対する追加の IP 範囲を含める必要があります。

組織がブラジル南部リージョンにある場合、容量フォールバック地域は米国です。

組織が西ヨーロッパ リージョンにある場合、容量フォールバック地域はフランスです。

Microsoft の Mac IP 範囲は、GitHub の macOS クラウドでホストされているため、上記の Azure IP には含まれていません。 IP 範囲は、こちらに記載されている手順に従って、GitHub メタデータ API を使って取得できます。

例

次の例では、米国西部リージョンの組織に対するホステッドエージェントの IP アドレス範囲が、週単位のファイルから取得されます。米国西部リージョンは米国地域であるため、米国地域のすべてのリージョンの IP アドレスが含まれます。この例では、IP アドレスはコンソールに表示されます。

using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

namespace WeeklyFileIPRanges
{
    class Program
    {
        // Path to the locally saved weekly file
        const string weeklyFilePath = @"C:\MyPath\ServiceTags_Public_20230904.json";

        static void Main(string[] args)
        {
            // United States geography has the following regions:
            // Central US, East US, East US 2, East US 3, North Central US, 
            // South Central US, West Central US, West US, West US 2, West US 3
            // This list is accurate as of 9/8/2023
            List<string> USGeographyRegions = new List<string>
            {
                "centralus",
                "eastus",
                "eastus2",
                "eastus3",
                "northcentralus",
                "southcentralus",
                "westcentralus",
                "westus",
                "westus2",
                "westus3"
            };

            // Load the weekly file
            JObject weeklyFile = JObject.Parse(File.ReadAllText(weeklyFilePath));
            JArray values = (JArray)weeklyFile["values"];

            foreach (string region in USGeographyRegions)
            {
                string tag = $"AzureCloud.{region}";
                Console.WriteLine(tag);

                var ipList =
                    from v in values
                    where tag.Equals((string)v["name"], StringComparison.OrdinalIgnoreCase)
                    select v["properties"]["addressPrefixes"];

                foreach (var ip in ipList.Children())
                {
                    Console.WriteLine(ip);
                }
            }
        }
    }
}

サービスタグ

Microsoft ホステッドエージェントをサービスタグで一覧表示することはできません。ホステッドエージェントにリソースへのアクセスを許可しようとする場合は、IP 範囲の許可リストの方法に従う必要があります。

セキュリティ

Microsoft ホステッドエージェントは、セキュリティ保護された Azure プラットフォームで実行されます。ただし、次のセキュリティに関する考慮事項に注意する必要があります。

Microsoft ホステッドエージェントは Azure パブリックネットワーク上で実行されますが、パブリック IP アドレスは割り当てられません。そのため、外部エンティティは Microsoft ホステッドエージェントをターゲットにできません。
Microsoft ホステッドエージェントは個々の VM で実行され、各実行後に再イメージ化されます。各エージェントは 1 つの組織に専用であり、各 VM では 1 つのエージェントだけがホストされます。
Microsoft ホステッドエージェントでパイプラインを実行すると、セキュリティの観点からいくつかの利点があります。フォークからのコントリビューションなど、パイプラインで信頼されていないコードを実行する場合は、企業ネットワークに存在するセルフホステッドエージェントより、Microsoft ホステッドエージェントでパイプラインを実行する方が安全です。
パイプラインでファイアウォールの内側にある企業リソースにアクセスする必要がある場合は、Azure 地域の IP アドレス範囲を許可する必要があります。 IP アドレスの範囲はかなり大きく、この範囲のマシンは他の顧客にも属している可能性があるため、これにより露出が増加する可能性があります。これを防ぐ最善の方法は、内部リソースにアクセスする必要がないようにすることです。一連のサーバーに成果物をデプロイする方法については、「ターゲットサーバーにデプロイするための通信」を参照してください。
ホステッドイメージは、CIS のセキュリティ強化ベンチマークに準拠していません。 CIS でセキュリティ強化されたイメージを使うには、セルフホステッドエージェントまたはスケールセットエージェントを作成する必要があります。

機能と制限

Microsoft ホステッドエージェントは:

上記のソフトウェアを持っています。ビルドまたはリリースの間に、ツールインストーラータスクを使って、ソフトウェアを追加することもできます。
- パイプライン内の各ジョブ用に、新しくイメージ化されたエージェントが提供されます。
ソースとビルドの出力用に、10 GB のストレージを提供します。
Free レベルを提供します。
- パブリックプロジェクト: 月あたりの全体的な制限時間なしで、毎回最大 360 分 (6 時間) 実行できる、10 個の無料の Microsoft ホステッド並列ジョブ。 Free レベルの制限の引き上げについては、お問い合わせください。
- プライベートプロジェクト: 1 か月あたり 1,800 分 (30 時間) を使い切るまで、1 回あたり最大 60 分実行できる 1 つの無料並列ジョブ。並列ジョブごとに追加容量に対して料金を支払うことができます。有料の並列ジョブの場合、月単位の時間制限がなくなり、各ジョブを最大 360 分 (6 時間) 実行できるようになります。 Microsoft ホステッド並列ジョブを購入する。
- 新しい Azure DevOps 組織を作成するときは、これらの無料の許可は既定では提供されません。パブリックまたはプライベートプロジェクトに対する無料の許可を要求するには、要求をお送りください。
Microsoft Azure 汎用仮想マシン Standard_DS2_v2 で実行します。
Windows では管理者として実行し、Linux ではパスワードレス sudo ユーザーとして実行します。
(Linux のみ) 6 GB の物理メモリと 13 GB の合計メモリを提供する cgroup でステップを実行します。
定期的に (3 週間ごとに) 更新される VM イメージを使用します。

Microsoft ホステッドエージェントでは、次のものは提供されません。

リモート接続する機能。
UNC ファイル共有に成果物をドロップする機能。
マシンを企業ネットワークに直接参加させる機能。
より大きい、またはより強力なビルドマシンを取得する機能。
カスタムソフトウェアを事前に読み込む機能。パイプラインの実行中に、ツールインストーラータスクやスクリプトなどを使って、ソフトウェアをインストールできます。
セルフホステッドエージェントを使用することで得られ、ビルドの開始と実行が速くなる可能性がある、潜在的なパフォーマンス上の利点。詳細情報
XAML ビルドを実行する機能。
以前のバージョンの VM イメージにロールバックする機能。常に最新のバージョンを使用します。

Microsoft がホストするエージェントが、ニーズを満たさない場合は、独自のセルフホストエージェントをデプロイし、スケールセットエージェントまたは Managed DevOps Pools エージェントを使用します。

よく寄せられる質問

イメージに含まれているソフトウェアを確認するにはどうすればよいですか?

「ソフトウェア」の表の「含まれるソフトウェア」のリンクを選ぶと、各ホステッドエージェントにインストールされているソフトウェアを確認できます。

注意

既定では、エージェントソフトウェアにバンドルされている Git のバージョンが Windows エージェントで使われます。 Microsoft は、エージェントにバンドルされている Git のバージョンを使うことをお勧めしますが、この既定の動作をオーバーライドし、エージェントコンピューターのパスにインストールされている Git のバージョンを使うためのオプションがいくつかあります。

パイプラインで System.PreferGitFromPath という名前のパイプライン変数を true に設定します。
セルフホステッドエージェントでは、エージェントのルートディレクトリに .env という名前のファイルを作成し、そのファイルに System.PreferGitFromPath=true という行を追加できます。詳しくは、「エージェントごとに異なる環境変数を設定するにはどうすればよいですか?」をご覧ください。

パイプラインで使われている Git のバージョンは、次の例で示すように、パイプラインのログの checkout ステップで確認できます。

Syncing repository: PathFilter (Git)
Prepending Path environment variable with directory containing 'git.exe'.
git version
git version 2.26.2.windows.1

Microsoft は、イメージに入れるソフトウェアとバージョンをどのように選択しますか?

イメージに含まれるソフトウェアのバージョンについて詳しくは、インストールされるものについてのガイドラインに関するページをご覧ください。

イメージはいつ更新されますか?

通常、イメージは毎週更新されます。ステータスバッジをチェックできます。これは、20200113.x という形式になっており、最初の部分がイメージの更新日を示しています。

必要なソフトウェアが削除されたり、新しいバージョンに置き換えられたりした場合は、どうすればよいですか?

「Microsoft ホステッドエージェントを使用する」の表の「含まれるソフトウェア」のリンクを選び、GitHub の issue を提出してお知らせください。

ユーザーが必要とするソフトウェアの正確なバージョンが含まれるセルフホステッドエージェントを使うこともできます。詳しくは、「セルフホステッドエージェント」をご覧ください。

より多くの処理能力、メモリ、またはディスク領域を備えた、より大きなマシンが必要な場合はどうすればよいですか?

Microsoft ホステッドエージェントのメモリ、処理能力、ディスク領域を増やすことはできませんが、必要な仕様を備えたマシンでホストされたセルフホステッドエージェントまたはスケールセットエージェントを使用できます。

Microsoft ホステッドエージェントを選択できず、ビルドまたはデプロイをキューに入れることができません。どうすればよいですか。

Microsoft ホステッドエージェントは Azure Pipelines でのみ使用でき、TFS または Azure DevOps Server では使用できません。

既定では、組織のすべてのプロジェクト共同作成者が、Microsoft ホステッドエージェントにアクセスできます。ただし、組織の管理者が、Microsoft ホステッドエージェントへのアクセスを、一部のユーザーまたはプロジェクトに制限している可能性があります。 Azure DevOps 組織の所有者に、Microsoft ホステッドエージェントを使うためのアクセス許可の付与を依頼してください。「エージェントプールのセキュリティ」をご覧ください。

Microsoft ホステッドプールエージェント上で実行されるパイプラインが完了するまでは、さらに時間がかかります。それをスピードアップするにはどうすればよいですか?

ご利用のパイプラインの速度が最近低下している場合は、所定の状態ページで停止が発生していないか確認してください。サービスに問題が発生している可能性があります。または、ご利用のアプリケーションコードまたはパイプライン内で行った変更内容を確認してください。チェックアウト中のリポジトリサイズが増加したか、より大きなアーティファクトをアップロードしているか、より多くのテストを実行している可能性があります。

パイプラインを設定したばかりであり、Microsoft ホステッドエージェントのパフォーマンスをご利用のローカルマシンまたはセルフホステッドエージェントと比較する場合は、ご自分のジョブの実行に使用されるハードウェアの仕様に注意してください。より大型または強力なマシンをご提供することはできません。このパフォーマンスが許容できない場合は、セルフホステッドエージェントまたはスケールセットエージェントの使用を検討してください。

もっと多くのエージェントが必要です。どうすればよいですか?

すべての Azure DevOps 組織には、オープンソースプロジェクト用にいくつかの無料並列ジョブと、プライベートプロジェクト用に 1 つの無料並列ジョブと月あたりの制限がある分数が提供されています。オープンソースプロジェクト用に追加の分数または並列ジョブが必要な場合は、サポートにお問い合わせください。プライベートプロジェクト用に追加の分数または並列ジョブが必要な場合は、さらに購入することができます。

パイプラインがセルフホステッドエージェントでは成功しますが、Microsoft ホステッドエージェントでは失敗します。どうすればよいですか。

セルフホステッドエージェントには適切な依存関係がすべてインストールされているのに対し、同じ依存関係、ツール、ソフトウェアが Microsoft ホステッドエージェントにはインストールされていない可能性があります。まず、上の表の「含まれるソフトウェア」のリンクに従って、Microsoft ホステッドエージェントにインストールされているソフトウェアの一覧をよく確認してください。次に、それをセルフホステッドエージェントにインストールされているソフトウェアと比較します。場合によっては、必要なツール (Visual Studio など) が Microsoft ホステッドエージェントにあっても、必要なすべてのオプションコンポーネントがインストールされていない可能性があります。違いが見つかったら、次の 2 つのオプションがあります。

リポジトリで新しい issue を作成できます。ここでは、追加ソフトウェアの要求が追跡されています。 Microsoft ホステッドエージェントでの新しいソフトウェアのセットアップについては、サポートにお問い合わせいただいてもお役に立てません。
セルフホステッドエージェントまたはスケールセットエージェントを使用できます。これらのエージェントでは、パイプラインの実行に使われるイメージを、ユーザーが完全に制御できます。

ビルドがローカルコンピューターでは成功しますが、Microsoft ホステッドエージェントでは失敗します。どうすればよいですか。

ローカルコンピューターには適切な依存関係がすべてインストールされているのに対し、同じ依存関係、ツール、ソフトウェアが Microsoft ホステッドエージェントにはインストールされていない可能性があります。まず、上の表の「含まれるソフトウェア」のリンクに従って、Microsoft ホステッドエージェントにインストールされているソフトウェアの一覧をよく確認してください。次に、それをローカルコンピューターにインストールされているソフトウェアと比較します。場合によっては、必要なツール (Visual Studio など) が Microsoft ホステッドエージェントにあっても、必要なすべてのオプションコンポーネントがインストールされていない可能性があります。違いが見つかったら、次の 2 つのオプションがあります。

リポジトリで新しい issue を作成できます。ここでは、追加ソフトウェアの要求が追跡されています。これは、新しいソフトウェアをインストールするための最善の策です。 Microsoft ホステッドエージェントでの新しいソフトウェアのセットアップについては、サポートに問い合わせても役に立ちません。
セルフホステッドエージェントまたはスケールセットエージェントを使用できます。これらのエージェントでは、パイプラインの実行に使われるイメージを、ユーザーが完全に制御できます。

"デバイスに空き領域がありません" というエラーでパイプラインが失敗します。

Microsoft によってホストされるエージェントには、ジョブの実行に使用できるディスク領域が 10 GB しかありません。この領域は、ソースコードをチェックするとき、パッケージをダウンロードするとき、Docker イメージをダウンロードするとき、または中間ファイルを生成するときに使われます。残念ですが、Microsoft ホステッドイメージで使用できる空き領域を増やすことはできません。パイプラインを再構築して、この領域に収まるようにすることができます。または、セルフホステッドエージェントまたはスケールセットエージェントの使用を検討できます。

Microsoft ホステッドエージェントで実行されているパイプラインは、会社のネットワーク上のサーバーにアクセスする必要があります。ファイアウォールで許可する IP アドレスの一覧を取得するにはどうすればよいですか?

エージェントの IP 範囲に関するセクションをご覧ください

Microsoft ホステッドエージェントで実行されているパイプラインが、会社のネットワーク上のサーバーの名前を解決できません。解決するにはどうすればよいですか?

サーバーを DNS 名で参照している場合は、その DNS 名を使ってサーバーにインターネット上でパブリックにアクセスできることを確認します。サーバーを IP アドレスで参照している場合は、その IP アドレスにインターネット上でパブリックにアクセスできることを確認します。どちらの場合も、エージェントと企業ネットワークの間にあるファイアウォールで、エージェントの IP 範囲が許可されていることを確認します。

Azure ストレージアカウントから SAS IP 承認エラーが発生します

SAS エラーコードが表示される場合は、通常、Azure Storage の規則により、Microsoft ホステッドエージェントからの IP アドレス範囲が許可されていないためです。いくつかの回避策があります。

Azure ストレージアカウントの IP ネットワーク規則を管理し、ホステッドエージェントの IP アドレス範囲を追加します。
パイプラインのストレージにアクセスする直前で、Azure CLI を使用して Azure ストレージアカウントのネットワークルールセットを更新し、その後で前のルールセットに戻します。
セルフホステッドエージェントまたはスケールセットエージェントを使います。

ホステッド macOS エージェント上でツールのバージョンを手動で選ぶにはどうすればよいですか?

Xcode

Azure Pipelines と TFS に含まれる Xcode タスクを使う場合は、そのタスクのプロパティで Xcode のバージョンを選択できます。そうでない場合に、ホステッド macOS エージェントプールで使う Xcode のバージョンを手動で設定するには、xcodebuild ビルドタスクの前で、ビルドの一部として次のコマンドラインを実行します。必要に応じて、Xcode のバージョン番号 13.2 を置き換えます。

/bin/bash -c "sudo xcode-select -s /Applications/Xcode_13.2.app/Contents/Developer"

ホステッド macOS エージェントプールでの Xcode のバージョンについては、こちらで macos-12 エージェントを探してください。

このコマンドは、Xamarin アプリでは機能しません。 Xamarin アプリをビルドするための Xcode のバージョンを手動で選ぶには、上記の手順を参照してください。

Mono

Hosted macOS エージェントプールで使用する Mono バージョンを手動で選択するには、Mono ビルドタスクの前にビルドの各ジョブでこのスクリプトを実行し、必要な Mono バージョンでシンボリックリンクを指定します。

SYMLINK=<symlink>
MONOPREFIX=/Library/Frameworks/Mono.framework/Versions/$SYMLINK
echo "##vso[task.setvariable variable=DYLD_FALLBACK_LIBRARY_PATH;]$MONOPREFIX/lib:/lib:/usr/lib:$DYLD_LIBRARY_FALLBACK_PATH"
echo "##vso[task.setvariable variable=PKG_CONFIG_PATH;]$MONOPREFIX/lib/pkgconfig:$MONOPREFIX/share/pkgconfig:$PKG_CONFIG_PATH"
echo "##vso[task.setvariable variable=PATH;]$MONOPREFIX/bin:$PATH"

次の方法で共有

Microsoft によってホストされるエージェント

ソフトウェア

最新の更新

非推奨のホステッドイメージを使用しているパイプラインを確認する方法

Microsoft ホステッドエージェントを使用する

ハードコーディングされた参照を使わない

ハードウェア

ネットワーク

Microsoft ホステッドエージェントで使用可能な IP 範囲を特定するには

例

サービスタグ

セキュリティ

機能と制限

よく寄せられる質問

イメージに含まれているソフトウェアを確認するにはどうすればよいですか?

Microsoft は、イメージに入れるソフトウェアとバージョンをどのように選択しますか?

イメージはいつ更新されますか?

必要なソフトウェアが削除されたり、新しいバージョンに置き換えられたりした場合は、どうすればよいですか?

より多くの処理能力、メモリ、またはディスク領域を備えた、より大きなマシンが必要な場合はどうすればよいですか?

Microsoft ホステッドエージェントを選択できず、ビルドまたはデプロイをキューに入れることができません。どうすればよいですか。

Microsoft ホステッドプールエージェント上で実行されるパイプラインが完了するまでは、さらに時間がかかります。それをスピードアップするにはどうすればよいですか?

もっと多くのエージェントが必要です。どうすればよいですか?

パイプラインがセルフホステッドエージェントでは成功しますが、Microsoft ホステッドエージェントでは失敗します。どうすればよいですか。

ビルドがローカルコンピューターでは成功しますが、Microsoft ホステッドエージェントでは失敗します。どうすればよいですか。

"デバイスに空き領域がありません" というエラーでパイプラインが失敗します。

Microsoft ホステッドエージェントで実行されているパイプラインは、会社のネットワーク上のサーバーにアクセスする必要があります。ファイアウォールで許可する IP アドレスの一覧を取得するにはどうすればよいですか?

Microsoft ホステッドエージェントで実行されているパイプラインが、会社のネットワーク上のサーバーの名前を解決できません。解決するにはどうすればよいですか?

Azure ストレージアカウントから SAS IP 承認エラーが発生します

ホステッド macOS エージェント上でツールのバージョンを手動で選ぶにはどうすればよいですか?

Xcode

Mono

フィードバック

その他のリソース

次の方法で共有

Microsoft によってホストされるエージェント

ソフトウェア

最新の更新

非推奨のホステッド イメージを使用しているパイプラインを確認する方法

Microsoft ホステッド エージェントを使用する

ハードコーディングされた参照を使わない

ハードウェア

ネットワーク

Microsoft ホステッド エージェントで使用可能な IP 範囲を特定するには

例

サービス タグ

セキュリティ

機能と制限

よく寄せられる質問

イメージに含まれているソフトウェアを確認するにはどうすればよいですか?

Microsoft は、イメージに入れるソフトウェアとバージョンをどのように選択しますか?

イメージはいつ更新されますか?

必要なソフトウェアが削除されたり、新しいバージョンに置き換えられたりした場合は、どうすればよいですか?

より多くの処理能力、メモリ、またはディスク領域を備えた、より大きなマシンが必要な場合はどうすればよいですか?

Microsoft ホステッド エージェントを選択できず、ビルドまたはデプロイをキューに入れることができません。 どうすればよいですか。

Microsoft ホステッド プール エージェント上で実行されるパイプラインが完了するまでは、さらに時間がかかります。 それをスピードアップするにはどうすればよいですか?

もっと多くのエージェントが必要です。 どうすればよいですか?

パイプラインがセルフホステッド エージェントでは成功しますが、Microsoft ホステッド エージェントでは失敗します。 どうすればよいですか。

ビルドがローカル コンピューターでは成功しますが、Microsoft ホステッド エージェントでは失敗します。 どうすればよいですか。

"デバイスに空き領域がありません" というエラーでパイプラインが失敗します。

Microsoft ホステッド エージェントで実行されているパイプラインは、会社のネットワーク上のサーバーにアクセスする必要があります。 ファイアウォールで許可する IP アドレスの一覧を取得するにはどうすればよいですか?

Microsoft ホステッド エージェントで実行されているパイプラインが、会社のネットワーク上のサーバーの名前を解決できません。 解決するにはどうすればよいですか?

Azure ストレージ アカウントから SAS IP 承認エラーが発生します

ホステッド macOS エージェント上でツールのバージョンを手動で選ぶにはどうすればよいですか?

Xcode

Mono

フィードバック

その他のリソース

非推奨のホステッドイメージを使用しているパイプラインを確認する方法

Microsoft ホステッドエージェントを使用する

Microsoft ホステッドエージェントで使用可能な IP 範囲を特定するには

サービスタグ

Microsoft ホステッドエージェントを選択できず、ビルドまたはデプロイをキューに入れることができません。どうすればよいですか。

Microsoft ホステッドプールエージェント上で実行されるパイプラインが完了するまでは、さらに時間がかかります。それをスピードアップするにはどうすればよいですか?

もっと多くのエージェントが必要です。どうすればよいですか?

パイプラインがセルフホステッドエージェントでは成功しますが、Microsoft ホステッドエージェントでは失敗します。どうすればよいですか。

ビルドがローカルコンピューターでは成功しますが、Microsoft ホステッドエージェントでは失敗します。どうすればよいですか。

Microsoft ホステッドエージェントで実行されているパイプラインは、会社のネットワーク上のサーバーにアクセスする必要があります。ファイアウォールで許可する IP アドレスの一覧を取得するにはどうすればよいですか?

Microsoft ホステッドエージェントで実行されているパイプラインが、会社のネットワーク上のサーバーの名前を解決できません。解決するにはどうすればよいですか?

Azure ストレージアカウントから SAS IP 承認エラーが発生します