CLI ile Bulut Veritabanı Bağlantı Konfigürasyonu ile Test Senaryoları Nasıl Çalıştırılır

Bulut Veritabanı Bağlantı Yapılandırmasını Kullanmanın Faydaları

Bulut veritabanı bağlantı yapılandırma işlevselliği tanıtılmadan önce, CLI aracılığıyla veritabanı işlemleri içeren bir test senaryosu çalıştırmak, birkaç zahmetli adımın tamamlanmasını gerektiriyordu:

1. Manuel Dışa Aktarma Süreci: Ürün arayüzünde veritabanı bağlantı yapılandırma dışa aktarma girişini bulun ve dosya olarak dışa aktarın
2. Dosya Yönetimi: Dışa aktarılan veritabanı bağlantı yapılandırma dosyasını CLI yürütme makinesine aktarın
3. Yol Yapılandırması: Makinedeki dosya yolunu kopyalayın
4. Komut Değişikliği: Komut satırı seçeneklerini gerçek yol değerleriyle güncelleyin, örneğin:

apidog run --access-token $APIDOG_ACCESS_TOKEN -t 123456 -e 123456 -n 1 -r html,cli --database-connection /Users/xxx/yyy/database-connections.json

Bu süreç çok sayıda hazırlık görevi içeriyordu ve veritabanı bağlantı yapılandırmasındaki herhangi bir değişiklik tüm bu adımların tekrarlanmasını gerektiriyordu. Genel kullanıcı deneyimi verimsiz ve sıkıcıydı.

Bulut veritabanı bağlantı yapılandırmasıyla, yapılandırma dosyalarını dışa aktarma, bunları CLI yürütme makinelerine aktarma ve komut satırlarında seçenek değerlerini manuel olarak belirtme ihtiyacını tamamen ortadan kaldırabilirsiniz. Başarılı bir şekilde çalıştırmak için bulut veritabanı bağlantı yapılandırmasındaki değişkenler için gerçek değerleri ayarlamanız yeterlidir, bu da kullanıcı deneyimini önemli ölçüde iyileştirir.

Yöntem 1: Yerel Değerler + Bulut Veritabanı Bağlantı Yapılandırması Kullanımı

Test senaryolarınızdaki tüm veritabanı bağlantıları bulutta kaydedilmiş yapılandırmaları kullandığında, veritabanı bağlantı yapılandırma dışa aktarma seçeneği görünmeyecektir (artık gerekli olmadığı için). CLI yürütme sırasında, sistem gerekli değişkenleri doğrudan bulut veritabanı bağlantı yapılandırmasından alabilir ve bağlantı kurmak için değişken değiştirme kurallarına göre gerçek değişken değerlerini bulabilir.

Adım Adım Uygulama:

Ortam Değişkenlerini Yapılandırın: Ortam yönetiminde, kullanmanız gereken her ortam için ilgili değişkenlerin yerel değerlerine gerçek veritabanı bağlantı değerlerini ayarlayın.

Değişken Tabanlı Yapılandırmayı Sağlayın: Veritabanı bağlantı yapılandırmanızın (portlar hariç) tamamen değişkenleri kullandığından ve bulut veritabanı bağlantısı olarak kaydedildiğinden emin olun.

Test Senaryosu Yapılandırmasını Doğrulayın: CLI aracılığıyla çalıştırmak istediğiniz tüm test senaryolarının "bulut veritabanı bağlantı yapılandırmasını" (yani, değişkenlerle kaydedilmiş yapılandırmaları) kullandığını onaylayın.

Yerel Değerleri Dışa Aktarın: CI/CD sayfasına gidin, Ortam/Genel Değişkenler altında "Kullanmak üzere yerel değerleri dışa aktar" seçeneğini seçin, ardından dışa aktar düğmesine tıklayın.

Dışa Aktarılan Dosyayı İnceleyin ve Değiştirin: Dışa aktarılan dosyada, veritabanı bağlantı yapılandırması tarafından kullanılan ortam değişkeni değerlerini göreceksiniz. Gerekirse bu değerleri dosyada manuel olarak değiştirebilirsiniz. Dosyayı CLI makinesine yerleştirin ve dosya yolunu kopyalayın.

CI/CD Komutunu Yapılandırın: CI/CD sayfasında, Erişim Token'ınızı girin, komutu kopyalayın ve değişken dosyasının gerçek yolunu seçenek değerine yapıştırın:

apidog run --access-token $APIDOG_ACCESS_TOKEN -t 123456 -e 123456 -n 1 -r html,cli --variables /Users/xxx/yyy/pptest_variables.json

Çalıştırın ve Doğrulayın: Yukarıdaki CLI komutunu çalıştırın. Veritabanı bağlantısı doğru çalışmalı ve başarıyla yürütülmelidir.

Sonuçları İnceleyin: Sonuç yazdırma yapılandırılmışsa, yüklenen rapor detaylarında veritabanı bağlantısı yürütme detaylarını görüntüleyebilirsiniz.

Önemli Hususlar:

⚠️ Güvenlik Notu: Yerel değerler, veri güvenliğini sağlamak için gerçek veritabanı bağlantı yapılandırmaları için hala yerel dosya depolama kullanır. Bağlantı yapılandırmalarını değiştirmeniz gerekirse, bu dosyadaki ilgili değişken değerlerini manuel olarak değiştirin.

⚠️ Uzak Değerler Uyarısı: Veritabanı bağlantı yapılandırma değişkenleri için uzak değerler kullanmak, yerel değer dosyalarını dışa aktarma ve ek komut satırı seçenekleri ekleme gibi fazladan işlemleri önleyebilir (ve Apidog istemcisinde uzak değerlerin doğrudan değiştirilmesine izin verirken), bu yaklaşım veri güvenliği riskleri taşır ve ❌ önerilmez.

⚠️ Düz Metin Kullanımı: Bağlantı yapılandırmanızda tamamen veya kısmen (port alanları hariç) düz metin kullanırsanız, yine de yapılandırma dosyalarını dışa aktarmanız ve komutlarda --database-connection aracılığıyla kullanmanız gerekecektir. Bu kullanım şekli ❌ önerilmez.

Yöntem 2: Kasa Değişkenleri + Bulut Veritabanı Bağlantı Yapılandırması Kullanımı

Ortam değişkeni uzak değerleri + Kasa değişkenlerini bulut veritabanı bağlantılarını sürdürmek için kullanıyorsanız ve bu bulutta kaydedilmiş bağlantıları CLI'da kullanmak istiyorsanız, şu adımları izleyin:

Adım Adım Uygulama:

Kasa Değişkenlerini Yapılandırın: Ortam yönetiminde, veritabanı bağlantı Kasa değişkenlerini ilgili değişkenlerin uzak değerlerine ayarlayın ve yerel değerleri uzak değerleri takip edecek şekilde tutun. Bunu kullanmanız gereken her ortam için yapılandırın.

Değişken Tabanlı Yapılandırmayı Sağlayın: Veritabanı bağlantı yapılandırmanızın (portlar hariç) tamamen değişkenleri kullandığından ve bulut veritabanı bağlantısı olarak kaydedildiğinden emin olun.

Test Senaryosu Yapılandırmasını Doğrulayın: CLI aracılığıyla çalıştırmak istediğiniz tüm test senaryolarının "bulut veritabanı bağlantı yapılandırmasını" (yani, değişkenlerle kaydedilmiş yapılandırmaları) kullandığını onaylayın.

CI/CD Ayarlarını Yapılandırın: CI/CD sayfasına gidin, Ortam/Genel Değişkenler altında "Uzak değerleri kullan" seçeneğini seçin, gerçek durumunuza göre yapılandırın, ardından CLI komutunu kopyalayın.

Kasa Değişkenlerini Ayarlayın: CLI çalıştırmanız gereken makinede, pipeline'ınızda veya terminalinizde, Kasa değişkenlerini gerçekten kullanmak için önce export APIDOG_VAULT_KEY=VALUE komutunu girin. Birden fazla Kasa değişkenini boşluklarla ayırın.

İşletim Sistemine Özel Sözdizimi:

CLI Komutunu Çalıştırın: Yürütmeyi başlatmak için CLI komutunuzu çalıştırın.

Sonuçları Doğrulayın: Tamamlandıktan sonra, raporda veritabanı bağlantı sonuçlarını görebilir, başarılı veritabanı bağlantısını ve işlem yürütmesini onaylayabilirsiniz.

Yürütme Detaylarını İnceleyin: Sonuç yazdırma yapılandırılmışsa, yüklenen rapor detaylarında veritabanı bağlantısı yürütme detaylarını görüntüleyebilirsiniz.

Kritik Hatırlatmalar:

⚠️ Yürütme Öncesi Gereklilik: Veritabanı bağlantıları için Kasa değişkenleri içeren CLI komutlarını yürütmeden önce, her zaman export/set kullanarak gerçek Kasa değişkeni değerlerini girin. Aksi takdirde, gerçek yapılandırmaları alamadığı için veritabanı bağlantıları başarısız olacaktır.

⚠️ Geçici Değişken Kapsamı: export/set aracılığıyla girilen Kasa değişkeni gerçek değerleri, yalnızca mevcut yürütme için geçerlidir ve geçici değişkenler gibi işlev görür. Sonraki çalıştırmalar için bunları bu yöntemle yeniden girmeniz gerekecektir.

Sonuç

Bulut veritabanı bağlantı yapılandırması, manuel dosya yönetimini ortadan kaldırarak ve yapılandırma karmaşıklığını azaltarak CLI test iş akışını önemli ölçüde kolaylaştırır. İster yerel değerler ister Kasa değişkenleri kullanılsın, bu yaklaşım CI/CD ortamlarında veritabanına bağlı test senaryolarını çalıştırmak için daha güvenli, verimli ve sürdürülebilir bir çözüm sunar.

Güvenlik gereksinimlerinize ve operasyonel tercihlerinize en uygun yöntemi seçin:

• Yerel Değerler: Yerel dosya kontrolü ile maksimum veri güvenliği gerektiren senaryolar için daha iyidir
• Kasa Değişkenleri: Merkezi sır yönetimi ile otomatik CI/CD pipeline'ları için idealdir

Her iki yaklaşım da modern test iş akışları için gereken esnekliği ve verimliliği sağlarken veritabanı bağlantılarınızın güvenli kalmasını sağlar.