Ortam Stratejisi
Instance Tipleri ile Ortam Ayrımı
Her ortam için uygun instance tipini seçin. Bu hem görsel ayrım sağlar hem de onay mekanizmasını doğru seviyede uygulamanıza yardımcı olur.| Ortam | Önerilen Instance Tipi | Onay Gerekli mi? |
|---|---|---|
| Development | Development | Hayır |
| Test | Test | Hayır veya Opsiyonel |
| Staging | Staging | Evet |
| Production | Production | Evet |
Aşamalı Aktarım
API’lerinizi doğrudan Development’tan Production’a aktarmak yerine aşamalı bir yaklaşım izleyin:Ortam Değişkeni Yönetimi
Tutarlı Değişken İsimlendirme
Tüm ortamlarda aynı değişken anahtarlarını kullanın. Otomatik eşleştirme, anahtar adlarının birebir eşleşmesine dayanır. Doğru yaklaşım:- Development:
BACKEND_URL = https://dev-api.example.com - Production:
BACKEND_URL = https://api.example.com
- Development:
DEV_BACKEND_URL = https://dev-api.example.com - Production:
PROD_BACKEND_URL = https://api.example.com
Eksik Değişken Kontrolü
Mapping oluştururken ortam değişkeni eşleştirme adımında eksik değişkenleri kontrol edin. Hedef ortamda eksik değişken varsa, aktarım öncesinde bu değişkenleri hedef ortamda tanımlayın.Find & Replace Kuralları
Ne Zaman Kullanılmalı?
Find & Replace kurallarını, ortam değişkenleriyle yönetilmeyen ancak ortamlar arasında farklılık gösteren değerler için kullanın:- Backend adresleri (ortam değişkeni kullanılmıyorsa)
- Sertifika referansları
- Zaman aşımı değerleri
- Ortama özgü yapılandırma parametreleri
JSONPath ve Düz Metin
- JSONPath: Belirli bir yapılandırma alanını hedeflemek için kullanın. Daha kesin ve güvenlidir
- Düz metin: API tanımı genelinde bir metin değerini değiştirmek için kullanın. Beklenmedik yerlerdeki eşleşmelere dikkat edin
Ön Kontrol (Pre-Flight Check)
Her Aktarım Öncesinde Çalıştırın
Ön kontroller, aktarım öncesinde olası sorunları tespit etmenizi sağlar. Özellikle:- Hedef ortam bağlantısının aktif olduğunu doğrular
- API versiyon çakışmalarını kontrol eder
- Yetki sorunlarını önceden tespit eder
Uyarıları Görmezden Gelmeyin
Ön kontrol sonucunda Uyarı durumundaki maddeler, aktarımı engellemez ancak potansiyel sorunlara işaret eder. Bu uyarıları değerlendirip gerekli düzeltmeleri yapmanız önerilir.Onay Akışı
Onaylayıcı Seçimi
- Production ortamı için en az iki onaylayıcı tanımlayın
- Onaylayıcıları, hedef ortamın sorumluları arasından seçin
Bildirim Alıcıları
- Çalıştırma durumundan haberdar olması gereken kişileri bildirim alıcısı olarak ekleyin
- Özellikle başarısız çalıştırmalarda hızlı müdahale için e-posta bildirimleri yapılandırın
Genel Öneriler
Mapping'leri güncel tutun
Mapping'leri güncel tutun
Kaynak API’de değişiklik yapıldığında, mapping’in karşılaştırma sonuçlarını yenileyerek farkları gözden geçirin. Bu sayede beklenmedik değişikliklerin hedef ortama aktarılmasını önlersiniz.
Çalıştırma geçmişini takip edin
Çalıştırma geçmişini takip edin
Çalıştırma listesindeki istatistikleri düzenli olarak kontrol edin. Başarısız çalıştırmaların nedenlerini araştırın ve tekrarlayan hataları ortadan kaldırın.
Hariç tutulan alanları doğru yapılandırın
Hariç tutulan alanları doğru yapılandırın
Ortama özgü alanları (kimlik numaraları, tarihler, kullanıcı bilgileri) hariç tutun. Sistem varsayılanları çoğu durumu karşılar, ancak özel alanlarınız varsa bunları kullanıcı tanımlı alan olarak ekleyin.
Proxy Group aktarımlarında dikkatli olun
Proxy Group aktarımlarında dikkatli olun
Proxy Group aktarımı, grup içindeki tüm proxy’leri ve bağımlılıkları kapsar. Büyük gruplarda aktarım süresi uzayabilir. Grupları parçalara ayırmak yerine, bütünlüğü korumak için tek seferde aktarmayı tercih edin.
Bağlantı sağlığını izleyin
Bağlantı sağlığını izleyin
Instance listesindeki sağlık durumlarını düzenli kontrol edin. Sorunlu bir instance’a yapılacak aktarım başarısız olacaktır.