Bagikan melalui

Menyiapkan Proksi Dev

  • Artikel

Dev Proxy adalah alat baris perintah yang membantu Anda mensimulasikan perilaku dan kesalahan API cloud untuk membantu Anda membangun aplikasi tangguh.

Dalam tutorial ini, Anda mempelajari cara menginstal dan menjalankan Dev Proxy.

Menginstal Proksi Dev

Cara termampu untuk menginstal Dev Proxy adalah dengan menggunakan winget. Atau, Anda dapat menginstal Dev Proxy secara manual.

Untuk menginstal Dev Proxy menggunakan winget, jalankan perintah berikut:

winget install Microsoft.DevProxy --silent

Penting

Penginstal Proksi Dev menambahkan entri baru ke PATH. Untuk menggunakan Dev Proxy setelah penginstalan, Anda harus memulai ulang prompt perintah untuk me-refresh variabel lingkungan PATH.

Nota

Untuk mencoba fitur pratinjau terbaru, instal versi beta Dev Proxy.

Untuk menginstal Dev Proxy menggunakan winget, jalankan perintah berikut:

winget install Microsoft.DevProxy.Beta --silent

Untuk menjalankan versi beta Dev Proxy, gunakan devproxy-beta

Cara term mudah untuk menginstal Dev Proxy adalah dengan menggunakan Homebrew. Atau, Anda dapat menginstal Dev Proxy secara manual.

Untuk menginstal Dev Proxy menggunakan Homebrew, jalankan perintah berikut:

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

Nota

Untuk mencoba fitur pratinjau terbaru, instal versi beta Dev Proxy.

Untuk menginstal Dev Proxy menggunakan Homebrew, jalankan perintah berikut:

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

Untuk menjalankan versi beta Dev Proxy, gunakan devproxy-beta

Cara term mudah untuk menginstal Dev Proxy adalah dengan menggunakan skrip penyiapan. Atau, Anda dapat menginstal Dev Proxy secara manual.

Untuk menginstal Dev Proxy menggunakan skrip penyiapan, jalankan perintah berikut:

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

Jika Anda menggunakan PowerShell, jalankan perintah berikut:

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

Nota

Untuk mencoba fitur pratinjau terbaru, instal versi beta Dev Proxy.

Untuk menginstal Dev Proxy menggunakan skrip penyiapan, jalankan perintah berikut:

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

Jika Anda menggunakan PowerShell, jalankan perintah berikut:

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

Untuk menjalankan versi beta Dev Proxy, gunakan devproxy-beta

Mulai Proksi Pengembang untuk pertama kalinya

Pertama kali Anda memulai Dev Proxy di komputer Anda, ada beberapa langkah yang harus diikuti untuk memastikan bahwa Dev Proxy dapat mencegat permintaan dari komputer Anda dan berhasil merespons. Anda tidak perlu mengulangi langkah-langkah ini setelah dijalankan pertama kali.

  1. Mulai Proksi Pengembangan. Buka jendela Command Prompt. Masukkan devproxy dan tekan Enter.
  2. sertifikat kepercayaan. Proksi Dev menginstal sertifikat bernama Dev Proxy CA. Peringatan muncul. Pilih Yes untuk mengonfirmasi bahwa Anda ingin menginstal sertifikat. Dev Proxy menggunakan sertifikat ini untuk mendekripsi lalu lintas HTTPS yang dikirim dari komputer Anda.
  3. Izinkan akses firewall. Windows Firewall memblokir proksi. Peringatan muncul. Pilih tombol Allow access untuk mengizinkan lalu lintas melalui firewall.
  1. Mulai Proksi Pengembangan. Buka jendela Command Prompt. Masukkan devproxy dan tekan Enter.
  2. sertifikat kepercayaan. Dev Proxy menginstal sertifikat bernama Dev Proxy CA, yang digunakannya untuk mendekripsi lalu lintas HTTPS yang dikirim dari komputer Anda. Sebuah peringatan muncul. Tekan y untuk mengonfirmasi bahwa Anda ingin mempercayai sertifikat.
  3. Terima koneksi masuk. Peringatan muncul. Pilih Allow untuk mengonfirmasi.

  1. Mulai Proksi Pengembangan. Buka jendela Command Prompt. Masukkan devproxy dan tekan Enter.

  2. sertifikat kepercayaan. Dev Proxy menggunakan sertifikat SSL kustom untuk mendekripsi lalu lintas HTTPS yang dikirim dari komputer Anda.

    Penting

    Instruksi berikut adalah untuk Ubuntu. Untuk distribusi Linux lainnya, langkah-langkahnya mungkin berbeda.

    Untuk menginstal dan mempercayai sertifikat, di prompt perintah baru, jalankan perintah berikut:

    # 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

Jendela perintah menampilkan keluaran berikut:

 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

Secara default, Dev Proxy dikonfigurasi ke:

  • Mencegat permintaan yang dibuat ke endpoint JSON Placeholder API
  • Simulasikan respons kesalahan API dan pembatasan kecepatan API dengan tingkat kegagalan 50%

Konfirmasikan bahwa Dev Proxy berfungsi dengan benar

Dev Proxy mencegat permintaan yang dibuat aplikasi di komputer Anda ke URL yang Anda daftarkan dengan Dev Proxy. Saat Dev Proxy mendeteksi permintaan, Dev Proxy meneruskannya ke API (tidak mengambil tindakan), atau mengembalikan respons. Mari kita konfirmasi bahwa Dev Proxy berfungsi seperti yang diharapkan.

Di PowerShell, gunakan cmdlet Invoke-WebRequest untuk mengirim permintaan GET ke JSON Placeholder API.

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

Jika Anda menggunakan curl, kirim permintaan GET ke JSON Placeholder API menggunakan perintah berikut.

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

Anda juga dapat menggunakan klien API seperti Postman untuk mengirim permintaan GET ke https://jsonplaceholder.typicode.com/posts.

Di baris perintah tempat Proksi Dev berjalan, Anda akan melihat informasi tentang permintaan dan tindakan yang dilakukan Proksi Dev. Secara default, Dev Proxy mensimulasikan respons kesalahan dengan peluang 50%. Jika permintaan Anda tidak menghasilkan kesalahan, Dev Proxy akan melewatkannya.

 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

Jika Dev Proxy mengembalikan respons kesalahan, Anda akan melihat pesan kesalahan dalam output.

 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

Penting

Jika Anda tidak melihat output apa pun di prompt perintah, Dev Proxy kemungkinan tidak mencegat permintaan. Periksa bagian masalah umum untuk bantuan.

Hentikan Proksi Dev dengan aman

Ketika Anda tidak lagi mengharuskan Dev Proxy berjalan, Anda harus selalu menghentikannya dengan aman.

  • Tekan Ctrl + C untuk menghentikan Dev Proxy dengan aman.

Jika Anda menutup sesi command prompt, Dev Proxy tidak membatalkan registrasi dengan benar sebagai proksi sistem, dan Anda mungkin mengalami masalah umum tertentu .

Langkah berikutnya

Pelajari cara mengonfigurasi Dev Proxy sesuai kebutuhan Anda. Dev Proxy sangat fleksibel dan mendukung banyak skenario yang berbeda. Pelajari selengkapnya tentang cara mengonfigurasinya ke skenario spesifik Anda.

Mengonfigurasi Proksi Pengembangan