Einrichten des Dev-Proxys

Dev Proxy ist ein Befehlszeilentool, mit dem Sie Verhaltensweisen und Fehler von Cloud-APIs simulieren können, um robuste Apps zu erstellen.

In diesem Lernprogramm erfahren Sie, wie Sie Dev Proxy installieren und ausführen.

Installieren von Dev Proxy

Die einfachste Möglichkeit zum Installieren von Dev Proxy ist die Verwendung von Winget. Alternativ können Sie Dev Proxy manuell installieren.

Automatisiert

Führen Sie den folgenden Befehl aus, um Dev Proxy mit winget zu installieren:

winget install Microsoft.DevProxy --silent

Wichtig

Der Dev Proxy-Installer fügt einen neuen Eintrag zu PATH hinzu. Um Dev Proxy nach der Installation zu verwenden, müssen Sie die Eingabeaufforderung neu starten, um die PATH-Umgebungsvariable zu aktualisieren.

Manuell

Laden Sie die neueste Version herunter, und extrahieren Sie die Dateien in einen Ordner. In diesem Lernprogramm wird davon ausgegangen, dass Sie die Dateien in einen Ordner mit dem Namen devproxy in Ihrem Startverzeichnis extrahieren.

Um Dev Proxy aus einem beliebigen Verzeichnis zu starten, fügen Sie ihren Installationsordnerspeicherort zu Ihrem PATH hinzu.

1. Öffnen Sie das menü Start.
2. Geben Sie Edit environment variables for your account in das Suchfeld ein. Wählen Sie das Ergebnis in der Liste aus, um das Dialogfeld Environment Variables zu öffnen.
3. Wählen Sie im Abschnitt User variables for <username> die Zeile mit dem Variablennamen Path aus, und wählen Sie die Schaltfläche Edit... aus.
4. Wählen Sie im Dialogfeld Edit environment variable die Schaltfläche New aus.
5. Geben Sie %USERPROFILE%\devproxy in die neue Zeile ein, und wählen Sie OKaus.
6. Um Änderungen zu bestätigen, wählen Sie OKaus.

Anmerkung

Um die neuesten Vorschaufeatures zu testen, installieren Sie die Betaversion von Dev Proxy.

Automatisiert

Führen Sie den folgenden Befehl aus, um Dev Proxy mit winget zu installieren:

winget install Microsoft.DevProxy.Beta --silent

Manuell

Laden Sie die neueste Betaversion herunter, und extrahieren Sie die Dateien in einen Ordner. Führen Sie die manuellen Einrichtungsschritte aus, wie zuvor beschrieben.

Um die Betaversion von Dev Proxy auszuführen, verwenden Sie devproxy-beta

Die einfachste Möglichkeit zum Installieren von Dev Proxy ist die Verwendung von Homebrew. Alternativ können Sie Dev Proxy manuell installieren.

Automatisiert

Führen Sie die folgenden Befehle aus, um Dev Proxy mit Homebrew zu installieren:

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

Manuell

Laden Sie die neueste Version herunter, und extrahieren Sie die Dateien in einen Ordner. In diesem Lernprogramm wird davon ausgegangen, dass Sie die Dateien in einen Ordner mit dem Namen devproxy in Ihrem Startverzeichnis extrahieren.

Um Dev Proxy aus einem beliebigen Verzeichnis zu starten, fügen Sie ihren Installationsordnerspeicherort zu Ihrem PATH hinzu.

Die folgenden Schritte zeigen, wie Sie den Proxy zu PATH hinzufügen, wenn Sie zsh Shell verwenden. Je nach der verwendeten Shell kann sich ihre Profildatei unterscheiden.

1. Öffnen Sie Ihr Shellprofil in einem Text-Editor >~/.zshrc.
2. Aktualisieren Sie die Umgebungsvariable PATH für den Speicherort des Proxys >export PATH=".:$PATH:$HOME/devproxy".
3. Laden Sie Ihr Profil >source ~/.zshrcneu.

Anmerkung

Um die neuesten Vorschaufeatures zu testen, installieren Sie die Betaversion von Dev Proxy.

Automatisiert

Führen Sie die folgenden Befehle aus, um Dev Proxy mit Homebrew zu installieren:

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

Manuell

Laden Sie die neueste Betaversion herunter, und extrahieren Sie die Dateien in einen Ordner. Führen Sie die manuellen Einrichtungsschritte aus, wie zuvor beschrieben.

Um die Betaversion von Dev Proxy auszuführen, verwenden Sie devproxy-beta

Die einfachste Möglichkeit zum Installieren von Dev Proxy ist die Verwendung des Setupskripts. Alternativ können Sie Dev Proxy manuell installieren.

Automatisiert

Führen Sie die folgenden Befehle aus, um Dev Proxy mithilfe des Setupskripts zu installieren:

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

Wenn Sie PowerShell verwenden, führen Sie den folgenden Befehl aus:

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

Manuell

Laden Sie die neueste Version herunter, und extrahieren Sie die Dateien in einen Ordner. In diesem Lernprogramm wird davon ausgegangen, dass Sie die Dateien in einen Ordner mit dem Namen devproxy in Ihrem Startverzeichnis extrahieren.

Um Dev Proxy aus einem beliebigen Verzeichnis zu starten, fügen Sie ihren Installationsordnerspeicherort zu Ihrem PATH hinzu.

Die folgenden Schritte zeigen, wie Sie den Proxy bei Verwendung der Bash-Shell zu PATH hinzufügen. Je nach der verwendeten Shell kann sich ihre Profildatei unterscheiden.

1. Öffnen Sie Ihr Shellprofil in einem Text-Editor >~/.bashrc.
2. Aktualisieren Sie die Umgebungsvariable PATH für den Speicherort des Proxys >export PATH=".:$PATH:$HOME/devproxy".
3. Laden Sie Ihr Profil >source ~/.bashrcneu.

Anmerkung

Um die neuesten Vorschaufeatures zu testen, installieren Sie die Betaversion von Dev Proxy.

Automatisiert

Führen Sie die folgenden Befehle aus, um Dev Proxy mithilfe des Setupskripts zu installieren:

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

Wenn Sie PowerShell verwenden, führen Sie den folgenden Befehl aus:

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

Manuell

Laden Sie die neueste Betaversion herunter, und extrahieren Sie die Dateien in einen Ordner. Führen Sie die manuellen Einrichtungsschritte aus, wie zuvor beschrieben.

Um die Betaversion von Dev Proxy auszuführen, verwenden Sie devproxy-beta

Starten des Dev-Proxys zum ersten Mal

Wenn Sie Dev Proxy zum ersten Mal auf Ihrem Computer starten, müssen Sie einige Schritte ausführen, um sicherzustellen, dass Dev Proxy Anforderungen von Ihrem Computer abfangen und erfolgreich reagieren kann. Sie müssen diese Schritte nach der ersten Ausführung nicht wiederholen.

1. Start Dev Proxy. Öffnen Sie eine Eingabeaufforderungssitzung. Geben Sie devproxy ein, und drücken Sie die EINGABETASTE.
2. Trust-Zertifikat. Dev Proxy installiert ein Zertifikat mit dem Namen Dev Proxy CA. Eine Warnung wird angezeigt. Wählen Sie Yes aus, um zu bestätigen, dass Sie das Zertifikat installieren möchten. Dev Proxy verwendet dieses Zertifikat, um HTTPS-Datenverkehr zu entschlüsseln, der von Ihrem Computer gesendet wird.
3. Firewallzugriffzulassen. Die Windows-Firewall blockiert den Proxy. Eine Warnung wird angezeigt. Wählen Sie Allow access Schaltfläche aus, um Datenverkehr über die Firewall zuzulassen.

1. Start Dev Proxy. Öffnen Sie eine Eingabeaufforderungssitzung. Geben Sie devproxy ein, und drücken Sie die Eingabetaste.
2. Trust-Zertifikat. Dev Proxy installiert ein Zertifikat namens Dev Proxy CA, das zum Entschlüsseln von HTTPS-Datenverkehr verwendet wird, der von Ihrem Computer gesendet wird. Eine Warnung wird angezeigt. Drücken Sie y, um zu bestätigen, dass Sie dem Zertifikat vertrauen möchten.
3. Eingehende Verbindungen akzeptieren. Eine Warnung wird angezeigt. Wählen Sie Allow aus, um dies zu bestätigen.

1. Start Dev Proxy. Öffnen Sie eine Eingabeaufforderungssitzung. Geben Sie devproxy ein, und drücken Sie die Eingabetaste.

2. Trust-Zertifikat. Dev Proxy verwendet ein benutzerdefiniertes SSL-Zertifikat, um HTTPS-Datenverkehr zu entschlüsseln, der von Ihrem Computer gesendet wird.

   Wichtig

   Die folgenden Anweisungen gelten für Ubuntu. Bei anderen Linux-Distributionen können sich die Schritte unterscheiden.

   Um das Zertifikat zu installieren und zu vertrauen, führen Sie in einem neuen Eingabeaufforderungsfenster die folgenden Befehle aus:

   # 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
   

Die Eingabeaufforderung zeigt die folgende Ausgabe an:

 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

Standardmäßig ist Dev Proxy für Folgendes konfiguriert:

• Abfangen von Anfragen an jeden JSON Placeholder API Endpunkt
• Simulieren von API-Fehlerantworten und API-Drosselung mit einer Fehlerrate von 50 %

Vergewissern Sie sich, dass Der Dev-Proxy ordnungsgemäß funktioniert.

Dev Proxy fängt Anforderungen ab, die Anwendungen auf Ihrem Computer an URLs senden, die Sie bei Dev Proxy registrieren. Wenn Dev Proxy eine Anforderung erkennt, übergibt er sie entweder an die API (keine Aktion ergreifen) oder gibt eine Antwort zurück. Vergewissern wir uns, dass Dev Proxy erwartungsgemäß funktioniert.

Verwenden Sie in PowerShell das cmdlet Invoke-WebRequest, um eine GET-Anforderung an die JSON-Platzhalter-API zu senden.

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

Wenn Sie curlverwenden, senden Sie mithilfe des folgenden Befehls eine GET-Anforderung an die JSON-Platzhalter-API.

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

Sie können auch einen API-Client wie Postman verwenden, um eine GET-Anforderung an https://jsonplaceholder.typicode.com/postszu senden.

In der Befehlszeile, in der Dev Proxy ausgeführt wird, werden die Informationen über die Anforderung und die Aktion angezeigt, die Dev Proxy ausgeführt hat. Standardmäßig simuliert Dev Proxy eine Fehlerantwort mit einer Chance von 50%. Wenn Ihre Anforderung keinen Fehler zurückgibt, übergibt Dev Proxy die Anforderung.

 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

Wenn Dev Proxy eine Fehlerantwort zurückgibt, wird die Fehlermeldung in der Ausgabe angezeigt.

 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

Wichtig

Wenn in der Eingabeaufforderung keine Ausgabe angezeigt wird, ist es wahrscheinlich, dass Dev Proxy keine Anforderungen abfangen kann. Hilfe finden Sie im Abschnitt häufig auftretenden Probleme.

Sicheres Beenden des Dev-Proxys

Wenn Sie keinen Dev Proxy mehr ausführen müssen, sollten Sie ihn immer sicher beenden.

• Drücken Sie STRG + C-, um Dev Proxy sicher zu beenden.

Wenn Sie die Eingabeaufforderungssitzung herunterfahren, registriert sich Dev Proxy nicht korrekt als Systemproxy ab, und möglicherweise treten einige häufige Probleme auf.

Nächster Schritt

Erfahren Sie, wie Sie Dev Proxy für Ihre Anforderungen konfigurieren. Dev Proxy ist sehr flexibel und unterstützt viele verschiedene Szenarien. Erfahren Sie mehr darüber, wie Sie es für Ihr spezifisches Szenario konfigurieren.

Dev-Proxy konfigurieren