Geliştirme Proxy'si ayarlama

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.

Otomatik

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

winget install DevProxy.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.

En son sürümü indirin ve dosyaları bir klasöre ayıklayın. Bu öğreticide, dosyaları giriş dizininizde bulunan devproxy adlı bir klasöre ayıkladığınız varsayılır.

Dev Proxy'yi herhangi bir dizinden başlatmak için yükleme klasörü konumunu PATH'inize ekleyin.

1. Start menüsünü açın.
2. Arama kutusuna Edit environment variables for your account girin. listeden sonucu seçerek Environment Variables iletişim kutusunu açın.
3. User variables for <username> bölümünde, değişken adı Path olan satırı seçin ve Edit... düğmesini seçin.
4. Edit environment variable iletişim kutusunda New düğmesini seçin.
5. Yeni satıra %USERPROFILE%\devproxy girin ve OKöğesini seçin.
6. Değişiklikleri onaylamak için OKöğesini seçin.

Not

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

Otomatik

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

winget install DevProxy.DevProxy.Beta --silent

İndir en son beta sürümünü indirin ve dosyaları bir klasöre ayıklayın. Daha önce açıklandığı gibi el ile kurulum adımlarını izleyin.

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.

Otomatik

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

En son sürümü indirin ve dosyaları bir klasöre ayıklayın. Bu öğreticide, dosyaları giriş dizininizde bulunan devproxy adlı bir klasöre ayıkladığınız varsayılır.

Dev Proxy'yi herhangi bir dizinden başlatmak için yükleme klasörü konumunu PATH'inize ekleyin.

Aşağıdaki adımlarda, zsh kabuğu kullanılırken PATH'e proxy'nin nasıl ekleneceği gösterilmektedir. Kullandığınız kabuğa bağlı olarak profil dosyanız farklı olabilir.

1. Komut satırı profilinizi bir metin düzenleyicisinde >~/.zshrcaçın.
2. PATH ortam değişkenini proxy >export PATH=".:$PATH:$HOME/devproxy"konumuyla güncelleştirin.
3. profilinizi >source ~/.zshrcyeniden yükleyin.

Not

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

Otomatik

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

İndir en son beta sürümünü indirin ve dosyaları bir klasöre ayıklayın. Daha önce açıklandığı gibi el ile kurulum adımlarını izleyin.

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.

Otomatik

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

En son sürümü indirin ve dosyaları bir klasöre ayıklayın. Bu öğreticide, dosyaları giriş dizininizde bulunan devproxy adlı bir klasöre ayıkladığınız varsayılır.

Dev Proxy'yi herhangi bir dizinden başlatmak için yükleme klasörü konumunu PATH'inize ekleyin.

Aşağıdaki adımlar, bash kabuğu kullanılırken Proxy'nin PATH'e nasıl ekleneceğini göstermektedir. Kullandığınız kabuğa bağlı olarak profil dosyanız farklı olabilir.

1. Komut satırı profilinizi bir metin düzenleyicisinde >~/.bashrcaçın.
2. PATH ortam değişkenini proxy >export PATH=".:$PATH:$HOME/devproxy"konumuyla güncelleştirin.
3. profilinizi >source ~/.bashrcyeniden yükleyin.

Not

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

Otomatik

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

İndir en son beta sürümünü indirin ve dosyaları bir klasöre ayıklayın. Daha önce açıklandığı gibi el ile kurulum adımlarını izleyin.

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.

Not

Sertifika hakkında: Dev Proxy , yalnızca makinenizdeki HTTPS trafiğinin şifresini çözmek için yerel bir SSL sertifikası kullanır. Ara sunucu API yanıtlarını bu şekilde görebilir ve değiştirebilir. Sertifika yerel olarak depolanır ve Geliştirici Proxy'si Microsoft'a veri yüklemez. Diğer ayrıntılar için bkz . Geliştirme Proxy'si Microsoft'a veri yükler mi?

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üntülenir. 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örüntülenir. Sertifikaya güvenmek istediğinizi onaylamak için y tuşuna basın.
3. gelen bağlantıları kabul. Bir uyarı görüntülenir. 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

🎉 Herhangi bir kodu değiştirmeden API hatası simülasyonu yaptnız!

Uygulamanız aynı hatayı almış olabilir. Şimdi test etmeyi hayal edin:

• Bu, ödeme API'nize gerçekleşirse ne olur?
• Kullanıcının profili yüklenemezse ne olur?

Ö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.

Şimdi uygulamanızı test edin

Dev Proxy'nin demo API'sine bir isteği gerçekleştiremediğini gördünüz. Kendi uygulamanızla test etmek için:

1. Uygulamanızın çağıran API URL'sini bulun. Tarayıcınızın Geliştirici Araçları'ndaki Ağ sekmesini denetleyin veya kodunuzda HTTP istemci çağrılarını arayın.

2. URL'nizle Dev Proxy'yi çalıştırın:

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

3. Uygulamanızı normal şekilde kullanın. Dev Proxy'nin API çağrılarınıza hata eklemesini izleyin.

Yazılım yığınınız için Dev Proxy'si yapılandırma konusunda yardıma mı ihtiyacınız var? Bkz. kılavuzlar:

• Node.js uygulamaları
• .NET uygulamaları
• SharePoint Framework

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