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 ホストされるエージェント プールには、次のハードウェア仕様と仮想マシン イメージが用意されています。
GitHubホストされるエージェントは、次の macOS バージョンのイメージを提供します。
| macOS バージョン | 含まれるソフトウェア |
|---|---|
| macOS 26 ARM 64 | Link |
この 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 26 ARM64 | macos-26-arm64 |
| macOS 26 | エクストララージ | macOS 26 ARM64 XL | macos-26-arm64-xl |
Important
パブリック プレビュー期間中、組織は 8 Standard および 8 XLarge GitHub ホストエージェントに制限されます。 ハードウェア仕様ごとに 8 つ以上のパイプライン ジョブ キューがある場合は、最初の 8 つのジョブが実行され、最初のジョブが完了するまで残りのキューが実行されます。 パブリック プレビュー期間中にハードウェア仕様ごとに 8 つ以上のエージェントが必要な場合は、サポート ケースを作成します。
使用状況の監視
パイプラインの使用状況を監視するには、プールの [分析] タブを使用するか、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 |
| 企業ネットワーク | 直接アクセスできない | 直接アクセスできない | 直接アクセス |