SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-10-30

Self-hosted برای mocking و تست API روی VPS

با اجرای WireMock و Hurl روی VPS، وابستگی‌های بیرونی را شبیه‌سازی کنید: stubها در git، تست‌ها در CI و گزارش‌ها پس از rebuild نیز باقی می‌مانند.

دو وظیفه که از یک مخزن مشترک استفاده می‌کنند

میزبانی شخصی (self-hosting) برای شبیه‌سازی API (mocking) و تست کردن، دو وظیفه متفاوت هستند و یکی دانستن آن‌ها باعث اتلاف وقت می‌شود. یک سرور mock جایگزین وابستگی‌هایی می‌شود که نمی‌توانید از CI فراخوانی کنید: یک سرویس‌دهنده پرداخت، یک API شریک، یک سرویس بالادستی با محدودیت نرخ (rate limited) یا سرویسی که تیم دیگری هنوز آن را منتشر (ship) نکرده است. یک اجراکننده تست API، نقاط پایانی (endpoints) شما را با ترتیبی مشخص فراخوانی کرده و پاسخ‌ها را بررسی (assert) می‌کند و مقادیر را از یک پاسخ به درخواست بعدی منتقل می‌نماید.

برخی ابزارها هر دو وظیفه را انجام می‌دهند. وظیفه اصلی یک سرور mock، پاسخ‌دهی به درخواست‌ها است. یک اجراکننده تست، نظری درباره اینکه یک سرویس‌دهنده پرداخت هنگام رد شدن کارت چه پاسخی می‌دهد، ندارد. اکثر تیم‌هایی که از قبل یک سرور اجاره کرده‌اند، در نهایت هر دو را اجرا می‌کنند؛ سرویس‌هایی که توسط یک فایل Docker Compose مشترک راه‌اندازی شده و در یک pull request واحد بررسی می‌شوند.

چرا باید API mocking و تست را به‌صورت self-hosted اجرا کرد؟

فیکسچرهای شما داده‌هایی با ساختار تولید (production) هستند. بدنهٔ درخواست در یک تست API، یک رکورد واقعی از مشتری است که نام آن تغییر کرده، یا به دلیل عدم بررسی، نام آن تغییر نکرده است. استاب‌های ضبط‌شده (recorded stubs) وضعیت بدتری دارند: ضبط‌کنندهٔ پروکسی هر آنچه را که سرویس بالادستی واقعاً بازگردانده است ذخیره می‌کند؛ بنابراین، دایرکتوری استاب‌هایی که با ضبط ساخته شده، حاوی توکن‌های فعال و آدرس‌های ایمیل مشتریان است تا زمانی که کسی تک‌تک فایل‌ها را بررسی کند. در یک سرویس میزبانی‌شده (hosted service)، این داده‌ها به یک حادثه امنیتی برای دیگران و یک افشای اطلاعات برای شما تبدیل می‌شود.

دلیل دوم، قابلیت دسترسی است. سرویسی که به یک آدرس خصوصی متصل است، پیش از آنکه یک runner میزبانی‌شده بتواند به آن دسترسی پیدا کند، به یک اتصال شبکهٔ خصوصی نیاز دارد. هر راهکار جایگزین، هزینه‌ای در بر دارد. انتشار API روی اینترنت برای تست کردن آن، دلیلی که باعث خصوصی بودن آن شده است را از بین می‌برد. یک تونل یا یک کپی staging عمومی، سیستم دیگری برای نگهداری است و کپی staging بین نسخه‌های مختلف (releases) از نسخهٔ تولید فاصله می‌گیرد. runnerهای میزبانی‌شده در GitHub نیز از دسترسی خصوصی از طریق یک overlay شبکه WireGuard یا یک Azure Virtual Network پشتیبانی می‌کنند. یک runner در همان شبکهٔ خصوصی، سرویس را مستقیماً فراخوانی می‌کند و به هیچ‌کدام از این موارد نیاز ندارد؛ این همان استدلال عملی پشت یک GitHub Actions runner خود-میزبانی‌شده است.

کدام mock server خودمیزبانی‌شده را باید اجرا کنید؟

هر یک از این موارد به‌عنوان یک container روی سروری که مالک آن هستید اجرا می‌شوند. پرسش مهم این است که هر کدام چه چیزی را به‌عنوان منبع حقیقت (source of truth) در نظر می‌گیرند، زیرا این موضوع تعیین می‌کند که بازسازی container برای شما هزینه‌ای ندارد یا مستلزم صرف یک بعدازظهر وقت است.

  • WireMock هر stub را به‌عنوان یک فایل JSON در دایرکتوری mappings/ نگه می‌دارد و بدنه پاسخ‌های بزرگ را در __files/ ذخیره می‌کند. ایمیج آن wiremock/wiremock است، دایرکتوری ریشه آن در داخل container برابر با /home/wiremock است و همچنین به‌عنوان یک پروکسی ضبط‌کننده (recording proxy) عمل می‌کند. وجود فایل‌ها روی دیسک به این معناست که mock مانند هر کد دیگری در git زندگی می‌کند.
  • Mockoon CLI کل یک API مجازی را در یک فایل داده JSON نگه می‌دارد. آن را با npm install -g @mockoon/cli نصب کرده و با mockoon-cli start --data ./data-file.json اجرا کنید، یا ایمیج mockoon/cli را با bind mount کردن آن فایل اجرا کنید. اپلیکیشن دسکتاپ همان فایل را ویرایش می‌کند، بنابراین طراحی در رابط کاربری (UI) و commit کردن نتیجه با هم سازگار باقی می‌مانند.
  • MockServer از ایمیج mockserver/mockserver اجرا می‌شود و روی پورت 1080 گوش می‌دهد. انتظارات (expectations) از طریق API اختصاصی REST آن ارسال می‌شوند که برای کدهای تست کاربردی است اما به‌عنوان یک deployment ریسک دارد: به‌طور پیش‌فرض، انتظاری که با یک فراخوانی HTTP ایجاد شده باشد، با restart شدن container از بین می‌رود. برای stubهایی که قرار است دائمی باشند، از فایل مقداردهی اولیه JSON آن استفاده کنید. برای حفظ تغییرات زمان اجرا، persistExpectations را فعال کنید، فایل خروجی را خارج از container ذخیره (persist) کنید و آن را هنگام startup از طریق initializationJsonPath بارگذاری کنید.
  • Prism به جای استفاده از فایل‌های stub جداگانه، mock را از روی سند OpenAPI شما می‌سازد. آن را با npm install -g @stoplight/prism-cli نصب کرده و سپس prism mock openapi.yaml را اجرا کنید. در داخل یک container، عبارت -h 0.0.0.0 را اضافه کنید، زیرا Prism به‌طور پیش‌فرض به localhost متصل می‌شود و در غیر این صورت از خارج container غیرقابل دسترس است.
  • Microcks گزینه سنگین‌تری است: یک رابط کاربری وب که اسناد OpenAPI و مجموعه‌های Postman را وارد کرده، سپس آن‌ها را به‌عنوان mock ارائه می‌دهد و تست‌های قرارداد (contract tests) را اجرا می‌کند. نصب کامل آن به MongoDB و Keycloak، به‌علاوه Kafka برای ویژگی‌های ناهمگام (async) نیاز دارد. ایمیج همه‌کاره microcks-uber شامل یک MongoDB درون‌حافظه‌ای (in-memory) است که مستندات پروژه آن را برای استفاده‌های موقت (ephemeral) مناسب می‌داند؛ بنابراین هر چیزی که در آن UI ایجاد می‌شود را دورریختنی فرض کنید و مصنوعات منبع (source artifacts) را در git نگه دارید.

کدام ابزار تست API خودمیزبان (self-hosted) را باید اجرا کنید؟

وظیفه در اینجا یک توالی است: احراز هویت، ایجاد یک سفارش، خواندن مجدد آن و تایید تغییر وضعیت. این کار نیازمند مقداری است که از یک پاسخ دریافت شده و در درخواست بعدی استفاده شود. ابزاری که نتواند وضعیت را بین فراخوانی‌ها حفظ کند، یک ابزار بررسی سلامت (health check) است، نه یک تست API.

  • Hurl فایل‌های متنی ساده از درخواست‌های HTTP را از یک باینری واحد اجرا می‌کند. یک بخش [Captures] مقادیر را از پاسخ استخراج می‌کند، یک بخش [Asserts] آن‌ها را بررسی می‌کند و --test آن را به یک ابزار اجرای تست با خلاصه و کد خروج تبدیل می‌کند. نسخه 8.0.1 تا اوت 2026 نسخه فعلی است.
  • Bruno CLI پوشه‌ای از فایل‌های .bru را اجرا می‌کند. با npm install -g @usebruno/cli نصب کنید و سپس bru run folder --env Local --reporter-junit results.xml را اجرا کنید. فرمت مجموعه به‌گونه‌ای طراحی شده که فایل‌های متنی در یک دایرکتوری باشند، بنابراین تفاوت‌ها (diffs) در بازبینی‌ها خوانا هستند.
  • Newman مجموعه‌های Postman را خارج از محیط Postman اجرا می‌کند: npm install -g newman، سپس newman run collection.json -r cli,junit --reporter-junit-export results.xml. نکته مهم فرمت آن است. Newman مجموعه‌های خروجی‌گرفته‌شده را با فرمت JSON v2.1 اجرا می‌کند. Postman اکنون از فرمت مجموعه v3 و گردش‌کارهای Native Git از طریق Postman CLI نیز پشتیبانی می‌کند. مستندات Postman اعلام کرده‌اند که Newman دیگر به‌روزرسانی یا اصلاحیه‌ای دریافت نخواهد کرد و توصیه می‌کنند اسکریپت‌ها و خط‌لوله‌های CI به Postman CLI منتقل شوند.
  • Schemathesis نوع متفاوتی از بررسی است. این ابزار یک طرحواره OpenAPI را می‌خواند و مواردی را تولید می‌کند که سعی دارند پاسخ‌هایی ایجاد کنند که طبق طرحواره شما غیرممکن هستند: uvx schemathesis run https://your.api/openapi.json. این ابزار خرابی‌ها و نقض قراردادها را پیدا می‌کند و چون از قوانین تجاری شما اطلاعی ندارد، در کنار یک مجموعه اسکریپت‌نویسی‌شده قرار می‌گیرد، نه اینکه جایگزین آن شود.
  • Hoppscotch نسخه خودمیزبان، گزینه رابط کاربری وب است و به یک نمونه Postgres نیاز دارد. پیش از نصب، این بده‌بستان را درک کنید: مجموعه‌ها در یک پایگاه داده ذخیره می‌شوند، نه در مخزن کد شما.

موردی که باید از آن اجتناب کرد. Step CI همچنان در بررسی ابزارها ظاهر می‌شود و فرمت گردش‌کار YAML آن خوانایی خوبی دارد، اما آخرین کامیت این مخزن در اوت 2024 انجام شده است. برنامه‌ای که بین CI و API شما قرار می‌گیرد، مکان مناسبی برای کدهای بدون پشتیبانی نیست.

قرار دادن سرور mock پشت فایروال

پیکربندی زیر WireMock را به‌عنوان جایگزین یک ارائه‌دهنده خدمات پرداخت اجرا می‌کند. اگر فرمت فایل compose برای شما جدید است، Docker Compose روی VPS دستورات چرخه حیات که این بخش فرض می‌کند را پوشش می‌دهد.

services:
  mock-payments:
    image: wiremock/wiremock:3.13.2
    command: ["--verbose"]
    volumes:
      - ./mocks/payments:/home/wiremock
    ports:
      - "127.0.0.1:8080:8080"
    restart: unless-stopped

پیشوند 127.0.0.1: در پورت، بخش مهم ماجراست. یک 8080:8080 ساده، mock را روی تمام اینترفیس‌ها از جمله IP عمومی شما منتشر می‌کند و حتی با وجود مسدود بودن آن پورت در ufw، همچنان در دسترس می‌ماند؛ زیرا Docker ترافیک منتشرشده را پیش از رسیدن به قوانین INPUT در ufw، از طریق جدول nat مسیریابی می‌کند. برای اینکه پورت منتشرشده فقط از طریق localhost و با استفاده از شبکه bridge پیش‌فرض Docker در Engine 28.0.0 یا نسخه‌های جدیدتر قابل دسترسی باشد، آن را به آدرس loopback متصل (bind) کنید. نسخه‌های قدیمی‌تر به میزبان‌های موجود در همان شبکه لایه 2 اجازه می‌دهند به پورت‌های منتشرشده روی localhost دسترسی پیدا کنند. اتصال به آدرس یک اینترفیس خصوصی، همچنان اجازه دسترسی از شبکه‌هایی که به آن آدرس مسیریابی دارند را می‌دهد.

سرویس تحت تست شما سپس به mock اشاره می‌کند. هنگامی که سرویس در همان پروژه compose اجرا می‌شود، URL پایه mock برابر با http://mock-payments:8080 است، زیرا compose نام سرویس‌ها را در شبکه داخلی خود حل می‌کند. هنگامی که سرویس روی میزبان (host) اجرا می‌شود، این مقدار http://127.0.0.1:8080 است. آن را از طریق یک متغیر محیطی تنظیم کنید، نه در کد؛ در غیر این صورت URL تست به محیط production ارسال می‌شود.

Stubها در ./mocks/payments/mappings/ قرار می‌گیرند، برای هر کدام یک فایل JSON.

{
  "request": {
    "method": "POST",
    "urlPath": "/v1/charges",
    "bodyPatterns": [{ "matchesJsonPath": "$.amount" }]
  },
  "response": {
    "status": 201,
    "headers": { "Content-Type": "application/json" },
    "jsonBody": { "id": "ch_test_001", "status": "succeeded", "amount": 4200 }
  }
}

آن را اجرا کنید و سپس بررسی کنید چه چیزی واقعاً بارگذاری شده است.

docker compose up -d --wait mock-payments
curl -fsS http://127.0.0.1:8080/__admin/mappings

--wait تا زمانی که container وضعیت healthy را گزارش نکند، منتظر می‌ماند؛ این کار به این دلیل عمل می‌کند که ایمیج WireMock یک HEALTHCHECK در برابر endpoint /__admin/health خود دارد. فراخوانی mappings تمام stubهایی که سرور خوانده است را لیست می‌کند. استابی که نوشته‌اید و در آن لیست نیست، هرگز بارگذاری نشده است: بررسی کنید که فایل در مسیر mappings/ قرار داشته باشد (نه در ریشه mount شده) و صحت ساختار JSON را چک کنید.

هنگامی که درخواستی می‌رسد و هیچ استابی با آن مطابقت ندارد، WireMock پاسخ 404 می‌دهد. اگر یک تطابق نزدیک پیدا کند، بدنه پاسخ با Request was not matched شروع می‌شود و به دنبال آن یک diff در برابر نزدیک‌ترین استاب نمایش داده می‌شود. بدون نگاشت‌های استاب، بدنه پاسخ No response could be served as there are no stub mappings in this WireMock instance. است. وقتی diff وجود دارد، پیش از تغییر هر چیزی آن را بخوانید، زیرا فیلد دقیق تفاوت را مشخص می‌کند. این معمولاً مسیری با /v1/charge است که در استاب به صورت /v1/charges تعریف شده است.

نوشتن تست به صورت یک توالی با انتقال وضعیت بین فراخوانی‌ها

فایل‌های Hurl متن ساده هستند. بسته deb را از بخش releases پروژه نصب کنید.

VERSION=8.0.1
curl --location --remote-name https://github.com/Orange-OpenSource/hurl/releases/download/$VERSION/hurl_${VERSION}_amd64.deb
sudo apt update && sudo apt install ./hurl_${VERSION}_amd64.deb

یک مجموعه تست که API شما را در برابر mock در tests/checkout.hurl اجرا می‌کند.

POST {{base_url}}/orders
Content-Type: application/json
{
  "sku": "ssd-1tb",
  "amount": 4200
}
HTTP 201
[Captures]
order_id: jsonpath "$['id']"

GET {{base_url}}/orders/{{order_id}}
HTTP 200
[Asserts]
jsonpath "$.status" == "paid"
jsonpath "$.charge_id" == "ch_test_001"

بلوک [Captures] همان چیزی است که این تست را به یک تست API تبدیل می‌کند، نه دو درخواست بی‌ارتباط. مقدار order_id از پاسخ اول خوانده شده و در URL درخواست دوم جای‌گذاری می‌شود. assertion در charge_id هدف اصلی این تمرین است: این بخش ثابت می‌کند که سرویس شما با ارائه‌دهنده پرداخت تماس گرفته و پاسخ دریافتی را ذخیره کرده است، و مقداری که با آن مقایسه می‌شود همان مقداری است که شما در WireMock stub نوشته‌اید. اکنون یک فایل، هر دو بخش جریان را پوشش می‌دهد.

hurl --test --variable base_url=http://127.0.0.1:3000 \
  --report-junit reports/junit.xml \
  --report-json reports/json \
  tests/

یک اجرای موفق، یک خط به ازای هر فایل و یک خلاصه چاپ می‌کند.

tests/checkout.hurl: Success (2 request(s) in 61 ms)
Executed files:    1
Executed requests: 2 (30.1/s)
Succeeded files:   1 (100.0%)
Failed files:      0 (0.0%)
Duration:          64 ms

در صورت شکست، error: Assert failure به همراه نام فایل و شماره خط چاپ می‌شود، سپس مقداری که دریافت شده در برابر مقداری که انتظار می‌رفت قرار می‌گیرد، و hurl با کد خروجی غیر صفر پایان می‌یابد تا CI متوقف شود. اگر status مقدار pending را بخواند در حالی که شما انتظار paid را داشتید، یعنی سرویس شما پاسخ mock را پردازش نکرده است. گام بعدی، خواندن ژورنال درخواست‌های WireMock در /__admin/requests است که نشان می‌دهد آیا اصلاً درخواستی به mock رسیده است یا خیر.

اجرای مجموعه تست از طریق CI runner اختصاصی خود

با داشتن یک runner که روی همان سرور ثبت شده است، گردش کار کوتاه می‌شود. از آنجا که runner یک پردازش ساده روی میزبان است، docker و hurl باید روی همان میزبان نصب شده باشند. هیچ چیزی از imageهای میزبانی‌شده (hosted) به ارث نمی‌رسد.

name: api-tests
on: [push]
jobs:
  hurl:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - name: Start the mock
        run: docker compose up -d --wait mock-payments
      - name: Run the suite
        run: hurl --test --variable base_url=http://127.0.0.1:3000 --report-junit reports/junit.xml tests/
      - name: Archive the reports
        if: always()
        run: install -d /srv/api-tests/reports/$GITHUB_SHA && cp -r reports/. /srv/api-tests/reports/$GITHUB_SHA/
      - name: Stop the mock
        if: always()
        run: docker compose down

استفاده از if: always() در مرحله archive اهمیت دارد. بدون آن، در صورت شکست خوردن تست، عملیات کپی انجام نمی‌شود و شما دقیقاً گزارشی را که قصد بررسی آن را داشتید، از دست می‌دهید. همچنین این کپی باید در مسیری خارج از workspace ذخیره شود، زیرا actions/checkout@v4 به‌صورت پیش‌فرض پیش از دریافت کد، دستور git clean -ffdx را اجرا می‌کند که باعث حذف گزارش‌های ردیابی‌نشده از دایرکتوری مخزن در checkout بعدی می‌شود.

نتایج را حفظ کنید، نه فقط آخرین اجرا

یک فایل JUnit XML برای هر commit تنها به یک پرسش پاسخ می‌دهد: آیا تست موفق بود یا خیر. این فایل‌ها به این پرسش که یک endpoint از چه زمانی کند شده است پاسخ نمی‌دهند، زیرا پس از بستن فایل، دیگر کسی آن‌ها را نمی‌خواند. برای مشاهده روند تغییرات، به ازای هر اجرا یک ردیف به یک پایگاه‌داده کوچک روی همان سرور اضافه کنید. یک جدول واحد که شامل commit SHA، نام فایل، تعداد موفقیت‌ها، تعداد خطاها و مدت‌زمان اجرا باشد کافی است و استفاده از SQLite در محیط production روی یک VPS گزینه مناسبی برای ذخیره‌سازی آن است: یک فایل واحد، بدون نیاز به پردازش سرور، و کل تاریخچه در پشتیبان‌گیری‌هایی که از قبل انجام می‌دهید، گنجانده می‌شود. خروجی --report-json ابزار Hurl را برای دریافت داده‌های دقیق اجرا تحلیل کنید؛ هم فرمت JSON و هم JUnit XML برای ماشین قابل‌خواندن هستند.

چه چیزی باید از بازسازی کانتینر جان سالم به در ببرد

تعاریف Mock و مجموعه‌های تست، بخشی از کد منبع هستند. این موارد باید در مخزنی در کنار سرویسی که توصیف می‌کنند قرار بگیرند و در همان pull request که یک endpoint را تغییر می‌دهد، اصلاح شوند. Stubهایی که در یک رابط کاربری وب ویرایش می‌شوند، یا expectationهایی که در زمان اجرا از طریق REST API به MockServer ارسال می‌شوند، برای بقا پس از بازسازی نیاز به خروجی گرفتن (export) یا تنظیمات پایداری دارند. با اجرای docker compose down، حافظه کانتینر و لایه‌های قابل نوشتن از بین می‌روند؛ داده‌های ذخیره‌شده در bind mountها یا named volumeها باقی می‌مانند. اگر مخازن شما روی سخت‌افزار شخصی خودتان نیز اجرا می‌شوند، یک سرور git خودمیزبان، فیکسچرها و سرویس را در یک محدوده اعتماد واحد نگه می‌دارد.

سپس قوانین عملیاتی مطرح می‌شوند. تگ‌های ایمیج را ثابت (pin) کنید، زیرا latest می‌تواند نحوه تطبیق درخواست‌های mock شما را بدون هیچ تغییری در مخزن تغییر دهد و ردیابی علت این خطا بسیار دشوار است. دایرکتوری‌های stub را زمانی که ابزار نیازی به نوشتن در آن‌ها ندارد، به صورت read-only mount کنید. هرگز stubهای یک mock را در یک named Docker volume قرار ندهید، زیرا در این صورت volume به منبع اصلی حقیقت تبدیل شده و نسخه‌ای که در git قرار دارد بی‌سروصدا منسوخ می‌شود.

یک نکته دیگر که بسیاری را غافلگیر می‌کند: اگر stubها را با ضبط ترافیک واقعی از طریق یک پروکسی می‌سازید، پیش از commit کردن، هر فایل تولیدشده را بخوانید. یک فایل ضبط‌شده دقیقاً شامل همان چیزی است که سرویس بالادستی بازگردانده است، از جمله bearer tokenها و آدرس‌های ایمیل مشتریان. commit کردن این فایل، آن را برای همیشه در مخزن شما قرار می‌دهد، زیرا git محتوای حذف‌شده را در تاریخچه خود نگه می‌دارد.

FAQ

تفاوت بین یک سرور mock برای API و یک test runner برای API چیست؟

یک سرور mock به درخواست‌ها پاسخ می‌دهد. این سرور جایگزین وابستگی‌هایی می‌شود که نمی‌توانید از داخل CI با آن‌ها تماس بگیرید؛ برخی ابزارها همچنین تست‌های قرارداد (contract tests) را اجرا کرده و نتایج را گزارش می‌کنند. یک test runner برای API، درخواست‌ها را به سرویس شما می‌فرستد، پاسخ‌ها را ارزیابی (assert) می‌کند، مقادیر را از یک فراخوانی به فراخوانی بعدی منتقل می‌کند و در صورت شکست یک ارزیابی، با کد خروجی غیر صفر متوقف می‌شود. این دو ابزار مشکلات متفاوتی را حل می‌کنند و در یک پیکربندی معمول، هر دو همزمان اجرا می‌شوند: runner با سرویس شما تماس می‌گیرد و سرویس شما با mock تماس می‌گیرد.

آیا می‌توانم یک API داخلی را از یک CI runner میزبانی‌شده تست کنم؟

بله، با استفاده از شبکه خصوصی. runnerهای میزبانی‌شده توسط GitHub از یک overlay شبکه WireGuard یا یک Azure Virtual Network پشتیبانی می‌کنند تا بدون نیاز به انتشار (publish) عمومی API، به منابع خصوصی دسترسی پیدا کنند. انتشار API، اجرای یک تونل یا نگهداری یک نسخه staging عمومی، گزینه‌های دیگر هستند که هر کدام سیستم جدیدی اضافه می‌کنند که ممکن است دچار خرابی یا نشت اطلاعات شود. یک runner که در همان شبکه خصوصی قرار دارد، مستقیماً با سرویس تماس می‌گیرد؛ این اصلی‌ترین دلیل عملی است که تیم‌ها این کار را به صورت self-host انجام می‌دهند.

فایل‌های stub برای mock و مجموعه‌های تست API باید کجا قرار بگیرند؟

در git، کنار سرویسی که آن را توصیف می‌کنند. ابزارهایی که تعاریف را به صورت فایل ذخیره می‌کنند، مانند دایرکتوری mappings/ در WireMock، فایل داده Mockoon، فایل‌های Hurl و پوشه .bru در Bruno، امکان بررسی کد (code review) و بازسازی container با هزینه صفر را فراهم می‌کنند. ابزارهایی که تعاریف را در پایگاه داده یا یک رابط کاربری وب ذخیره می‌کنند، به یک برنامه پشتیبان‌گیری و مرحله خروجی‌گرفتن (export) نیاز دارند؛ و خروجی‌گرفتن همان بخشی است که افراد تا زمانی که container از بین نرود، آن را فراموش می‌کنند.

چرا با وجود درست بودن stub، سرور mock من خطای 404 برمی‌گرداند؟

WireMock تنها زمانی یک stub را ارائه می‌دهد که درخواست با matchers پیکربندی‌شده آن مطابقت داشته باشد. یک درخواست بدون تطابق، خطای 404 دریافت می‌کند؛ وقتی یک تطابق نزدیک وجود داشته باشد، بدنه پاسخ با Request was not matched شروع می‌شود و به دنبال آن تفاوت (diff) با نزدیک‌ترین stub نمایش داده می‌شود که فیلد متفاوت را مشخص می‌کند. اگر هیچ نگاشت stub وجود نداشته باشد، بدنه پاسخ توضیح می‌دهد که این نمونه هیچ stubای ندارد. دلایل رایج عبارتند از: وجود یک اسلش اضافی در مسیر، یک هدر Content-Type که stub به آن نیاز دارد اما کلاینت شما ارسال نکرده است، استفاده از urlPath در جایی که stub برای یک بخش متغیر به urlPathPattern نیاز دارد، و یک matcher برای بدنه که با payload مطابقت ندارد. ابتدا /__admin/requests را بررسی کنید تا مطمئن شوید درخواست اصلاً به mock رسیده است یا خیر.

آیا با وجود محیط staging، همچنان به mock نیاز دارم؟

بله، به دو دلیل. یک نسخه staging از سرویس بالادستی که کنترل آن را ندارید، همچنان ممکن است از دسترس خارج شود یا شما را محدود به نرخ (rate limit) کند، بنابراین مجموعه تست شما به دلایلی که هیچ ارتباطی به کد شما ندارند، شکست می‌خورد. همچنین، محیط staging نمی‌تواند پاسخ‌هایی که بیشترین نیاز را به تست آن‌ها دارید، مانند کارت رد شده یا خطای timeout در gateway، تولید کند. یک mock این پاسخ‌ها را در صورت تقاضا و با سرعت شبکه محلی برمی‌گرداند که باعث می‌شود مجموعه‌ای که در برابر یک sandbox دقایق طول می‌کشد، در عرض چند ثانیه اجرا شود. محیط staging را برای بررسی نهایی پیش از انتشار (release) نگه دارید و در CI از mock استفاده کنید.

آیا این مقاله مفید بود؟