Simulace náhodných chyb pro vaši vlastní aplikaci

V tomto kurzu zjistíte, jak pomocí vývojového proxy serveru simulovat náhodné chyby pro vaši vlastní aplikaci.

Požadavky

V této části kurzu se předpokládá, že jste na počítači nainstalovali a nakonfigurovali dev proxy server. Pokud ne, udělejte to teď.

Abyste mohli postupovat podle tohoto kurzu, potřebujete aplikaci, která volá rozhraní API. Potřebujete také znát adresy URL rozhraní API, která vaše aplikace volá.

Dev Proxy můžete použít s libovolným typem zásobníku aplikací a technologií. Tady jsou pokyny, jak nastavit proxy pro vývojáře s několika oblíbenými technologiemi.

JavaScript

Použití vývojového proxy serveru s:

• Node.js aplikací
• Node.js aplikací v Dockeru
• Azure Functions JavaScriptu
• řešení SharePoint Framework (SPFx)

.NET

Použití vývojového proxy serveru s:

• Aplikace .NET
• Aplikace .NET v Dockeru
• Aplikace .NET Aspire

Pokud používáte dev Proxy s aplikací .NET 4.8, musíte dev Proxy zaregistrovat ve svém systému pomocí netsh.

Další

Pokud chcete používat vývojový proxy server s aplikací na straně klienta, obvykle nemusíte provádět žádné další kroky. Po spuštění dev Proxy automaticky zachytí všechny požadavky z vašeho počítače.

Pokud chcete používat proxy pro vývoj s aplikací na straně serveru vytvořenou pomocí technologie, která tu není uvedená, možná budete muset provést další kroky ke konfiguraci aplikace pro používání dev proxy serveru. Informace o tom, jak ji nakonfigurovat pro použití síťového proxy serveru, najdete v dokumentaci k vaší technologii. Pokud máte nějaké dotazy, požádejte o pomoc v komunitě dev proxy na Discordu.

Spuštění vývojového proxy serveru s monitorováním adres URL

Spusťte dev Proxy a monitorujte adresy URL rozhraní API, která volá vaše aplikace. Pokud například vaše aplikace volá rozhraní API umístěné na adrese https://api.contoso.com/v1/customers, spusťte dev proxy a monitorujte vzor https://api.contoso.com/*adresy URL .

devproxy --urls-to-watch "https://api.contoso.com/*"

Parametr --urls-to-watch sděluje dev proxy serveru, které požadavky se mají zachytit. Zástupný znak * na konci adresy URL říká proxy serveru pro vývojáře, aby zachytá všechny požadavky na adresy URL, které začínají na https://api.contoso.com/.

Začněte aplikaci používat obvyklým způsobem. Dev Proxy zachytává všechny požadavky na adresy URL, které jste zadali. Na příkazovém řádku se zobrazí zprávy o požadavcích, které proxy vývojářů zachycuje.

```text
 request     GET https://api.contoso.com/v1/customers
     api   ╭ Passed through
           ╰ GET https://api.contoso.com/v1/customers
 request     GET https://api.contoso.com/v1/customers
   chaos   ╭ 403 Forbidden
           ╰ GET https://api.contoso.com/v1/customers

Důležité

Pokud se na příkazovém řádku nezobrazují žádné zprávy, ujistěte se, že jste aplikaci správně nakonfigurovali tak, aby používala dev proxy. Zkontrolujte také, jestli dev proxy zachytává požadavky na adresy URL rozhraní API, které používá vaše aplikace. Pokud máte nějaké dotazy, požádejte o pomoc v komunitě dev proxy na Discordu.

Vytvoření vlastních konfiguračních souborů

Dev Proxy ve výchozím nastavení používá devproxyrc.json pro nastavení konfigurace soubor v instalační složce dev proxy. Soubor je nakonfigurovaný tak, aby simuloval náhodné chyby pro rozhraní API pro zástupný symbol JSON. Pokud chcete získat realističtější výsledky, vytvořte vlastní konfigurační soubory s chybami, které jsou relevantnější pro vaši aplikaci a rozhraní API, která používá, a použijte je s vývojovým proxy serverem.

Představte si, že chcete konfigurační soubor uložit do složky projektu vaší aplikace, abyste mohli sdílet nastavení konfigurace se zbytkem týmu.

1. V instalační složce dev proxy zkopírujte devproxyrc.json a devproxy-errors.json.
2. Do složky projektu vložte soubory.

Při použití konfiguračního souboru, který je uložený mimo instalační soubor vývojového proxy serveru, je potřeba zajistit, aby odkazy byly pluginPath správné. Místo pevného kódování cest k instalační složce vývojového proxy serveru v konfiguračním souboru můžete použít ~appFolder na začátku cesty dynamický odkaz zpět na instalační složku vývojového proxy serveru.

1. V textovém editoru devproxyrc.json otevřete soubor .
2. Vyhledejte modul plug-in GenericRandomErrorPlugin v poli plugins .
3. Aktualizujte na pluginPath~appFolder/plugins/dev-proxy-plugins.dll.
4. Vyhledejte modul plug-in RetryAfterPlugin v poli plugins .
5. Aktualizujte na pluginPath~appFolder/plugins/dev-proxy-plugins.dll.
6. V příkazovém řádku změňte pracovní adresář na složku projektu.
7. Zadejte devproxy --config-file devproxyrc.json a stisknutím klávesy Enter spusťte proxy pro vývoj pomocí konfiguračního souboru.
8. Z příkazového řádku odešlete požadavek do rozhraní API pro zástupné symboly JSON a zobrazte výstup.
9. Stisknutím ctrl + C bezpečně zastavte Dev Proxy.

Tip

Nainstalujte rozšíření Dev Proxy Toolkit pro Visual Studio Code, které usnadňuje vytváření a aktualizaci konfiguračních souborů.

Další krok

Dev Proxy podporuje mnoho různých scénářů, které vám pomůžou vytvářet robustnější aplikace. Projděte si návody, abyste se dozvěděli, jak používat různé funkce vývojového proxy serveru a vylepšovat svou aplikaci.

Prozkoumání návodů