>100 Views
November 15, 26
スライド概要
はじめまして、yukikoと申します。 IT教育支援や、DX推進が可能です。 ◆ スキル LPIC レベル2 AI / Python Splunk BI(データ可視化・分析) ◆ その他 新卒・未経験の学生向けに、エンジニア転職を応援する資料を趣味で作成しています。 もしよろしければご活用ください。
AzureのAPIをモックで試験する 原理原則|模倣サーバー × API連携試験 × Azure うさうさ研修工房|Udemy講座・DXエンジニア向け実務講座
この講座のゴール(6つ) STEP1 講師の整理 1. 本物のAPIに頼らず試験する理由を説明できる 2. モック試験の原理原則を5つ言える 3. Azureが示す再試行の考え方(公式)を試験に落とせる 4. 模倣サーバーを動かし、成功と失敗を再現できる 5. モックが本物とずれていないか、確かめる仕組みを持てる 6. モックで言えること・言えないことを、人が説明できる 講師の設計。到達の目安であり、資格や規格ではありません 2
全体の地図:8つのSTEP 講師の整理 難度9 難度6 難度5 難度4 STEP7 試験の試験 難度3 STEP5 難度2 難度1 STEP2 STEP1 原理原則5つ STEP4 失敗を再現して試 STEP3 模倣サーバーを作 験 Azureの一時的エ る ラー 難度3 STEP6 Azure上に置く STEP8 運用へ持ち帰る なぜモックか 難度は講師の設計(山場はSTEP7)。分数は目安 3
本物のAPIに頼ると困る3つ STEP1 講師の整理 いつも同じとは限らない 失敗を狙って起こせない 費用・制限・秘密が絡む 混雑、障害、通信の揺れ。 429や503を、試験のため 呼ぶたびに課金や上限があ 同じ入力でも、結果が変わ に本物から出してもらうこ る。本物のキーを試験に持 ることがある。 とはできない。 ち込むのも危うい。 講師の整理。共有リソースへのアクセスがスロットリングされうる点は公式(transient-faults) 4
本物とモックの役割分担 STEP1 講師の整理 確かめたいこと モックで確かめる 本物で確かめる 自分のコードの分岐(429・503・ 401) ◎ 決定的に再現 × 狙えない 再試行の回数・待ち時間 ◎ 件数と待ちを記録 △ 時間がかかる 応答の読み取り(項目の有無) ○ 契約に沿った応答で ◎ 本物の形 認証・権限・リージョンの設定 × 再現できない ◎ 本物で確認 本物の性能・上限・料金 × 分からない ◎ 本物で確認 設計案。割合や頻度の数値は設けません 5
モック試験の原理原則 5つ STEP2 講師の整理 1. 原則1 境界で試す:外部との接点を、自分のコードの外側に置く 2. 原則2 契約から作る:モックは、API仕様(契約)に沿って作る 3. 原則3 失敗も再現する:成功だけでなく、429・5xx・401・遅延・壊れた応答 4. 原則4 決定的にする:同じ入力は同じ結果。待ちは記録、乱数は固定 5. 原則5 ずれを見張る:モックと本物がずれていないか、確かめ続ける 講師の整理(公式・規格ではありません)。出典は各原則の次の表で示します 6
原則と、この講座の試験の対応 STEP2 講師の整理 原則 この講座での形 試験 1 境界で試す 呼ぶ側を client.py に閉じ込める AC-01 2 契約から作る 公式の応答項目で契約を書く AC-08 3 失敗も再現 401・429・503・400・壊れた本文・遅延 AC-02〜07 4 決定的にする 待ちは記録のみ。受信記録で件数確認 AC-03・04 5 ずれを見張る 契約試験+実APIは別枠(未実施を明示) AC-08・09 AC番号は講座の模倣サーバー試験(azure-mock-kit)。公式の根拠は STEP3・6 で確認 7
演習1:自分の連携先を点検 STEP2 動画を止めて取り組む(目安 10分) 講師の整理 原則 自分の連携先で確認 記入例 1 境界 呼ぶ処理は1か所か 3か所に散らばる→集約 2 契約 応答の項目を書き出したか 未→公式から書く 3 失敗 再現できる失敗は何種類か 成功のみ→429を追加 4 決定的 待ち・乱数で試験が遅い/揺れるか 実際に待つ→注入 5 ずれ モックと本物の照合をしているか していない→AC-08 右列は記入例(架空の連携先)。自分の連携先で埋める 8
再試行する/しないエラー(公式) STEP3 公式 論点 公式の記述(要約) 再試行の候補 HTTP 429(Too Many Requests)と 5xx サーバーエラー 再試行しない 400・401・403・404 などの多くの 4xx。成功し得ない操作 Retry-After ヘッダーがあれば従い、指定時間以上待つ。サーバーの指示はクラ イアントのバックオフ計算より優先 注意 503 などは、サービスが失敗していて、その後の試行にも応答しない 可能性がある 公式:learn.microsoft.com(2026-11-15 確認)/architecture/best-practices/transient-faults。表現は要約 9
待ち方と、攻撃的すぎる再試行(公式) STEP3 公式 論点 公式の記述(要約) 指数バックオフ 再試行ごとに間隔を延ばす(例:2秒、4秒、8秒)。ジッター(小さなラン ダム遅延)を加える 即時再試行 1回まで。失敗したらバックオフへ タイムアウト 再試行の前に、すべての発信呼び出しへ設定する 回数 無限の再試行は禁止。有限回数、またはサーキットブレーカー 多層の再試行 層ごとに再試行すると回数が掛け算になる(例:各層3回なら計9回) 公式:learn.microsoft.com(2026-11-15 確認)/同上。数値の例は公式の例示で、推奨値ではありません 10
高速文字起こしAPIの形(公式) STEP3 公式 呼び方 応答の主な項目 429のとき POST・multipart/form- durationMilliseconds、 公式の例は、最大5回、2・ data。audio と definition combinedPhrases(text)、 4・8・16・32秒の指数 (JSON)。キーは Ocp- phrases(offset・ バックオフ。この講座の数 Apim-Subscription-Key duration・text・locale・ 値は別設計(講師の整理) ヘッダー(公式) confidence)(公式) 公式:learn.microsoft.com(2026-11-15 確認)/ai-services/speech-service/fast-transcription-create。ページ題名はプレビュー表記。提供状況は使う前に確認 11
模倣サーバーの核(抜粋)
STEP4
実行確認済み
# 受けた1回ごとの流れ
1. 受信を記録する(キー・形式)
2. 予約された並びから次のステータスを取る
(空なら 200)
3. キーが違えば 401
4. 429 / 503 なら Retry-After を付けて返す
5. 200 ならダミーの応答を返す
# 本物のAzureには
# 一切つながらない
# 制御用の口(試験が使う)
POST /__mock/sequence
{"statuses":[429,200],
"retry_after":5}
→ 次は429(5秒待て)、その次は200
GET /__mock/requests
→ 何回・どんな形で来たか
# キーは固定のダミー文字列
# 秘密は使わない
azure-mock-kit/app/mock_server.py(要約)。標準ライブラリのみ・ダミー応答のみ。Azureには接続しません
12
模倣サーバーが再現できる状況 STEP4 実行確認済み 状況 予約の仕方 確かめること 成功 並びなし(既定は200) 応答を読める・形式を守った送信 認証エラー 401 キーを間違える 再試行しない 混雑 429 [429, 200] + retry_after 指示以上に待つ 障害 503 [503, 503, …] 回数で諦める 壊れた応答 本文を上書き 落ちずに契約違反として扱う 遅延 delay を指定 タイムアウトして再試行 azure-mock-kit の試験で確認。本物のAzureが同じ順で返す保証はありません 13
演習2:起動して試験を1回流す 受講資料 STEP4 動画を止めて取り組む(目安 10分) 1. フォルダ azure-mock-kit に移動する 2. python3 -m unittest discover -s tests -t . -v を実行する 3. 9件のうち、8件が ok、1件が skipped になることを確認する 4. skipped の理由(実APIは未実施)を読み、自分の言葉で説明する 5. tests/test_api_integration.py を開き、AC-03 の中身を読む コマンドは Mac/Linux で確認。Windows は未確認。資料 azure-mock-kit の README を参照 14
API連携試験 AC-01〜09 STEP5 実行確認済み AC 確かめること 結果 01 成功:応答を読める・キーとmultipartとapi-versionを送る 合格 02 401:再試行しない(受信1回) 合格 03 429→200:Retry-Afterの5秒を待つ 合格 04 503が続く:3回で諦める(待ち1・2秒) 合格 05 400:再試行しない 合格 06 壊れた本文・項目欠落:契約違反 合格 07 遅延:タイムアウトして再試行→諦める 合格 08 モックの応答が契約に沿う/契約が緩んでいない 合格 09 実API:スモーク 未実施 azure-mock-kit/tests(実行:8件合格・1件スキップ)。AC番号は講座の設計 15
AC-03:429のあと200(読む) STEP5 実行確認済み # 呼ぶ側(client.py の要点) wait = max(backoff(tries) + jitter(), retry_after or 0) sleep(wait) # Retry-After があれば、 # バックオフ以上に待つ(公式) # 401・400 は再試行しない(公式) # 試験(AC-03) self.seq([429, 200], retry_after=5) r = self.call() assert 受信は2回 assert 待ちの記録 == [5.0] # バックオフは1秒。 # Retry-After の5秒が優先される # → sleep を記録に差し替えるので # 試験は一瞬で終わる azure-mock-kit の client.py と tests(要約)。待ちは注意:試験では実際には待たず記録する 16
試験を決定的にする3つの工夫 STEP5 講師の整理 待ちを注入する ポート0で起動 受信記録で確かめる sleep を引数にして、試験 OSに空いている番号を選 戻り値だけでなく、何回・ では記録するだけにする。 ばせる。他の試験と衝突し どんな形で来たかを、サー 速く、揺れない。 ない。 バー側から確かめる。 講師の整理(原則4)。実際の効果は環境による 17
演習3:403 の試験を足す 受講資料 STEP5 動画を止めて取り組む(目安 10分) 1. AC-02 を手本に、403 のとき再試行しない試験を書く(AC-10) 2. mock_server に、403 を返す予約ができるか確認する(statuses に 403) 3. 最初は、クライアントが403をどう扱うか、予想を1行で書く 4. 試験を流し、予想と結果を比べる 5. 合格したら、client.py の再試行対象から 403 を外していることを、自分の言葉で説明する 403 は公式で再試行しない例(多くの4xx)に含まれる。AC番号は自分で付ける(例 AC-10) 18
Azure上にモックを置く3つの道 STEP6 公式 道 公式の記述(要約) 向く場面 API Management の バックエンド無しで、ポリシーが定義した応答を モック応答 返す。応答は example 優先、無ければ schema から生成、無ければ内容なし。全階層で利用可 設計先行・並行開発 Azure Functions (HTTP) Python v2 は @app.route で定義。ローカルは func start で実行できる 動きを自由に書く 自前のコンテナ (講師の整理)模倣サーバーを入れて動かす。動 作は未確認 ローカルと同じ物を 共有 公式:learn.microsoft.com(2026-11-15 確認)/api-management/mock-api-responses・mock-response-policy/azure-functions。3行目は講師の整理で動作未確認 19
APIMとFunctionsの書き方
STEP6
公式
<!-- API Management(inbound) -->
<mock-response
status-code="200"
content-type="application/json" />
# 公式:属性にポリシー式は使えない
# 公式:example → schema の順で応答を選ぶ
# Azure Functions(Python v2)
app = func.FunctionApp(
http_auth_level=func.AuthLevel.ANONYMOUS)
@app.route(route="transcribe", methods=["POST"])
def transcribe(req: func.HttpRequest):
... # 429・503 も返せる
APIM:mock-response-policy/Functions:functions-reference-python(2026-11-15 確認)。Azure上での実行は未確認(Functionsの直接呼び出しはローカルで実行確認済
み)
20
Azureに置くときの注意(公式) STEP6 公式 費用と後片付け 上書きと共有 認証と秘密 Functions の作成手順には 既存の関数アプリへのデプ ANONYMOUS のモックを 少額の費用がかかると記載。 ロイは内容を上書き。共有 公開すると誰でも呼べる 不要ならリソースグループ のAzureリソースは過負荷 (講師の整理)。ダミー専 を削除(公式) にしない(公式) 用にし、秘密を入れない 公式:learn.microsoft.com(2026-11-15 確認)/azure-functions/create-first-function-vs-code-python、architecture/best-practices/transient-faults。3枚目は講師の整理 21
山場:試験の試験(変異で壊す) STEP7 実行確認済み わざと壊す 期待 実際 Retry-After を無視する AC-03 が不合格 不合格(検出) 401 も再試行する AC-02 が不合格 エラー(検出) 契約の必須項目を緩める AC-08 が不合格 最初は全件合格(見逃し) モックの応答から項目を欠く AC-08 が不合格 AC-01・03・08 が失敗(検出) azure-mock-kit で実行。1行目の変異を入れて試験が不合格になれば、試験は効いている 22
見逃しから学ぶこと ★ STEP7 実行確認済み 原因 直し方 学び 契約の試験が、別の理由で 必須項目を1つずつ欠かし、 緑は安心の根拠にならない。 も不合格になる書き方だっ その項目名のエラーが出る 壊して不合格になるまで、 た。1項目が緩んでも気づ かを確かめる。 試験を信じない。 けなかった。 azure-mock-kit の変異3。直した試験:必須項目を1つずつ欠いて、契約が検出するか確かめる 23
演習4:自分の変異を1つ入れる 受講資料 STEP7 動画を止めて取り組む(目安 15分) 1. client.py のコピーを取る 2. 変異を1つ選ぶ(例:最大回数の比較を1つずらす/待ち時間を0にする) 3. 試験を流し、どの試験が不合格になるか予想→結果を比べる 4. すり抜けた場合は、どの試験が足りないかを書き、試験を足す 5. コピーから元に戻し、全件が元の結果に戻ることを確認する 変異は1回に1つ。終わったら必ず元に戻す(コピーを取ってから) 24
モックで言えること・言えないこと STEP8 講師の整理 言えること 言えないこと 自分のコードが、想定した失敗に、想定どお り動く 本物のAzureが、同じ失敗を、同じ形で返す 応答の項目が、契約と食い違えば気づける 契約(公式の記述)が、今も変わっていない 再試行の回数と待ちが、設計どおり 本物の上限・料金・性能・リージョン差 試験が、わざと壊したときに不合格になる 認証・権限の設定が、本物で通る 講師の整理。実APIの確認は別枠(AC-09)。本講座では未実施 25
運用へ持ち帰る5つ STEP8 講師の整理 1. 契約を公式から書き、更新日を残す(使う前に公式を開く) 2. 実APIのスモーク試験を別枠で持ち、未実施を合格と混ぜない 3. 変異の試験を、試験を足したときに1回やる 4. モックを置いたAzureのリソースは、期限と持ち主を決めて片付ける 5. 最後は人が責任をもつ:合否と承認は人。AIや機械は、材料を作る 設計案。頻度・数値は各現場で決める(本講座では数値を設けません) 26
まとめ:確認したこと/未確認のこと 講師の整理 1. 確認:Azureの一時的エラーの考え方(429・5xx・Retry-After・バックオフ・タイムアウ ト・多層再試行)、APIMのモック応答、高速文字起こしAPIの形 2. 実行確認:模倣サーバーと試験9件(8合格・1スキップ)、変異4件、Functionsの直接呼び 出し(ローカル) 3. 未確認:Azure上での実行(APIM・Functions・コンテナ)、実API、料金、Windows、各社 の運用規程 4. 次の一手:自分の連携先で、演習1の点検表を1枚埋める 公式は 2026-11-15 に確認。収録・受講の前に、公式ページを開いて更新してください 27
この資料の使い方 受講資料 1. 動画を見ながら、 のところで止めて手を動かす 2. 公式のラベルと、講師の整理のラベルを区別して読む 3. 未確認と書かれたことは、自分で確かめるまで事実にしない 4. 秘密・本番データ・お客様の情報は使わない(ダミーだけ) 5. 試験の結果は、合格・不合格・未実施の3つに分けて残す 受講生用の追加ページ(講師用のスライド番号は動きません) 28
考えてみよう5問と答えの目安 受講資料 問い 答えの目安 401 を再試行しないのはなぜ? 成功し得ないから。キーが違うまま待っても直ら ない Retry-After があるとき、何を優先? サーバーの指示を優先し、指定時間以上待つ スキップは合格か? 合格ではない。未実施として見せる 全件合格でも安心できない理由は? 試験が効いていないかもしれない。壊して確かめ る モックで言えないことは? 本物の返し方・契約の現在・上限・料金・認証設 定 答えは目安。自分の現場の事情で変わる 29
用語集 受講資料 用語 この講座での意味 モック(模倣サーバー) 本物の代わりに、ダミー応答を返すもの 契約 応答に最低限あるべき項目の取り決め Retry-After 「この秒数待って」という、サーバーからの指示 バックオフ 再試行の間隔を延ばしていく待ち方 変異 コードをわざと壊して、試験が検出するか見ること 講座内の用法。厳密な定義は公式を参照 30
次にやること 受講資料 1. 演習1の点検表を、自分の連携先で埋める 2. 連携先の応答項目を、公式から書き出す 3. 試験表に『未実施』の欄を作る 4. 変異を1つ入れて、試験が検出するか確かめる 宿題の目安。数値は設けません 31