API Mapping Oluşturma
Mapping Listesi
Mapping listesinde tüm tanımlı eşleştirmeleri görebilirsiniz. Liste aşağıdaki filtreleme seçeneklerini sunar:
- Kaynak Instance / Proje / API: Belirli bir kaynağa göre filtreleme
- Hedef Instance / Proje / API: Belirli bir hedefe göre filtreleme
- Durum: Taslak, Uyarı veya Hazır durumuna göre filtreleme
Her mapping satırında kaynak ve hedef bilgileri, ortam değişkeni durumu (eksik değişken sayısı) ve son çalışma zamanı gösterilir.
Mapping Sihirbazı
Yeni bir mapping oluşturmak için Yeni Mapping butonuna tıkladığınızda çok adımlı bir sihirbaz açılır. Sihirbaz, seçtiğiniz promotion tipine göre farklı adımlar sunar.
Oluştur butonu (ve düzenleme ekranındaki Kaydet butonu), gerekli tüm alanlar (Promotion Tipi, Kaynak/Hedef Instance, Kaynak/Hedef Proje, Kaynak API ve Mapping Adı) doldurulup geçerli bir seçim yapılana kadar pasif kalır. Buton pasif durumdayken herhangi bir mapping kaydı oluşturulmaz — kayıt yalnızca buton aktif hale geldiğinde ve tıklandığında gerçekleşir. Düzenleme ekranındaki Kaydet butonu, ayrıca tüm bağımlılıklar (bkz. Global Politika ve Sertifika Eşlemesi) eşlenip/oluşturulana ve hedef API tanımlanana kadar da pasif kalır.
Adım 1: Genel Bilgi & Variables
Bu adımda temel yapılandırma bilgilerini girersiniz:
Promotion Tipi Seçimi
İlk olarak ne aktarmak istediğinizi seçin:
| Tip | Açıklama |
|---|---|
| API Proxy | Tek bir API Proxy aktarımı. Creator bağımlılıkları otomatik tespit edilir |
| DB-2-API | DB-2-API Creator tanımını bağımsız olarak aktarma |
| Script-2-API | Script-2-API Creator tanımını bağımsız olarak aktarma |
| Mock API | Mock API Creator tanımını bağımsız olarak aktarma |
| Proxy Group | Proxy Group'u tüm içeriğiyle birlikte aktarma |
Kaynak ve Hedef Tanımı
Promotion tipini seçtikten sonra kaynak ve hedef bilgilerini belirleyin:
- Kaynak Instance ve Kaynak Proje seçin
- Hedef Instance ve Hedef Proje seçin
- Kaynak API'yi seçin
Kaynak ve hedef instance aynı ortamı gösteriyorsa bir uyarı mesajı görüntülenir.
Bağımlılık Tespiti (API Proxy Tipinde)
Kaynak API seçildiğinde sistem, API'nin oluşturulma tipini analiz eder ve gerekli bağımlılıkları otomatik olarak gösterir:
- Manuel oluşturulan API Proxy: Bağımlılık yoktur, sadece proxy tanımı taşınır
- DB-2-API ile oluşturulan API Proxy: Creator + Veritabanı Bağlantısı zorunlu olarak birlikte taşınır
- Script-2-API ile oluşturulan API Proxy: Creator zorunlu olarak birlikte taşınır
- Mock API ile oluşturulan API Proxy: Creator zorunlu olarak birlikte taşınır
Bağımlılıklar sıralı adımlar halinde tamamlanır. Her adım, bir önceki tamamlandıktan sonra aktif olur.
Global Politika ve Sertifika Eşlemesi
Bağımlılık tespiti yalnızca creator nesneleriyle sınırlı değildir: kaynak API Proxy veya Proxy Group tanımında kullanılan Global Politikalar ve sertifika ailesi kayıtları (Certificate, KeyStore, CryptoKeyInfo, JWK — bkz. Gizlilik Yönetimi) de otomatik olarak taranır ve listelenir.
Her bağımlılık satırı için iki seçenek sunulur:
- Hedefte mevcut bir kayıtla eşle: Aynı tipteki (Global Politika) veya aynı türdeki (Sertifika) hedef kayıt açılır listeden seçilir. Anahtar/isim eşleşmesi bulunduğunda bu eşleme otomatik olarak önerilir
- Oluştur: Kaynaktaki tanımdan hedef ortamda doğrudan yeni bir kayıt oluşturulur
Her satırda durum bilgisi gösterilir: Eşlendi, Oluşturuldu veya Bekliyor. Bölümün üstünde toplam, tamamlanan ve bekleyen bağımlılık sayıları özetlenir.
Sertifika bağımlılıkları, içerdikleri gizli veriler (secret) ortamlar arasında otomatik taşınamadığından yalnızca bu adımda eşlenebilir veya oluşturulabilir — çalıştırma sırasında otomatik olarak oluşturulmazlar. Bekleyen bir bağımlılık varken mapping kaydedilemez.
Bu eşleme mantığı, Export Import sihirbazındaki "mevcutla eşleştir / yeni oluştur" mantığıyla örtüşür.
Hedef API Seçimi
Hedef ortamda iki seçeneğiniz vardır:
- Mevcut API Güncelle: Hedef projeden mevcut bir API seçin. API'nin mevcut yapılandırması kaynak ortamdan gelen değerlerle değiştirilir
- Yeni API Oluştur: Hedef ortamda kaynak API'den yeni bir API oluşturun
Mevcut bir API'yi güncelleme seçeneğinde, hedef API'nin mevcut yapılandırması kaynak ortamdan gelen değerlerle değiştirilecektir. Bu işlem geri alınamaz.
Hedef ortamda karşılık gelecek bir API yoksa Kaynaktan Oluştur butonu ile kaynak API'den otomatik olarak hedef ortamda yeni bir API oluşturabilirsiniz.
Proxy Group Senaryosu
Proxy Group seçildiğinde, grup içindeki tüm proxy'ler listelenir. Her proxy için hedef eşleştirme yapılmalıdır:
- Taşıma sırası: Önce grup ayarları (CORS, kimlik doğrulama, hız limiti, client route), ardından her bir proxy ve bağımlılıkları sırayla taşınır
- Creator tabanlı proxy'lerde Creator + Bağlantı zorunludur
- Manuel proxy'lerde sadece proxy tanımı taşınır
Deployment Ortamları
Hedef instance üzerinde API'nin hangi ortamlara deploy edileceğini seçebilirsiniz.
Adım 2: API Proxy Karşılaştırma
Bu adımda kaynak ve hedef API yapılandırmaları arasındaki farklar görüntülenir.
Fark Özeti
Karşılaştırma sonucunda aşağıdaki bilgiler gösterilir:
- Toplam fark sayısı
- Değiştirilen alanlar: Hem kaynakta hem hedefte mevcut ancak değerleri farklı olan alanlar
- Eklenen alanlar: Kaynakta var, hedefte olmayan alanlar (hedef ortama eklenecek)
- Silinen alanlar: Hedefte var, kaynakta olmayan alanlar (hedef ortamdan kaldırılacak)
Find & Replace Kuralları
API tanımındaki belirli alanları veya değerleri aktarım sırasında otomatik olarak değiştirmek için kurallar tanımlayabilirsiniz. Her kural bir Bul ve bir Değiştir değerinden oluşur.
Kurallar JSONPath ifadesi veya düz metin olarak tanımlanabilir:
- JSONPath örneği:
$.routing.routingAddressWrapperList[0].address→ Backend URL'ini değiştirir - Düz metin: Belirli bir metin değerini başka bir değerle değiştirir
Find & Replace kuralları yalnızca hedef API nesnesi üzerinde uygulanır. Bağımlı nesneler (bağlantı, creator, grup proxy) bu kurallardan etkilenmez.
Hariç Tutulan Alanlar
Karşılaştırma ve aktarım sırasında belirli alanları hariç tutabilirsiniz. İki tür hariç tutulan alan vardır:
- Sistem Varsayılanları (değiştirilemez): Kimlik numarası, oluşturma/güncelleme tarihi, kullanıcı bilgisi gibi ortama özgü alanlar otomatik olarak hariç tutulur
- Kullanıcı Tanımlı Alanlar: Ek olarak hariç tutmak istediğiniz alanları kendiniz ekleyebilirsiniz
Adım 3: Variables Mapping
Kaynak API'de kullanılan ortam değişkenlerinin hedef ortamdaki karşılıkları bu adımda eşleştirilir.
Sistem, kaynak API'deki ortam değişkenlerini otomatik olarak tespit eder ve hedef ortamda aynı anahtarla tanımlı değişkenleri otomatik eşleştirir. Her değişken için durum bilgisi gösterilir:
- Mevcut: Hedef ortamda aynı anahtarla tanımlı bir değişken var
- Eksik: Hedef ortamda bu anahtarla tanımlı bir değişken bulunamadı
Hedef ortamda eksik ortam değişkenleri varsa, aktarım öncesinde bu değişkenlerin hedef ortamda tanımlanması önerilir.
Değişkenler arasında filtreleme yapabilirsiniz: Tümü, Mevcut veya Eksik.
Adım 4: Ön Kontrol (Pre-Flight Check)
Aktarım öncesinde yapılandırmanın eksiksiz olduğunu doğrulamak için ön kontroller çalıştırabilirsiniz. Kontroller üç kategoride yapılır:
| Kategori | Kontroller |
|---|---|
| Sistem Kontrolleri | Hedef ortam bağlantısı, erişilebilirlik |
| Konfigürasyon Kontrolleri | API versiyon çakışması, proje mevcudiyeti |
| Güvenlik Kontrolleri | Yetki doğrulama, token geçerliliği |
Her kontrol sonucu Başarılı, Uyarı veya Hata olarak raporlanır.
Adım 5: Summary & Done
Son adımda tüm yapılandırmanın özeti görüntülenir:
- Instance bilgileri (kaynak ve hedef)
- Mapping bilgileri (API eşleştirmesi)
- Ortam değişkenleri durumu
- Find & Replace kuralları
- Hariç tutulan alanlar
- Bağlantı durumu
Özeti inceledikten sonra Tamamla butonu ile mapping'i kaydedebilirsiniz.
Mapping Görüntüleme ve Düzenleme
Kaydedilmiş bir mapping'in detaylarını görüntüleyebilir ve düzenleyebilirsiniz. Mapping detay ekranında:
- Kaynak ve hedef bilgilerini görebilirsiniz
- Ortam değişkeni eşleştirmelerini güncelleyebilirsiniz
- Find & Replace kurallarını düzenleyebilirsiniz
- Karşılaştırma sonuçlarını yenileyebilirsiniz
- Mapping'i çalıştırabilirsiniz
Mapping Klonlama
Mevcut bir mapping'i klonlayarak benzer yapılandırmayı farklı bir API veya ortam için hızlıca oluşturabilirsiniz.