Aracılığıyla paylaş

Geliştirme Proxy'si ayarlama

  • Makale

Dev Proxy, dayanıklı uygulamalar oluşturmanıza yardımcı olmak için bulut API'lerinin davranışlarını ve hatalarını simüle etmeye yardımcı olan bir komut satırı aracıdır.

Bu öğreticide Dev Proxy'yi yüklemeyi ve çalıştırmayı öğreneceksiniz.

Geliştirme Proxy'sini yükleme

Dev Proxy'yi yüklemenin en kolay yolu winget kullanmaktır. Alternatif olarak, Dev Proxy'yi el ile yükleyebilirsiniz.

Winget kullanarak Dev Proxy yüklemek için aşağıdaki komutu çalıştırın:

winget install Microsoft.DevProxy --silent

Önemli

Dev Proxy yükleyicisi PATH'e yeni bir giriş ekler. Yüklemeden sonra Dev Proxy kullanmak için, PATH ortam değişkenini yenilemek için komut istemini yeniden başlatmanız gerekir.

Not

En son önizleme özelliklerini denemek için Dev Proxy'nin beta sürümünü yükleyin.

Winget kullanarak Dev Proxy yüklemek için aşağıdaki komutu çalıştırın:

winget install Microsoft.DevProxy.Beta --silent

Dev Proxy'nin beta sürümünü çalıştırmak için devproxy-beta

Dev Proxy'yi yüklemenin en kolay yolu Homebrew kullanmaktır. Alternatif olarak, Dev Proxy'yi el ile yükleyebilirsiniz.

Homebrew kullanarak Dev Proxy yüklemek için aşağıdaki komutları çalıştırın:

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

Not

En son önizleme özelliklerini denemek için Dev Proxy'nin beta sürümünü yükleyin.

Homebrew kullanarak Dev Proxy yüklemek için aşağıdaki komutları çalıştırın:

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

Dev Proxy'nin beta sürümünü çalıştırmak için devproxy-beta

Dev Proxy'yi yüklemenin en kolay yolu kurulum betiğini kullanmaktır. Alternatif olarak, Dev Proxy'yi el ile yükleyebilirsiniz.

Kurulum betiğini kullanarak Dev Proxy yüklemek için aşağıdaki komutları çalıştırın:

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

PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:

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

Not

En son önizleme özelliklerini denemek için Dev Proxy'nin beta sürümünü yükleyin.

Kurulum betiğini kullanarak Dev Proxy yüklemek için aşağıdaki komutları çalıştırın:

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

PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:

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

Dev Proxy'nin beta sürümünü çalıştırmak için devproxy-beta

Geliştirme Proxy'sini ilk kez başlatma

Makinenizde Dev Proxy'yi ilk kez başlattığınızda, Geliştirme Proxy'sinin makinenizden gelen istekleri durdurabilmesini ve başarıyla yanıt vermesini sağlamak için izleyebileceğiniz birkaç adım vardır. İlk çalıştırmadan sonra bu adımları yinelemeniz gerekmez.

  1. Geliştirme Proxy'sini Başlat. Bir komut istemi oturumu açın. devproxy girin ve 'e basarak'yi girin.
  2. Güven sertifikası. Dev Proxy, Dev Proxy CAadlı bir sertifika yükler. Bir uyarı görüntülenir. Sertifikayı yüklemek istediğinizi onaylamak için Yes seçin. Dev Proxy, makinenizden gönderilen HTTPS trafiğinin şifresini çözmek için bu sertifikayı kullanır.
  3. güvenlik duvarı erişimine izin ver. Windows Güvenlik Duvarı ara sunucuyu engeller. Bir uyarı görünüyor. Güvenlik duvarı üzerinden trafiğe izin vermek için Allow access düğmesini seçin.
  1. Geliştirme Proxy'sini Başlat. Bir komut istemi oturumu açın. devproxy girin ve 'e basarak'yi girin.
  2. Güven sertifikası. Dev Proxy, makinenizden gönderilen HTTPS trafiğinin şifresini çözmek için kullandığı Dev Proxy CAadlı bir sertifika yükler. Bir uyarı gösterilir. Sertifikaya güvenmek istediğinizi onaylamak için y tuşuna basın.
  3. gelen bağlantıları kabul. Bir uyarı belirir. Onaylamak için Allow seçin.

  1. Geliştirme Proxy'sini Başlat. Bir komut istemi oturumu açın. devproxy girin ve 'e basarak'yi girin.

  2. Güven sertifikası. Dev Proxy, makinenizden gönderilen HTTPS trafiğinin şifresini çözmek için özel bir SSL sertifikası kullanır.

    Önemli

    Aşağıdaki yönergeler Ubuntu içindir. Diğer Linux dağıtımları için adımlar farklı olabilir.

    Sertifikayı yüklemek ve güvenmek için, yeni bir komut isteminde aşağıdaki komutları çalıştırın:

    # 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

Komut istemi aşağıdaki çıkışı görüntüler:

 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

Varsayılan olarak, Geliştirme Proxy'si şu şekilde yapılandırılır:

  • Herhangi bir JSON Yer Tutucu API uç noktasına yapılan istekleri engelleme
  • 50% hata oranıyla API hata yanıtlarının ve API kısıtlamasının benzetimini yapın.

Dev Proxy'nin düzgün çalıştığını onaylayın

Dev Proxy, makinenizdeki uygulamaların Dev Proxy'ye kaydettiğiniz URL'lere yaptığı istekleri durdurur. Geliştirme Proxy'si bir istek algıladığında, bunu API'ye geçirir (hiçbir işlem gerçekleştirmez) veya bir yanıt döndürür. Dev Proxy'nin beklendiği gibi çalıştığını doğrulayalım.

PowerShell'de Invoke-WebRequest cmdlet'ini kullanarak JSON Yer Tutucu API'sine GET isteği gönderin.

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

curlkullanıyorsanız, aşağıdaki komutu kullanarak JSON Yer Tutucu API'sine bir GET isteği gönderin.

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

'a GET isteği göndermek için https://jsonplaceholder.typicode.com/posts gibi bir API istemcisi de kullanabilirsiniz.

Dev Proxy'nin çalıştığı komut satırında, istek hakkındaki bilgileri ve Dev Proxy'nin gerçekleştirdiği eylemi görürsünüz. Varsayılan olarak Dev Proxy, 50% şansı olan bir hata yanıtının benzetimini oluşturur. İsteğiniz hata döndürmezse Dev Proxy bunu iletir.

 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

Geliştirme Proxy'si bir hata yanıtı döndürürse, çıkışta hata iletisini görürsünüz.

 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

Önemli

Komut isteminde herhangi bir çıkış görmüyorsanız, Büyük olasılıkla Dev Proxy istekleri kesmiyor olabilir. Yardım için yaygın sorunlar bölümüne bakın.

Geliştirme Proxy'lerini güvenli bir şekilde durdurma

Artık Dev Proxy'nin çalışmasını gerektirmediğinizde, bunu her zaman güvenli bir şekilde durdurmanız gerekir.

  • Geliştirme Proxy'sini güvenli bir şekilde durdurmak için Ctrl + C tuşlarına basın.

Komut istemi oturumunu kapatırsanız, Dev Proxy sistem proxy'si olarak kaydı doğru şekilde kaldırmaz ve bazı yaygın sorunlarla karşılaşabilirsiniz.

Sonraki adım

Geliştirme Proxy'sini gereksinimlerinize göre yapılandırmayı öğrenin. Dev Proxy son derece esnektir ve birçok farklı senaryoyı destekler. Bunu kendi senaryonuza göre yapılandırma hakkında daha fazla bilgi edinin.

Geliştirme Ara Sunucusunu Yapılandır