Dev Proxy instellen

Dev Proxy is een opdrachtregelprogramma waarmee u gedrag en fouten van cloud-API's kunt simuleren om tolerante apps te bouwen.

In deze zelfstudie leert u hoe u Dev Proxy installeert en uitvoert.

Dev Proxy installeren

De eenvoudigste manier om Dev Proxy te installeren is door winget te gebruiken. U kunt dev proxy ook handmatig installeren.

Geautomatiseerde

Als u Dev Proxy wilt installeren met behulp van winget, voert u de volgende opdracht uit:

winget install Microsoft.DevProxy --silent

Belangrijk

Het installatieprogramma voor dev proxy voegt een nieuwe vermelding toe aan PATH. Als u Dev Proxy wilt gebruiken na de installatie, moet u de opdrachtprompt opnieuw starten om de PATH-omgevingsvariabele te vernieuwen.

Handleiding

Download de meest recente versie en pak de bestanden uit in een map. Voor deze zelfstudie wordt ervan uitgegaan dat u de bestanden uitpakt in een map met de naam devproxy die zich in uw basismap bevindt.

Als u Dev Proxy vanuit een map wilt starten, voegt u de locatie van de installatiemap toe aan uw PATH.

1. Open het menu Start.
2. Voer Edit environment variables for your account in het zoekvak in. Selecteer het resultaat in de lijst om het dialoogvenster Environment Variables te openen.
3. Selecteer in de sectie User variables for <username> de rij met de variabelenaam van Path en selecteer de knop Edit....
4. Selecteer in het dialoogvenster Edit environment variable de knop New.
5. Voer %USERPROFILE%\devproxy in de nieuwe rij in en selecteer OK.
6. Als u wijzigingen wilt bevestigen, selecteert u OK.

Notitie

Installeer de bètaversie van Dev Proxy om de nieuwste preview-functies uit te proberen.

Geautomatiseerde

Als u Dev Proxy wilt installeren met behulp van winget, voert u de volgende opdracht uit:

winget install Microsoft.DevProxy.Beta --silent

Handleiding

Download de meest recente bètaversie en pak de bestanden uit in een map. Volg de handmatige installatiestappen zoals eerder beschreven.

Als u de bètaversie van Dev Proxy wilt uitvoeren, gebruikt u devproxy-beta

De eenvoudigste manier om Dev Proxy te installeren is door Homebrew te gebruiken. U kunt dev proxy ook handmatig installeren.

Geautomatiseerde

Voer de volgende opdrachten uit om Dev Proxy te installeren met Homebrew:

brew tap dotnet/dev-proxy
brew install dev-proxy

Handleiding

Download de meest recente versie en pak de bestanden uit in een map. Voor deze zelfstudie wordt ervan uitgegaan dat u de bestanden uitpakt in een map met de naam devproxy die zich in uw basismap bevindt.

Als u Dev Proxy vanuit een map wilt starten, voegt u de locatie van de installatiemap toe aan uw PATH.

In de onderstaande stappen ziet u hoe u de proxy toevoegt aan PATH wanneer u zsh shell gebruikt. Afhankelijk van de shell die u gebruikt, kan het profielbestand verschillen.

1. Open uw shell-profiel in een teksteditor >~/.zshrc.
2. Werk PATH omgevingsvariabele bij met de locatie van de proxy->export PATH=".:$PATH:$HOME/devproxy".
3. Laad uw profiel opnieuw >source ~/.zshrc.

Notitie

Installeer de bètaversie van Dev Proxy om de nieuwste preview-functies uit te proberen.

Geautomatiseerde

Voer de volgende opdrachten uit om Dev Proxy te installeren met Homebrew:

brew tap dotnet/dev-proxy
brew install dev-proxy-beta

Handleiding

Download de meest recente bètaversie en pak de bestanden uit in een map. Volg de handmatige installatiestappen zoals eerder beschreven.

Als u de bètaversie van Dev Proxy wilt uitvoeren, gebruikt u devproxy-beta

De eenvoudigste manier om Dev Proxy te installeren, is met behulp van het installatiescript. U kunt dev proxy ook handmatig installeren.

Geautomatiseerde

Voer de volgende opdrachten uit om Dev Proxy te installeren met behulp van het installatiescript:

bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)"

Als u PowerShell gebruikt, voert u de volgende opdracht uit:

(Invoke-WebRequest https://aka.ms/devproxy/setup.ps1).Content | Invoke-Expression

Handleiding

Download de meest recente versie en pak de bestanden uit in een map. Voor deze zelfstudie wordt ervan uitgegaan dat u de bestanden uitpakt in een map met de naam devproxy die zich in uw basismap bevindt.

Als u Dev Proxy vanuit een map wilt starten, voegt u de locatie van de installatiemap toe aan uw PATH.

In de onderstaande stappen ziet u hoe u de proxy toevoegt aan PATH wanneer u een bash-shell gebruikt. Afhankelijk van de shell die u gebruikt, kan het profielbestand verschillen.

1. Open uw shell-profiel in een teksteditor >~/.bashrc.
2. Werk PATH omgevingsvariabele bij met de locatie van de proxy->export PATH=".:$PATH:$HOME/devproxy".
3. Laad uw profiel opnieuw >source ~/.bashrc.

Notitie

Installeer de bètaversie van Dev Proxy om de nieuwste preview-functies uit te proberen.

Geautomatiseerde

Voer de volgende opdrachten uit om Dev Proxy te installeren met behulp van het installatiescript:

bash -c "$(curl -sL https://aka.ms/devproxy/setup-beta.sh)"

Als u PowerShell gebruikt, voert u de volgende opdracht uit:

(Invoke-WebRequest https://aka.ms/devproxy/setup-beta.ps1).Content | Invoke-Expression

Handleiding

Download de meest recente bètaversie en pak de bestanden uit in een map. Volg de handmatige installatiestappen zoals eerder beschreven.

Als u de bètaversie van Dev Proxy wilt uitvoeren, gebruikt u devproxy-beta

Dev Proxy voor de eerste keer starten

De eerste keer dat u Dev Proxy op uw computer start, moet u een paar stappen uitvoeren om ervoor te zorgen dat Dev Proxy aanvragen van uw computer kan onderscheppen en succesvol kan reageren. U hoeft deze stappen niet te herhalen na de eerste uitvoering.

1. Dev Proxystarten. Open een opdrachtpromptsessie. Voer devproxy in en druk op Enter-.
2. vertrouwenscertificaat. Dev Proxy installeert een certificaat met de naam Dev Proxy CA. Er wordt een waarschuwing weergegeven. Selecteer Yes om te bevestigen dat u het certificaat wilt installeren. Dev Proxy gebruikt dit certificaat om HTTPS-verkeer te ontsleutelen dat vanaf uw computer wordt verzonden.
3. Toegang tot de firewalltoestaan. Windows Firewall blokkeert de proxy. Er wordt een waarschuwing weergegeven. Selecteer Allow access knop om verkeer via de firewall toe te staan.

1. Dev Proxystarten. Open een opdrachtpromptsessie. Voer devproxy in en druk op Enter-.
2. vertrouwenscertificaat. Dev Proxy installeert een certificaat met de naam Dev Proxy CA, dat wordt gebruikt voor het ontsleutelen van HTTPS-verkeer dat vanaf uw computer wordt verzonden. Er wordt een waarschuwing weergegeven. Druk op y- om te bevestigen dat u het certificaat wilt vertrouwen.
3. Accepteer binnenkomende verbindingen. Er wordt een waarschuwing weergegeven. Selecteer Allow om te bevestigen.

1. Dev Proxystarten. Open een opdrachtpromptsessie. Voer devproxy in en druk op Enter-.

2. vertrouwenscertificaat. Dev Proxy maakt gebruik van een aangepast SSL-certificaat om HTTPS-verkeer te ontsleutelen dat vanaf uw computer wordt verzonden.

   Belangrijk

   De volgende instructies zijn voor Ubuntu. Voor andere Linux-distributies kunnen de stappen verschillen.

   Als u het certificaat wilt installeren en vertrouwen, voert u in een nieuwe opdrachtprompt de volgende opdrachten uit:

   # Export Dev Proxy root certificate
   openssl pkcs12 -in ~/.config/dev-proxy/rootCert.pfx -clcerts -nokeys -out dev-proxy-ca.crt -passin pass:""
   # Install the certificate
   sudo cp dev-proxy-ca.crt /usr/local/share/ca-certificates/
   # Update certificates
   sudo update-ca-certificates
   

De opdrachtprompt geeft de volgende uitvoer weer:

 info    8 error responses loaded from devproxy-errors.json
 info    Dev Proxy API listening on http://localhost:8897...
 info    Dev Proxy Listening on 127.0.0.1:8000...

Hotkeys: issue (w)eb request, (r)ecord, (s)top recording, (c)lear screen
Press CTRL+C to stop Dev Proxy

Dev Proxy is standaard geconfigureerd voor:

• Onderschep verzoeken die naar een JSON Placeholder API eindpunt worden gestuurd
• API-foutantwoorden en API-drosseling simuleren met een foutpercentage van 50%

Controleer of de dev-proxy correct werkt

Dev Proxy onderschept aanvragen die toepassingen op uw computer maken naar URL's die u bij Dev Proxy registreert. Wanneer Dev Proxy een aanvraag detecteert, wordt deze doorgegeven aan de API (geen actie ondernemen) of wordt een antwoord geretourneerd. Laten we controleren of dev proxy werkt zoals verwacht.

Gebruik in PowerShell de cmdlet Invoke-WebRequest om een GET-aanvraag te verzenden naar de JSON Placeholder API.

Invoke-WebRequest -Uri https://jsonplaceholder.typicode.com/posts

Als u curlgebruikt, verzendt u een GET-aanvraag naar de tijdelijke aanduidings-API voor JSON met behulp van de volgende opdracht.

curl -ikx http://localhost:8000 https://jsonplaceholder.typicode.com/posts

U kunt ook een API-client zoals Postman- gebruiken om een GET-aanvraag naar https://jsonplaceholder.typicode.com/postste verzenden.

In de opdrachtregel waarop Dev Proxy wordt uitgevoerd, ziet u de informatie over de aanvraag en de actie die Dev Proxy heeft uitgevoerd. Standaard simuleert Dev Proxy een foutreactie met een kans van 50%. Als uw verzoek geen fout retourneert, geeft Dev Proxy deze door.

 req   ╭ GET https://jsonplaceholder.typicode.com/posts
 time  │ 1/31/2025 12:12:14 PM +00:00
 skip  │ RetryAfterPlugin: Request not throttled
 skip  │ GenericRandomErrorPlugin: Pass through
 api   ╰ Passed through

Als Dev Proxy een foutbericht retourneert, ziet u het foutbericht in de uitvoer.

 req   ╭ GET https://jsonplaceholder.typicode.com/posts
 time  │ 1/31/2025 12:12:37 PM +00:00
 skip  │ RetryAfterPlugin: Request not throttled
 oops  ╰ 403 Forbidden

Belangrijk

Als u geen uitvoer ziet in de opdrachtprompt, is het waarschijnlijk dat Dev Proxy geen aanvragen onderschept. Raadpleeg de sectie veelvoorkomende problemen voor hulp.

Dev Proxy veilig stoppen

Wanneer u Dev Proxy niet meer nodig hebt om te draaien, moet u Dev Proxy altijd veilig stoppen.

• Druk op Ctrl + C- om dev proxy veilig te stoppen.

Als u de opdrachtpromptsessie afsluit, wordt de registratie van dev proxy niet correct opgeheven als de systeemproxy. Mogelijk ondervindt u enkele veelvoorkomende problemen.

Volgende stap

Meer informatie over het configureren van Dev Proxy naar uw behoeften. Dev Proxy is zeer flexibel en ondersteunt veel verschillende scenario's. Meer informatie over het configureren ervan voor uw specifieke scenario.

Dev Proxy configureren