閉域の Microsoft Foundry に GitHub Actions でエージェントまでデプロイする|Private Endpoint と Container Apps の Self-hosted runner で GitHub は Free のまま

AI

この記事でわかること

  • 閉域の Foundry に GitHub Actions からデプロイするとき、外から届く操作(管理プレーン)と届かない操作(データ プレーン)の違い
  • ランナーの 4 つの選択肢(標準、Larger runner の VNet 注入、Container Apps ジョブ、VM・AKS)の構成図と権限の分け方
  • GitHub は Free のまま、VNet 内の Runner でプロンプト エージェントまで反映した手順と、実機でつまずいた点

はじめに

Microsoft Foundry を公開アクセスなし(Private Endpoint だけ)にしたまま、GitHub Actions からエージェントの定義までデプロイする。
インフラは Bicep、エージェントは YAML でリポジトリに置き、main に push するだけで Foundry に反映されるところまで実機で組んだ。
ランナーには選択肢がいくつかあるので、それぞれの構成と権限の分け方を整理してから、GitHub の Free プランで組める Container Apps ジョブの構成を作る。

Foundry の閉域化そのもの:Microsoft Foundry の閉域化とは(AI 編 A2)

Microsoft Foundry の閉域化とは|プライベート エンドポイントと DNS、パブリック アクセスの無効化を実機で検証
Microsoft Foundry をプライベート エンドポイントで閉域にする方法。3 つの DNS ゾーンと名前解決、パブリック アクセスの無効化、閉域にしたあとの Foundry ポータルの見え方を実機で検証。

GitHub Actions のランナーと OIDC の基本:GitHub Actions(DevOps 編 8)

GitHub Actions とは|再利用可能ワークフロー・環境の承認・OpenID Connect で Azure にサインインを実機で検証(DevOps 編 8)
GitHub Actions のワークフロー構造、トリガー、キャッシュ、再利用可能ワークフロー、環境の保護ルールを整理。承認で進む本番デプロイと、OpenID Connect によるシークレットなしの Azure サインインを実機で確認。

閉域で GitHub Actions を使うときの考え方

Foundry の公開ネットワーク アクセスを無効にしても、ARM(Azure Resource Manager、管理プレーン)は公開のまま。
そのため、Bicep で Foundry やプロジェクト、モデルのデプロイを作る操作は、インターネット上の GitHub-hosted runner からでも届く。
一方、エージェントの作成や呼び出しはプロジェクトのエンドポイント(データ プレーン)への操作なので、VNet の中からしか届かない。

閉域の Foundry に届く操作と届かない操作
操作宛先VNet の外(GitHub-hosted runner)から
Foundry、プロジェクト、VNet などを Bicep で作るARM(management.azure.com)届く
モデルのデプロイを作るARM(Foundry の deployments リソース)届く
エージェントを作成・更新するプロジェクトのエンドポイント(services.ai.azure.com)届かない(403)
エージェントに質問するプロジェクトのエンドポイント届かない(403)

Private Endpoint を作ると、Foundry の名前は privatelink のサブドメインの別名になる。
VNet の外から名前を引くと公開エンドポイントに、Private Endpoint のある VNet から引くと Private Endpoint のプライベート IP に解決される。
Foundry(Microsoft.CognitiveServices/accounts)で使う Private DNS ゾーンは、privatelink.cognitiveservices.azure.com、privatelink.openai.azure.com、privatelink.services.ai.azure.com の 3 つ。

公式ドキュメント:
Microsoft Foundry のネットワーク分離を構成する方法 | Microsoft Learn
Azure プライベート エンドポイントのプライベート DNS ゾーン値 | Microsoft Learn

ランナーの選択肢

エージェントを反映するジョブを、どこで動かすかで構成が変わる。
大きく分けて次の 4 つ。

選択肢閉域の Foundry に届くかGitHub のプランRunner の管理費用の考え方
1 標準の GitHub-hosted runner届かないFree から不要プランの無料枠(Free は月 2,000 分)
2 Larger runner + VNet 注入届くTeam / Enterprise Cloud(Enterprise Cloud の試用版では使えない)不要分単位の課金。パブリック リポジトリでも課金
3 Self-hosted runner(Container Apps ジョブ)届くFree からRunner のイメージの更新ジョブが動いている時間だけ
4 Self-hosted runner(VM / VMSS、AKS と ARC)届くFree からOS やクラスターの運用VM やクラスターの費用

公式ドキュメント:
より大きなランナー | GitHub Docs
GitHubホストランナーのための企業内Azureプライベートネットワークについて | GitHub Docs
GitHub Enterprise Cloud の試用版の設定 | GitHub Docs
セルフホステッド ランナー リファレンス | GitHub Docs
チュートリアル: Azure Container Apps ジョブを使用してセルフホステッド CI/CD ランナーとエージェントをデプロイする | Microsoft Learn

選択肢 1:標準の GitHub-hosted runner

選択肢 1 の構成

いちばん手軽だが、Runner はインターネット上にあるので、エージェントの作成には Foundry の公開アクセスが要る。
選択したネットワーク(IP)だけを許可する設定もあるが、固定 IP を割り当てられるのは Larger runner で、標準ランナーには割り当てられない。
つまり、Foundry を閉域にしたままエージェントまで反映することはできない。

権限は、インフラ用とエージェント用で ID を分け、フェデレーション資格情報の subject(ブランチや環境)で、どのワークフローがどの ID を使えるかを絞る。

選択肢 2:Larger runner + Azure プライベート ネットワーク(VNet 注入)

選択肢 2 の構成

GitHub が管理する Runner の NIC を、自分の VNet のサブネットに置く仕組み。
VNet のネットワーク ポリシーが Runner にもかかるので、Private Endpoint 経由で閉域の Foundry に届く。
Azure 側には GitHub.Network/networkSettings のリソースを作り、GitHub Actions のサービスがこのリソースへの権限を使って NIC を配置する。

使えるのは Larger runner(2〜64 vCPU の Ubuntu と Windows)だけで、標準の GitHub-hosted runner は対象外。
また、GitHub Enterprise Cloud の試用版には Larger runner が含まれないので、試用版でこの構成を試すことはできない。
Larger runner はパブリック リポジトリでも分単位で課金される。

GitHub の Enterprise プランの画面

GitHub の料金ページの Enterprise プラン。
試用版(Start a free trial)はあるが、上のとおり Larger runner は試用版の対象外。

GitHub は Runner に受信接続をする必要がないので、Runner への受信接続はすべて NSG で拒否するのが推奨。
この構成では Larger runner の静的 IP は使えない。
権限は選択肢 1 と同じく OIDC で、ID ごとに subject を分ける。

公式ドキュメント:
GitHubホストランナーのための企業内Azureプライベートネットワークについて | GitHub Docs
より大きなランナー | GitHub Docs
GitHub Enterprise Cloud の試用版の設定 | GitHub Docs

選択肢 3:Self-hosted runner を Container Apps ジョブで動かす(今回の構成)

選択肢 3 の構成

Container Apps のイベント ドリブン ジョブとして Runner を動かす。
KEDA の github-runner スケーラーが GitHub のキューを見て、待っているジョブがあるときだけ Runner のコンテナーを起動し、ジョブが終わると終了する。
支払いはジョブが動いている時間だけで、VNet の中のリソースにも届く。

注意点は 3 つ。
Container Apps のコンテナーでは Docker を実行できないので、Docker を使うステップは失敗する。
Runner の登録に使う PAT をジョブのシークレットに置くので、ジョブを起動できる権限は信頼できる ID だけに付ける。
Self-hosted runner はプライベート リポジトリでだけ使う(パブリック リポジトリでは、他人のコードが Runner で動くおそれがある)。

公式ドキュメント:
チュートリアル: Azure Container Apps ジョブを使用してセルフホステッド CI/CD ランナーとエージェントをデプロイする | Microsoft Learn
Azure Container Apps のジョブ | Microsoft Learn
Virtual Network の構成 | Microsoft Learn

選択肢 4:Self-hosted runner を VM / VMSS や AKS(ARC)で動かす

選択肢 4 の構成

VM に Runner アプリを入れる形と、AKS に Actions Runner Controller(ARC)を入れる形がある。
VM では config.sh に –ephemeral を付けて登録すると、1 つのジョブを処理したあと登録が自動で外れる。
ARC は Self-hosted runner を Kubernetes の上で調整・スケーリングするオペレーターで、実行中のワークフローの数に合わせて増減するランナー スケール セットを作れる。

Runner は GitHub に外向きの HTTPS(443)でつないでジョブを受け取る。
どの選択肢でも、github.com、api.github.com、*.actions.githubusercontent.com などへの外向きの通信は必要になる。

公式ドキュメント:
セルフホステッド ランナー リファレンス | GitHub Docs
アクション ランナー コントローラー | GitHub Docs

選択肢ごとの権限の分け方

選択肢インフラ用の IDエージェント用の ID分け方のポイント
1 標準OIDC(共同作成者)OIDC(Foundry ユーザー)subject(ブランチや環境)で使えるワークフローを分ける。
Foundry が公開なので、ネットワークでは守れない
2 Larger runnerOIDC(共同作成者)OIDC(Foundry ユーザー)subject を環境で分け、環境に承認のルールを付ける。
Runner への受信は NSG で拒否する
3 Container Apps ジョブOIDC(共同作成者)、GitHub-hosted で使うRunner ジョブの Managed Identity(Foundry ユーザー)Foundry を操作できる資格情報を GitHub に置かない。
Runner はリポジトリ専用にし、ラベルで受け取るジョブを絞る
4 VM / AKSOIDC(共同作成者)VM などに付けた Managed Identity(Foundry ユーザー)選択肢 3 と同じ。
VM を使い回すと前のジョブのファイルが残るので –ephemeral で 1 ジョブごとにする

Azure への認証

GitHub-hosted runner から Azure にサインインするには、OIDC(ワークロード ID フェデレーション)を使う。
ユーザー割り当て Managed Identity に「GitHub が発行したトークンを信頼する」フェデレーション資格情報(発行者、subject、対象ユーザー)を登録し、ワークフローは azure/login にクライアント ID などを渡す。
シークレットは要らない。

permissions:
  id-token: write # OIDC のトークンを発行するために必要
  contents: read

steps:
  - uses: azure/login@v2
    with:
      client-id: ${{ vars.AZURE_CLIENT_ID }}
      tenant-id: ${{ vars.AZURE_TENANT_ID }}
      subscription-id: ${{ vars.AZURE_SUBSCRIPTION_ID }}

subject は GitHub のワークフローの構成と完全に一致している必要がある。
誤った subject でもフェデレーション資格情報は問題なく作れてしまい、間違いはトークンの交換が失敗するまで分からない(今回、実際にこれでつまずいた)。

VNet 内の Runner は、Container Apps ジョブに付けた Managed Identity で Foundry に入る。
ジョブの環境変数 AZURE_CLIENT_ID に ID のクライアント ID を入れておくと、Python の DefaultAzureCredential がこの ID を使う。
エージェントの作成に付けたロールは Foundry ユーザー(旧名 Azure AI User)で、プロジェクトとリソースの閲覧と、プロジェクトのデータ アクション(ビルドと開発)を含む。

今回の権限の分け方

公式ドキュメント:
ワークロード ID フェデレーションの概念 | Microsoft Learn
外部 ID プロバイダーを信頼するようにユーザー割り当てマネージド ID を構成する | Microsoft Learn
Use the Azure Login action with OpenID Connect | Microsoft Learn
Microsoft Foundry のロールベースのアクセス制御 | Microsoft Learn

プロンプト エージェントとホストされたエージェント

Foundry のエージェントには、宣言的に定義して Foundry で動かすプロンプト エージェントと、自分のコードをパッケージにしてホストするホストされたエージェントがある。
CI/CD で届けるものが違う。

種類中身CI/CD で届けるもの
プロンプト エージェントモデル、指示、ツールを定義し、Foundry で実行する定義だけ(今回は YAML を SDK の create_version で反映)
ホストされたエージェント自分のコードをエージェントとしてパッケージ化するコードとコンテナー(ビルドとレジストリへの push が加わる)

今回はプロンプト エージェント。
SDK は azure-ai-projects 2.x で、project.agents.create_version に PromptAgentDefinition を渡すと、エージェントの新しいバージョンが作られる。

公式ドキュメント:
Microsoft Foundry のエージェント | Microsoft Learn
クイック スタート: Microsoft Foundry SDK の概要 | Microsoft Learn

構築手順

今回の構成と実施すること

今回の構成
手順実施すること確かめること
①GitHub にプライベート リポジトリを作る
②Runner 用の PAT を作る対象リポジトリと 3 つの権限だけにする
③Cloud Shell で準備スクリプトを実行するOIDC 用の ID、フェデレーション資格情報、権限ができる
④GitHub に Variables と Secret を登録する
⑤コードを push するinfra が OIDC で構築し、agents が VNet 内の Runner でエージェントを反映する
⑥VNet の外から Foundry を呼ぶ正しいトークンでも 403 で止まる
⑦自分の IP だけ一時的に許可して、ポータルで見るエージェントと指示が YAML のとおり入っている

費用の目安(東日本)は、Private Endpoint が 1 時間 $0.01、ACR Basic が 1 日 $0.1666、Private DNS ゾーンが 1 ゾーン 1 か月 $0.50(3 つ)。
Runner の Container Apps ジョブは動いた秒数だけ(vCPU 1 秒 $0.000024、メモリ 1 GiB 1 秒 $0.000003)で、モデルは使ったトークン分。
1 か月置いたままでも $14 前後になる。

使ったコード

コードは一式を GitHub に置いた:azure-bicep-samples / foundry-private-cicd。
このフォルダーの中身を新しいリポジトリのルートに置けば、そのまま同じ構成を作れる。

ファイル役割
infra/base.bicepRunner のイメージを置く ACR(Basic)
infra/main.bicepVNet、Private DNS、Foundry(公開アクセス無効、API キー無効)、プロジェクト、モデル、Private Endpoint、Runner の ID とロール、Container Apps 環境と Runner ジョブ
runner/DockerfileGitHub 公式の Runner イメージに Python を足したもの
runner/entrypoint.shRunner の登録、PAT の消去、1 ジョブで終わる起動
agents/helpdesk-agent.yamlエージェントの定義(1 ファイル 1 エージェント)
scripts/deploy_agents.py定義の検証と、create_version での反映
scripts/smoke_test.py反映したエージェントに質問して応答を確かめる
scripts/bootstrap.sh最初に 1 回だけ実行する準備(OIDC 用の ID、権限)
.github/workflows/infra.ymlインフラ層のワークフロー(GitHub-hosted runner)
.github/workflows/agents.ymlエージェント層のワークフロー(VNet 内の Runner)

Bicep の要は Runner ジョブの部分。
イベント ドリブンで、待機中は 0 台、ラベル foundry-private を要求するジョブだけを数える。
Foundry、モデル、権限、DNS ができてから Runner を作るように dependsOn を付けている(先に Runner ができると、待っていたジョブが準備前に動いて失敗するため)。

configuration: {
  triggerType: 'Event'
  replicaTimeout: 1800
  eventTriggerConfig: {
    scale: {
      minExecutions: 0
      maxExecutions: 5
      pollingInterval: 30
      rules: [
        {
          name: 'github-runner'
          type: 'github-runner'
          metadata: {
            githubAPIURL: 'https://api.github.com'
            owner: githubOwner
            runnerScope: 'repo'
            repos: githubRepo
            labels: runnerLabel
            targetWorkflowQueueLength: '1'
          }
          auth: [ { secretRef: 'github-pat', triggerParameter: 'personalAccessToken' } ]
        }
      ]
    }
  }
}

Runner の起動スクリプト。
Microsoft のチュートリアルのサンプルをもとに、PAT を環境変数から消してから Runner を起動するようにした(消さないと、ワークフローのステップから PAT が読める)。

#!/bin/bash
set -euo pipefail

REGISTRATION_TOKEN="$(curl -fsSL -X POST \
  -H 'Accept: application/vnd.github+json' \
  -H "Authorization: Bearer ${GITHUB_PAT}" \
  -H 'X-GitHub-Api-Version: 2022-11-28' \
  "${REGISTRATION_TOKEN_API_URL}" | jq -r '.token')"

unset GITHUB_PAT

./config.sh \
  --url "${GH_URL}" \
  --token "${REGISTRATION_TOKEN}" \
  --labels "${RUNNER_LABELS:-foundry-private}" \
  --unattended \
  --ephemeral

unset REGISTRATION_TOKEN
exec ./run.sh

エージェントの定義と、反映するスクリプトの中心部分。

name: helpdesk-agent
model: gpt-5-mini
instructions: |
  あなたは社内ヘルプデスクの一次回答を担当するアシスタントです。
  - 日本語で、簡潔に回答してください。
  - 分からないことは推測せず、「担当部署に確認してください」と案内してください。
  - パスワードや個人情報を聞き出してはいけません。
smoke_test:
  input: "パスワードを忘れたときはどうすればいいですか?"
  expect_any: []
project = AIProjectClient(endpoint=endpoint, credential=DefaultAzureCredential())

for d in defs:
    agent = project.agents.create_version(
        agent_name=d.name,
        definition=PromptAgentDefinition(
            model=d.model,
            instructions=d.instructions,
        ),
    )

agents ワークフローは、プル リクエストでは定義の検証(GitHub-hosted runner)だけを行い、main に入ったものだけを VNet 内の Runner で反映する。

deploy:
  needs: validate
  if: github.event_name != 'pull_request'
  runs-on: [self-hosted, linux, foundry-private]
  steps:
    - uses: actions/checkout@v4
    - run: |
        python3 -m venv .venv
        .venv/bin/pip install --quiet -r scripts/requirements.txt
    - run: .venv/bin/python scripts/deploy_agents.py
    - run: .venv/bin/python scripts/smoke_test.py

① GitHub にプライベート リポジトリを作る

リポジトリの作成
番号項目説明
1Repository nameリポジトリ名。Runner の登録先と、OIDC の subject に入る
2Choose visibilityPrivate にする(Self-hosted runner はプライベート リポジトリでだけ使う)
3Add READMEオフ(空のリポジトリに手元のコードを push する)

② Runner 用の PAT を作る

GitHub の Settings ⇒「Developer settings」⇒「Personal access tokens」⇒「Fine-grained tokens」⇒「Generate new token」。
Runner が GitHub のキューを見ることと、自分を Runner として登録することに使う。

PAT の名前、有効期限、対象リポジトリ
番号項目説明
1Token nameトークンの名前
2Expiration有効期限。期限の前に作り直して Secret を更新する
3Only select repositories対象をこのリポジトリだけにする
PAT の権限
番号項目説明
1ActionsRead-only(ワークフローのキューを見る)
2AdministrationRead and write(Runner の登録トークンを取る)
3MetadataRead-only(必須)
PAT の確認画面

作成前の確認画面で、対象が 1 リポジトリ、権限が 3 つだけになっていることを確かめて「Generate token」。
表示されたトークンは一度しか見られないので、手順 ④ まで控えておく。

③ Cloud Shell で準備スクリプトを実行する

Azure ポータルの Cloud Shell を Bash で開く。
ファイルを残す必要がないので「ストレージ アカウントは不要です」を選んだ。

Cloud Shell の開始

最初に、東日本で gpt-5-mini をグローバル標準で使えるかを確かめた。

az cognitiveservices model list --location japaneast \
  --query "[?model.name=='gpt-5-mini'].{version:model.version, sku:join(',', model.skus[].name)}" -o table
モデルの確認結果

2025-08-07 で GlobalStandard が使えることが分かったので、Bicep もこのバージョンにした。
次に、Cloud Shell の「ファイルの管理」⇒「アップロード」で bootstrap.sh を送る。

スクリプトのアップロード
GH_OWNER=<GitHub のユーザー名> GH_REPO=<リポジトリ名> bash bootstrap.sh
準備スクリプトの結果

スクリプトは、リソース プロバイダーの登録、リソース グループの作成、OIDC 用のユーザー割り当て Managed Identity(id-github-infra)の作成、フェデレーション資格情報の登録、リソース グループへのロールの割り当て(共同作成者、ロールベースのアクセス制御管理者)を行う。
中身:scripts/bootstrap.sh。
ロールベースのアクセス制御管理者は、Bicep の中で Runner の ID にロールを付けるために使う。

az identity federated-credential create \
  --name github-main \
  --identity-name "$IDENTITY" \
  --resource-group "$RG" \
  --issuer "https://token.actions.githubusercontent.com" \
  --subject "repo:${GH_OWNER}/${GH_REPO}:ref:refs/heads/main" \
  --audiences "api://AzureADTokenExchange"

④ GitHub に Variables と Secret を登録する

リポジトリの Settings ⇒「Secrets and variables」⇒「Actions」。
クライアント ID などは秘密情報ではないので Variables、PAT だけを Secrets に入れる。

Variables の登録
番号項目説明
1VariablesVariables タブ
2Repository variablesAZURE_CLIENT_ID、AZURE_LOCATION、AZURE_RESOURCE_GROUP、AZURE_SUBSCRIPTION_ID、AZURE_TENANT_ID の 5 つ(手順 ③ の出力の値)
Secret の登録
番号項目説明
1RUNNER_GITHUB_PAT手順 ② の PAT。
infra ワークフローが Bicep に渡し、Runner ジョブのシークレットになる

※ Variables と Secret を登録してから push する。
先に push すると、値がない状態で infra ワークフローが動いて失敗する。

⑤ コードを push する

git init -b main
git add .
git commit -m "初回: Foundry 閉域 CI/CD 一式"
git remote add origin https://github.com/<GitHub のユーザー名>/<リポジトリ名>.git
git push -u origin main

1 回目の push は GH007 のエラーで止まり、その後の infra も OIDC のエラーで失敗した(どちらも「実機でつまずいた点」)。
直したあとの流れは次のとおり。

push からエージェントの反映までの流れ
push 直後のワークフロー
番号項目説明
1agents #2infra の完了を待つ実行(workflow_run)。
同時に 1 つしか動かさない設定なので待ち
2infra #1Azure を構築中(GitHub-hosted runner)
3agents #1push で始まった実行。
deploy は Runner ができるまで Queued のまま待つ
infra の実行中のステップ
番号項目説明
1Foundry と Runner を作る(main.bicep)OIDC のサインイン、ACR、Runner イメージのビルドが終わり、本体を作っているところ
infra の完了
番号項目説明
1succeeded8 分 50 秒で完了。
いちばん長いのは main.bicep(4 分 14 秒)と Runner イメージのビルド(3 分 43 秒)

infra が終わって Runner ジョブができると、待っていた agents の deploy が VNet 内の Runner で動き出す。

agents の deploy のログ
番号項目説明
1エージェントを反映helpdesk-agent のバージョン 1 を作成
2動作確認実際に質問して応答が返った。
指示のとおり「担当部署に確認してください」で締め、パスワードを人に伝えないよう案内している
すべてのワークフローの結果
番号項目説明
1infra #1成功(8 分 54 秒)
2agents #1成功。Runner を待った時間を含めて 11 分 6 秒

⑥ VNet の外から Foundry を呼ぶ

手元の PC(VNet の外)から、正しいトークンを付けてエージェントの一覧を取ってみた。

TOKEN=$(az account get-access-token --scope https://ai.azure.com/.default --query accessToken -o tsv)
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://<Foundry の名前>.services.ai.azure.com/api/projects/proj-agents/agents?api-version=v1"
HTTP 403

{"error":{"code":"403","message": "Public access is disabled. Please configure private endpoint."}}

認証が正しくても、ネットワークの時点で止まる。
ポータルの Foundry ⇒「ネットワーク」でも、許可するアクセス元が「無効」になっている。

Foundry のネットワーク設定
番号項目説明
1無効公開ネットワーク アクセスが無効。
Private Endpoint がアクセスの唯一の方法

⑦ 自分の IP だけ一時的に許可して、ポータルで見る

公開アクセスが無効なので、Foundry ポータルでもエージェントは見られない。
確認のため、自分の IP だけを一時的に許可し、自分のアカウントにプロジェクトの Foundry ユーザーを付けた(ポータルでエージェントの中身を見るにはデータ アクションの権限が要る)。

ACC=/subscriptions/<サブスクリプション ID>/resourceGroups/rg-foundry-private-cicd/providers/Microsoft.CognitiveServices/accounts/<Foundry の名前>
az resource update --ids "$ACC" --set properties.publicNetworkAccess=Enabled \
  'properties.networkAcls={"defaultAction":"Deny","ipRules":[{"value":"<自分のグローバル IP>"}],"virtualNetworkRules":[]}'

OID=$(az ad signed-in-user show --query id -o tsv)
az role assignment create --assignee-object-id "$OID" --assignee-principal-type User \
  --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" --scope "$ACC/projects/proj-agents"

※ Git Bash で実行するときは、パスの書き換えを止めるため先に export MSYS_NO_PATHCONV=1 を実行する。
53ca6127-… は Foundry ユーザーの組み込みロールの ID。

Foundry ポータルのエージェント一覧
番号項目説明
1helpdesk-agentGitHub から反映したエージェント。種類はプロンプト、バージョン 1
エージェントの詳細
番号項目説明
1モデルgpt-5-mini(グローバル標準のデプロイ)
2手順YAML の instructions がそのまま入っている
3バージョンcreate_version で作られたバージョン 1

※ ポータルで編集しても、次に GitHub から反映すると YAML の内容で新しいバージョンが作られる。
変更は YAML で行い、確認が終わったら公開アクセスを無効に戻す。

片付け

az group delete --name rg-foundry-private-cicd --yes
az cognitiveservices account list-deleted -o table
az cognitiveservices account purge --name <Foundry の名前> --resource-group rg-foundry-private-cicd --location japaneast

Foundry は削除しても論理削除の状態で残り、一覧では完全に削除される予定日が削除の 48 時間後になっていた。
同じ名前で作り直すなら purge しておく。
GitHub 側は、PAT とリポジトリを削除する。

実機でつまずいた点

GH007: Your push would publish a private email address.

GH007 のエラー
番号項目説明
1GH007push が拒否された。
コミットの作成者のメール アドレスが、非公開にしているメール アドレスだった

git config の user.email に GitHub アカウントのメール アドレスを設定してコミットし、push したところで拒否された。
GitHub のメールの設定で「Keep my email addresses private」と「Block command line pushes that expose my email」をオンにしていると、作成者が非公開のメール アドレスになっているコミットの push は止められる。
対処は、GitHub が用意する noreply のアドレス(ID+ユーザー名@users.noreply.github.com)に変えて、コミットの作成者を作り直すこと。
noreply のアドレスは、GitHub の Settings ⇒「Emails」に表示される。

git config user.email "<ID>+<ユーザー名>@users.noreply.github.com"
git commit --amend --reset-author --no-edit
git push -u origin main

公式ドキュメント:
個人のメールアドレスを公開するコマンドラインのプッシュのブロック | GitHub Docs
メール アドレスのリファレンス | GitHub Docs

AADSTS700213: No matching federated identity record found for presented assertion subject

OIDC のサインインの失敗
番号項目説明
1subject claimGitHub が送ってきた subject。
repo:<ユーザー名>@<所有者 ID>/<リポジトリ名>@<リポジトリ ID>:ref:refs/heads/main の形
2AADSTS700213Entra ID に、この subject と一致するフェデレーション資格情報がない

bootstrap.sh で、フェデレーション資格情報の subject を従来の形(repo:<ユーザー名>/<リポジトリ名>:ref:refs/heads/main)で登録していた。
ところが GitHub は、2026 年 7 月 15 日以降に作られたリポジトリでは、所有者 ID とリポジトリ ID を含む変更できない形の subject を既定で使う。
今回のリポジトリは新しく作ったので新しい形で届き、照合に失敗した。
それ以前のリポジトリは、選んで切り替えない限り従来の形のまま(名前の変更や移管をすると新しい形に移る)。

フェデレーション資格情報は、subject が間違っていてもエラーなく作れてしまい、トークンの交換で初めて失敗する。
対処は、ログに出た subject をそのまま使って、フェデレーション資格情報を追加すること。

az identity federated-credential create \
  --name github-main-ids \
  --identity-name id-github-infra \
  --resource-group rg-foundry-private-cicd \
  --issuer "https://token.actions.githubusercontent.com" \
  --subject "repo:<ユーザー名>@<所有者 ID>/<リポジトリ名>@<リポジトリ ID>:ref:refs/heads/main" \
  --audiences "api://AzureADTokenExchange"

追加して 1 分ほど待ち、infra を再実行(Re-run all jobs)するとサインインが通った。
所有者 ID は GitHub の API(users/<ユーザー名> の id)でも確かめられる。

公式ドキュメント:
OpenID Connect リファレンス | GitHub Docs
外部 ID プロバイダーを信頼するようにユーザー割り当てマネージド ID を構成する | Microsoft Learn

推奨構成

条件推奨
閉域が不要な検証選択肢 1(標準ランナー+OIDC)。いちばん安い
閉域が必要で、GitHub に払いたくない選択肢 3(Container Apps ジョブ)。待機中の費用がかからない
閉域が必要で、Runner を管理したくない(有料プラン)選択肢 2(Larger runner+VNet 注入)
Docker を使うビルドも同じ Runner で行う選択肢 4 の VM / VMSS
Runner を大規模に増減させたい選択肢 4 の AKS+ARC

注意事項

項目内容
リポジトリの公開範囲Self-hosted runner はプライベート リポジトリでだけ使う
OIDC の subject2026 年 7 月 15 日以降に作ったリポジトリは、所有者 ID とリポジトリ ID を含む形。
フェデレーション資格情報もその形で登録する
PAT有効期限があるので、期限の前に作り直して Secret を更新し、infra を流し直す
ジョブのシークレットContainer Apps ジョブを起動できる ID は、シークレットを名前で参照できる。
ジョブの開始の権限は信頼できる ID だけに付ける
DockerContainer Apps ジョブの Runner では Docker を実行できない
ポータルでの確認公開アクセスが無効だとポータルからも見えない。
IP を一時的に許可したら、終わったら無効に戻す
削除したあとFoundry は論理削除で残る。同じ名前で作り直すなら purge する

まとめ

・閉域の Foundry でも、Bicep での構築(ARM)は外から届き、エージェントの作成(データ プレーン)は VNet の中からしか届かない。
・ランナーは、標準(閉域では使えない)、Larger runner の VNet 注入(有料プラン)、Container Apps ジョブ、VM・AKS の 4 つ。
・インフラは OIDC の ID、エージェントは VNet 内の Runner の Managed Identity と分けると、Foundry を操作できる資格情報を GitHub に置かずに済む。
・GitHub の Free プランのまま、main に push するだけでプロンプト エージェントまで反映できた。
・新しいリポジトリの OIDC の subject は ID を含む形になっているので、フェデレーション資格情報もその形で登録する。

コメント

タイトルとURLをコピーしました