Keploy'dan Apidog CLI'a Geçiş

Ekibiniz Keploy ile başladıysa, muhtemelen onun tek bir özelliğine bayılıyorsunuzdur: uygulamanızı çalıştırdınız, birkaç uç noktaya istek attınız ve testler ortaya çıktı. Hiçbir onaylama yazmaya, bağımlılıkları elle taslaklamaya gerek yok. Keploy, ağ katmanındaki gerçek trafiği yakalar ve sizin için yeniden oynatır.

Peki neden biri Keploy'dan vazgeçmek istesin? Genellikle farklı bir ihtiyaçtan kaynaklanır. Yakalanan testler, önceden meydana gelen hataları yakalamak için harikadır, ancak bir ekip genelinde okunması, incelenmesi ve sahiplenilmesi daha zordur. Bir noktada, yeni bir mühendisin bir çekme isteğinde açabileceği, bir bakışta anlayabileceği ve isteyerek değiştirebileceği testler istersiniz. Kontrol ettiğiniz test verileri, bir bayrakla değiştirdiğiniz ortamlar ve bir kayıttan türetilenler yerine tasarladığınız sahte sunucular istersiniz.

İki farklı paradigma, dürüstçe karşılaştırıldı

Keploy ve Apidog, "API testi" kelimelerinde örtüşse de, farklı araç kategorileridir. Aksini iddia etmek size bir kötülük olurdu.

Keploy, izole test kum havuzları oluşturmak için açık kaynaklı bir platformdur. İmza hareketi kaydet ve tekrar oynatmadır: ağ katmanında eBPF kullanarak, gerçek API çağrılarını ve bağımlılıklarını (veritabanı sorguları, alt hizmetler, akış olayları) SDK veya kod değişikliği olmadan yakalar. Yakalanan bu trafikten, bağımlılıklar için test durumlarını ve taklitleri otomatik olarak oluşturur. Ayrıca, bir OpenAPI spesifikasyonundan, Postman koleksiyonundan, cURL komutundan veya canlı bir uç noktadan süitler oluşturan bir yapay zeka test oluşturma yolu da vardır. Yakalama eBPF katmanında gerçekleştiği için, dilden bağımsızdır ve Linux ile yükseltilmiş ayrıcalıklara dayanır. Kaynak kodunu GitHub'da okuyabilirsiniz.

Apidog, hepsi bir arada bir API platformudur: tasarım, hata ayıklama, taklit etme, belgeleme ve test etme tek bir yerde. Apidog CLI (apidog run), yazdığınız test senaryolarını ve koleksiyonları terminalinizden ve CI/CD'de yürütür. Veri odaklı test, ortam değiştirme, birden çok rapor formatı ve bulut raporlarını destekler. Apidog ayrıca yapay zeka destekli test durumu oluşturma özelliğine de sahiptir, ancak bu, üretim trafiğini kaydetmek yerine, uygulamanın içindeki API şemanızdan ve uç noktalarınızdan çalışır.

Herhangi bir şey planlamadan önce bilmeniz gereken dürüst gerçek şudur: Apidog, eBPF aracılığıyla canlı trafiği yakalamaz ve üretim çağrılarını ve bağımlılık taklitlerini kaydederek testleri otomatik olarak oluşturmaz. Bu, Keploy'un belirgin gücüdür. Çalışma zamanı yakalama, iş akışınızın temelini oluşturuyorsa, bu iş için Keploy'u kullanmaya devam edin. Apidog'a geçerek elde edeceğiniz şey, tasarlanmış, incelenebilir, ekipler arası testler ve tüm API yaşam döngüsünü kapsayan bir platformdur.

Bu tabloyu bir özellik puan kartı olarak değil, bir çeviri rehberi olarak okuyun. Her Keploy yeteneği, Apidog'daki bilinçli bir yazma adımına karşılık gelir. "Araç bunu trafikten anladı" yerine "doğrunun nasıl göründüğünü siz tanımladınız" demiş olursunuz.

Adım 1: API yüzeyinizi bir spesifikasyon olarak yakalayın

Keploy çalışan bir uygulamadan başlar. Apidog ise API'nizin bir açıklamasından başlar. Dolayısıyla ilk görev, bu açıklamayı elde etmektir.

Zaten bir OpenAPI belgesi yayınlıyorsanız, işiniz bitti. Oraya işaret edin ve devam edin. Eğer yoksa, hepsi içe aktarılabilir bir şey üreten birkaç seçeneğiniz var:

• Çerçevenizden OpenAPI oluşturun (çoğu modern çerçevede bir dışa aktarıcı veya bunu üreten bir kütüphane bulunur).
• Ekibiniz zaten bir Postman koleksiyonu tutuyorsa, onu dışa aktarın.
• Her uç noktaya erişmek için kullandığınız cURL komutlarını toplayın.

Hoş bir yan etki: Keploy kayıtlarınız varsa, yakalanan istekler, hangi uç noktaların gerçekten çağrıldığının ve hangi yüklerle çağrıldığının gerçek dünya envanteridir. Kayıtları doğrudan içe aktarmasanız bile, spesifikasyonunuzun aynı yüzey alanını kapsadığından emin olmak için bunları bir kontrol listesi olarak kullanın.

Adım 2: Apidog'a aktarın

Apidog'u indirin, bir proje oluşturun ve OpenAPI dosyanızı, Postman koleksiyonunuzu veya cURL komutlarınızı içe aktarın. Apidog spesifikasyonu okur ve uç noktaları, istek şemalarını, parametreleri ve yanıt modellerini doldurur. Artık Keploy'un vurduğu aynı yüzeye sahip her uç noktanın yapılandırılmış bir tanımına sahipsiniz, ancak düzenleyebileceğiniz, sürümleyebileceğiniz ve paylaşabileceğiniz bir biçimde.

Platform farkının ortaya çıktığı an da budur. Bu içe aktarılan uç noktalar sadece test fikstürleri değildir. Hepsi tek bir içe aktarmadan canlı belgeler, hata ayıklanabilir istekler ve taklit sunucular için temel oluştururlar. Araç zincirinin adım adım açıklaması için Apidog CLI kapsamlı rehberi tüm kurulumu kapsar.

Adım 3: Başlangıç test süiti oluşturun, ardından gerçek senaryoları yazın

İşte Keploy'da sevdiğiniz hızın bir kısmını geri kazandığınız yer. Apidog'un yapay zeka destekli test durumu oluşturma özelliği, içe aktarılan şemanızı ve uç noktalarınızı okur ve sizin için test durumları taslağını hazırlar: geçerli istekler, sınır değerleri ve spesifikasyona dayalı yaygın hata yanıtları. Bu güçlü bir başlangıç noktasıdır ve boş bir sayfadan hızlıca kurtulmanızı sağlar. Bunun araçlar arasında nasıl karşılaştırıldığını görmek isterseniz, en iyi yapay zeka test durumu oluşturucularının özeti bunu bağlamına oturtur.

İki dürüst not. Birincisi, yapay zeka tarafından hazırlanan durumlar (Apidog veya Keploy'da) insan onayı gerektirir. Çıktıyı bir taslak olarak değerlendirin, uygulanmayanları budayın ve onaylamaları sıkılaştırın. İkincisi, bu, çalışma zamanı davranışından değil, bir spesifikasyondan oluşturmadır, bu nedenle yalnızca gerçek üretim verileri altında ortaya çıkan bir garipliği bilemez. İşte tam da bu boşluğu Keploy'un yakalama özelliği dolduruyordu ve tasarlanmış testlere geçtiğinizde kabul ettiğiniz boşluk budur.

Sonra önemli senaryoları yazarsınız. Bir senaryo, istekleri gerçek bir akışa bağlar: bir kullanıcı oluştur, dönen token ile giriş yap, profili getir, güncelle, sil. Durum kodları, yanıt alanları ve verilerin bir adımdan diğerine nasıl taşındığı konusunda iddialarda bulunursunuz. Bu, Keploy'un bir kaydın içinde örtük olarak yaptığı iştir. Bunu açıkça yapmak başlangıçta daha fazla çaba gerektirir ve birisi testi daha sonra okuduğunda, incelediğinde veya değiştirdiğinde her zaman karşılığını verir. Yapay zeka yardımıyla test durumları nasıl yazılır kılavuzu, oluşturma ile elle yazmayı dengelemenize yardımcı olur.

Adım 4: Ortamları ve veri odaklı girdileri ayarlayın

Bir kayıt, tek bir çalıştırmadan gelen bir değer kümesini taşır. Yazılan testler, herhangi bir veri kümesiyle herhangi bir ortama karşı çalışmalıdır.

Apidog'da kendi temel URL'leri, token'ları ve değişkenleriyle ortamları (yerel, hazırlık, üretim) tanımlayın. Çalışma zamanında -e ile birini seçersiniz. Test verileri için bir CSV veya JSON dosyası ekleyin ve Apidog, her senaryoyu satır başına bir kez çalıştırır, böylece tek bir giriş senaryosu bir düzine kimlik bilgisi kombinasyonunu kapsar. Dosyayı -d ile işaret edersiniz. Veri odaklı test kılavuzu, dosya formatlarını ve değişken bağlamayı ayrıntılı olarak gösterir.

apidog run \
  --access-token "$APIDOG_ACCESS_TOKEN" \
  -i 123456 \
  -e "staging" \
  -d ./test-data/login-cases.csv

Bu, sabit bir kayda göre somut bir yükseltmedir. Test verileriniz, sahip olduğunuz, çekme isteklerinde incelediğiniz ve yeni kenar durumları ortaya çıktıkça genişlettiğiniz bir dosyadır.

Adım 5: CI'da apidog run ile çalıştırın

Boru hattınızda keploy test yerine geçen komut apidog run'dır. Yazdığınız senaryoları yürütür, seçilen ortamı ve veri dosyasını uygular ve raporlar yayar. CLI, HTML ve JSON çıktısı üretebilir ve paylaşılabilir bir bağlantı için --upload-report ile sonuçları buluta yükleyebilirsiniz.

apidog run \
  --access-token "$APIDOG_ACCESS_TOKEN" \
  -i 123456 \
  -e "staging" \
  -r html,cli \
  --upload-report

Bunu boru hattınıza bağlamak, herhangi bir CI test adımıyla aynı şekildedir: CLI'yi kurun, token'ınızı ve senaryo kimliğinizi geçin, sıfır olmayan bir çıkışta derlemeyi başarısız yapın. CI/CD boru hattı kılavuzu ve GitHub Actions rehberi tam YAML'ı kapsar ve test raporları kılavuzu ekibinizin gerçekten bakacağı çıktıyı nasıl okuyacağınızı açıklar.

Adım 6: Kontrol ettiğiniz taklit sunucuları oluşturun

Keploy, kayıt sırasında bağımlılık trafiğini yakalayarak size ücretsiz taklitler sunar. Apidog diğer yolu izler: takliti siz tasarlarsınız. Şemanızı zaten içe aktardığınız için, Apidog bundan bir taklit sunucu oluşturabilir, alan tiplerine ve belirlediğiniz kurallara göre gerçekçi örnek yanıtlar döndürebilir. Gecikmeyi, hata durumlarını ve tam yükleri siz belirlersiniz.

Takas, bu rehberin her yerindekiyle aynıdır. Yakalanan taklitler, bağımlılıklarınızın gerçekten ne yaptığını yansıtır; tasarlanmış taklitler ise onların ne yapması gerektiğine karar verdiğiniz şeyi yansıtır. Sözleşme testi ve kararlı CI için, tasarlanmış taklitler genellikle kazanır çünkü üretimle sürüklenmezler. Daha derinlemesine bilgi edinmek isterseniz, sözleşme testi ve taklit araçları ile OpenAPI şemalarından taklit veri oluşturma makalelerine bakın.

Neyi saklarsınız ve neden vazgeçersiniz

Bu geçişin her iki tarafı hakkında ekibinizle dürüst olun.

Otomatik yakalamadan vazgeçiyorsunuz. Gerçek trafiği izleyen keploy record yok, üretim çalıştırmalarından türetilen bağımlılık taklitleri yok, sıfır kod gerektiren eBPF sihri yok. Eğer bu yetenek sizin için taşıyıcı bir yükse, bunun için Keploy'u araç kutusunda tutun. İki araç bir arada var olabilir.

Belgeleme gibi okunabilen testler, bir bayrakla değiştirebileceğiniz ortamlar, sahip olduğunuz ve gözden geçirebileceğiniz test verileri, tasarladığınız taklit sunucuları ve tasarım, hata ayıklama, belgeler ve test için tek bir platform kazanırsınız. Maliyet gerçektir (yazma, kaydetmekten daha fazla çaba gerektirir) ve getirisi tüm ekibinizin üzerinde hareket edebileceği sürdürülebilirliktir. API test otomasyon araçlarının daha geniş anketi bu tavizleri bağlamına oturtur ve Apidog ile bir API nasıl test edilir iyi bir pratik okumadır.

İki aracı yan yana değerlendiriyorsanız, Apidog vs Keploy karşılaştırması bunu özellik özellik ayırır ve eğer Keploy özellikle ekibinize uymuyorsa, en iyi Keploy alternatifi özeti bakmaya değer.

Sıkça Sorulan Sorular

Apidog mevcut Keploy kayıtlarımı içe aktarabilir mi? Doğrudan hayır. Keploy kayıtları çalışma zamanı yakalamalarıdır ve Apidog API spesifikasyonlarından çalışır. Pratik yol, API yüzeyinizi OpenAPI (veya Postman/cURL) olarak yakalamak ve bunu içe aktarmaktır. Hangi uç noktaların kapsanacağını gösteren bir kontrol listesi olarak Keploy kayıtlarınızı kullanın.

Apidog, Keploy gibi canlı trafiği kaydeder ve veritabanımı otomatik olarak taklit eder mi? Hayır. Apidog, eBPF aracılığıyla trafiği yakalamaz ve gerçek çalıştırmalardan bağımlılık taklitlerini otomatik olarak oluşturmaz. Bu, Keploy'un belirgin gücüdür. Apidog, şemanızdan testler ve taklitler oluşturur ve siz bunun üzerine senaryolar yazarsınız.

keploy record ve keploy testin yerine ne geçiyor? record eşdeğeri yoktur. Bunun yerine bir spesifikasyon içe aktarırsınız, yapay zeka ile başlangıç süiti oluşturursunuz, senaryolar yazarsınız ve keploy test yerine apidog run ile çalıştırırsınız.

Keploy'dan geçiş yapmak için ekstra yazım çabasına değer mi? Eğer okunabilir, çekme isteklerinde incelenebilir ve tüm ekip tarafından sahiplenilebilen testler istiyorsanız evet. Temel ihtiyacınız, bağımlılık taklitleri de dahil olmak üzere gerçek çalışma zamanı davranışının sıfır çaba ile yakalanmasıysa, Keploy bunu hala daha iyi yapar, bu yüzden o iş için onu saklayın.

İki aracı aynı anda çalıştırabilir miyim? Evet. Birçok ekip, yakalama tabanlı regresyon kontrolleri için Keploy'u ve tasarlanmış uçtan uca süitler, belgeler ve taklitler için Apidog'u kullanır. Farklı sorunları çözerler.

Nereden başlamalı

Bir hizmet seçin. OpenAPI spesifikasyonunu dışa aktarın, Apidog'a aktarın, yapay zekanın birkaç test durumu taslağını hazırlamasına izin verin, ardından bir ortam ve küçük bir veri dosyasıyla bir gerçek senaryo yazın. apidog run ile çalıştırın ve CI'ya bağlayın. Bu döngü iyi hissettirdiğinde, dışa doğru genişleyin. Kaydetmenin kolaylığını, tüm ekibinizin okuyabileceği, değiştirebileceği ve güvenebileceği testlerle takas edeceksiniz. CLI'nin kendisine daha derinlemesine bakmak için, kurulum kılavuzu ve komut satırı REST API test rehberi ile başlayın.