Azure DevOps サービス
GitHubホスト型エージェントは、従量課金制 (PAYG) の課金でAzure Pipelinesのパフォーマンスが高い仮想マシンを提供します。 コンカレンシー ベースのプールを使用するMicrosoftホストされるエージェントとは異なり、GitHubホストされるエージェントは使用量の分単位で課金され、より強力なマシン構成を提供します。 料金は、使用されるエージェントのオペレーティング システムとディメンションによって異なります。
Important
この機能はデプロイ中であり、一部のリージョンではまだ使用できない場合があります。 リージョンにデプロイされているかどうかを確認するには、Azure DevOps課金ページでGitHubホストされるエージェント設定を確認します。
この機能は現在プレビュー段階です。 一般公開前に変更される場合があります。
前提条件
GitHubホストされるエージェントを有効にするには、次の前提条件が必要です。
| Category | 必要条件 |
|---|---|
| Permissions | Azure DevOps組織で課金設定を構成するためのアクセス許可が必要です。 必要なアクセス許可の完全な一覧については、「 課金の管理: 前提条件」を参照してください。 |
| Subscription | Azure DevOps 組織と同じ Microsoft Entra ID に含まれる Azure サブスクリプション。 |
GitHubホスト型エージェントの課金を有効にする
GitHubホスト型エージェントでは、従量課金制の課金が使用されます。 マシンのサイズに基づいて、パイプラインの実行時間が分単位で課金されます。 価格情報については、「Azure DevOps pricing」を参照してください。
Note
GitHub ホステッド エージェントには、無料利用枠や無料分はありません。 すべての使用量は 1 分あたりに課金されます。 この従量課金モデルは、Microsoft ホステッド エージェントで使用される並列ジョブの同時実行数課金とは別です。
Azure DevOps組織で課金がまだ有効になっていない場合は、「組織の課金を設定するの手順に従って有効にします。
課金設定で従量課金制を有効にします。 Enable GitHub-hosted agents を On に設定し、ページの下部にある Save を選択します。
GitHub ホステッド エージェントを使用する
従量課金制を有効にすると、Azure DevOpsは、組織内に新しい GitHub ホスト型エージェント プールを作成します。 このプールには、分単位で課金される追加のイメージ ラベルが用意されています。
YAML パイプラインでGitHubホストされるエージェントを使用するには、次のプロパティを使用して pool セクションを構成します。
-
name:'GitHub-hosted Agents' -
vmImage: 使用する VM イメージ ラベル。 使用可能なイメージ ラベルについては、GitHub ホストされるエージェント イメージを参照してください。
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64'
steps:
- bash: |
echo Hello from macOS Tahoe arm64
uname -a
sw_vers
その他の例:
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64-xl'
steps:
- bash: |
echo Hello from XL macOS Tahoe arm64
uname -a
hostinfo | grep memory
GitHubホストされるエージェント イメージ
GitHubホステッド エージェントは、標準のMicrosoft ホスト型エージェント configurations と比較して、より高いパフォーマンス構成を提供します。 GitHub ホストされるエージェント プールには、次のハードウェア仕様と仮想マシン イメージが用意されています。
Important
パブリック プレビュー期間中、組織は 8 Standard および 8 XLarge GitHub ホストエージェントに制限されます。 ハードウェア仕様ごとに 8 つ以上のパイプライン ジョブ キューがある場合は、最初の 8 つのジョブが実行され、最初のジョブが完了するまで残りのキューが実行されます。 パブリック プレビュー期間中にハードウェア仕様ごとに 8 つ以上のエージェントが必要な場合は、サポート ケースを作成します。
GitHubホストされるエージェントは、次の macOS バージョンのイメージを提供します。
| macOS バージョン | 含まれるソフトウェア |
|---|---|
| macOS 26 ARM 64 | Link |
| xCode 27 を使用した macOS (パブリック プレビュー) | Link |
Note
Xcode 27 イメージは、今後数週間かけてGitHub ホスト型エージェントプールに展開されます。 組織に画像が表示されない場合は、後で確認してください。
この macOS イメージでは、次のハードウェア仕様を使用してパイプラインを実行できます。
| ハードウェアの仕様 | vCPU | RAM | ストレージ (SSD) | Architecture |
|---|---|---|---|---|
| Standard | 3 | 7 GB | 14 GB | arm64 (M1) |
| エクストララージ | 5 (+ 8 GPU ハードウェア アクセラレータ) | 14 GB | 14 GB | arm64 (M2) |
GitHubホスト型エージェントを使用してパイプラインを実行するには、次の一覧から目的のオペレーティング システムとハードウェアの仕様に一致するイメージ ラベルを指定します。
| オペレーティング システム (OS) | ハードウェアの仕様 | Image | YAML VM イメージ ラベル |
|---|---|---|---|
| macOS 26 | Standard | macOS ARM64 | macos-26-arm64 |
| macOS 26 | エクストララージ | macOS ARM64 XL | macos-26-arm64-xl |
| Xcode 27 を使用した macOS | Standard | macOS ARM64 | xcode-27 |
| Xcode 27 を使用した macOS | エクストララージ | macOS ARM64 XL | xcode-27-xlarge |
macOS イメージの Xcode ベースの名前付け規則
Xcode 27 (パブリック プレビュー) イメージを使用した macOS のリリースでは、Microsoft macOS イメージの新しい名前付け規則が導入されました。 新しい各イメージ名は、基になるオペレーティング システムではなく、主要な Xcode バージョンに基づいています。 各イメージ バージョンでは、1 つの主要な Xcode バージョンがサポートされています。
この名前付けモデルを使用すると、開発者は目的の Apple ツールチェーンをターゲットにできます。 これは、macOS CI ジョブの一般的な定義方法を反映しています。これは、基になるオペレーティング システムではなく、必要な Xcode ツールチェーンによって行われます。 オペレーティング システムは、イメージの有効期間中に変更される可能性があります。 Xcode 27 イメージに含まれるソフトウェア (macOS オペレーティング システムのバージョンを含む) を確認するには、前の表のイメージに含まれているソフトウェア リンクに従います。
使用状況の監視
パイプラインの使用状況を監視するには、プールの [分析] タブを使用するか、Azure Cost Managementを使用します。
分析ビュー
GitHub ホストされるエージェント プールで、Analytics タブを選択します。表示するエージェント SKU と使用期間を選択します。 この選択により、グラフがレンダリングされ、選択したエージェント SKU を使用する上位のプロジェクトが一覧表示されます。 プロジェクトとパイプライン レベルにドリルダウンして、エージェント SKU を使用するジョブを表示できます。
Azure Cost Management
従量課金制パイプラインの使用状況をフィルター処理するには、次を選択します。
- 測定カテゴリ: Azure DevOps
- メーターのサブカテゴリ: Azure Pipelines
- 測定単位: 1/分
さらに、次のフィルター処理を行うことができます。
- タグ:
_organizationname_ - タグ:
_projectname_
次のスクリーンショットは、Azure Cost Managementの一般的なコスト分析ビューを示しています。
ネットワーク
GitHubホステッド エージェントには、Microsoft ホストされるエージェントと同様のnetworking 機能があります。
GitHub がホストするエージェントは、GitHub Actions 大規模ランナーと同じインフラストラクチャ上で実行されます。 GitHubホストされているエージェントとサーバー間のネットワーク トラフィックは、パブリック ネットワークを経由します。
Important
ExpressRouteなどのプライベート接続を使用して、GitHubホストされているエージェントを企業ネットワークに接続することはできません。
セキュリティ
GitHubホストされるエージェントには、Microsoft ホストされるエージェントと同じセキュリティ機能があります。
GitHubホストされるエージェントは、各ジョブの後に再イメージ化される分離された仮想マシンで実行されます。 各エージェントは 1 つの組織に専用であり、各 VM では 1 つのエージェントだけがホストされます。
- エージェントにはパブリック IP アドレスがないため、外部エンティティはそれらを直接ターゲットにすることはできません。
- 各ジョブは新しくプロビジョニングされた VM で実行されるため、ジョブ間でデータが保持されません。
- ホストされたイメージは、 CIS セキュリティ強化ベンチマークに準拠していません。 CIS で強化されたイメージを使用するには、 セルフホステッド エージェント または マネージド DevOps プールを検討してください。
機能と制限
GitHubホストされるエージェントは、ジョブごとの新しい仮想マシンや最新のソフトウェアでイメージを自動的に更新するなど、Microsoftホストされるエージェントと同様の>能力と制限があります次の主な違いがあります。
GitHubホストされるエージェント:
- 標準的なMicrosoftホスト型エージェントよりも多くの vCPU、RAM、ディスク領域を備えた、より大きなマシン サイズを提供します。
- Free レベルなしで 1 分あたりの使用量を請求します。
エージェント プールのオプションを比較する
| 特徴 | Microsoftによってホストされたエージェント | GitHub ホスト型エージェント (PAYG) | セルフホステッド エージェント (自己ホスト型エージェント) |
|---|---|---|---|
| 請求書 | 並列ジョブ(同時実行ベース) | 分単位(従量課金) | 独自のインフラストラクチャ |
| 無料利用枠 | あり (制限付き) | いいえ | N/A |
| マシンのサイズ | Standard (2 vCPU、7 GB RAM) | さまざまな (Microsoft ホステッドより大規模) | Custom |
| メンテナンス | 自動 | 自動 | 手動 |
| カスタム ソフトウェア | パイプラインの実行中にインストールする | パイプラインの実行中にインストールする | Preinstalled |
| 企業ネットワーク | 直接アクセスできない | 直接アクセスできない | 直接アクセス |