Güncelleme Yöntemleri
Apinizer sürüm yükseltme işlemi, Kubernetes worker sunucularının internete erişim durumuna göre iki farklı yöntemle gerçekleştirilebilir:Çevrim İçi Güncelleme
- Kubernetes worker sunucuları internete erişebiliyorsa
- Hızlı ve kolay güncelleme yapmak istiyorsanız
- İmaj transferi için ekstra adımlar atmak istemiyorsanız
Çevrim Dışı Güncelleme
.tar dosyası olarak kaydedilir veya yerel bir registry’ye yüklenir.Ne Zaman Kullanılır:- Kubernetes worker sunucuları internete erişemiyorsa
- Güvenlik politikaları nedeniyle doğrudan internet erişimi kısıtlanmışsa
- Yerel bir Docker registry (Nexus, Harbor vb.) kullanılıyorsa
- Manuel İmaj Transferi
- Yerel Registry Kullanımı
1) MongoDB Yedeğinin Alınması
Güncelleme işleminden önce veri kaybını önlemek için MongoDB yedeği alınır. Bu komut MongoDB sunucusu üzerinde çalıştırılır.2) Apinizer Uygulamalarının Güncellenmesi
Sistem, temel olarak apimanager (2025.11.0 ve öncesi sürümlerde manager), worker ve cache uygulamalarından oluşur. Lisans kapsamına bağlı olarak integration ve apiportal (2025.04.5 ve öncesi sürümlerde portal) uygulamaları da bulunabilir. Güncel sürüm bilgilerine Docker Hub adresinden veya sürüm notları sayfasından erişilebilir.Güncelleme Stratejisi ve Kesinti Riski
Güncelleme sırasında trafik kesintisi riski; pod sayısı, güncelleme stratejisi ve sunucu kaynaklarının uygunluğu gibi faktörlere bağlı olarak değişkenlik gösterebilir.Replica/Pod Sayısı
Güncelleme Stratejisi
Sunucu Kaynakları
2.1) Apinizer’ın Çevrimiçi Güncellenmesi
2.1.1) Apinizer Api Manager Güncellenmesi
Bu ve sonraki adımlardaki komutlar, Kubernetes Control Plane görevine sahip sunucular üzerinde çalıştırılır.Deployment bilgilerini kontrol edin
Api Manager deployment imajını güncelleyin
Pod durumunu takip edin
2.1.2) Apinizer Worker ve Cache Güncellenmesi
Apinizer Api Manager imajının güncellendiğinden emin olduktan sonra Apinizer Worker ve Cache uygulamaları güncellenir.Worker ve Cache deployment imajlarını güncelleyin
Pod durumunu takip edin
2.1.3) Apinizer Portal ve Integration Güncellenmesi
Apinizer Portal ve Integration benzer şekilde güncellenebilir.Portal ve Integration deployment imajlarını güncelleyin
Pod durumlarını takip edin
2.2) Apinizer’ın Çevrimdışı Güncellenmesi
Kubernetes ortamlarında güncelleme yapmayı gerektiren offline sistemler için iki ana yöntem kullanılabilir:Manuel İmaj Transferi
Yerel Registry Kullanımı
2.2.1) Online Sunucudan İmajların Çekilmesi ve Offline Sunuculara Aktarılması
İnternete ve offline makinelere erişimi olan bir makine varsa aşağıdaki adımlar gerçekleştirilebilir.2.2.1.1) Docker Kullanımı
2.2.1.2) Containerd Kullanımı
2.2.2) Yerel İmaj Registry ya da Repository Kullanımı
Farklı imaj registry ve repository’leri farklı yöntemlerle çalışsa da çoğunda çekilen imajlar tag’lenerek uygulamaya gönderilmelidir.2.2.2.1) Docker Kullanımı
2.2.2.2) Containerd Kullanımı
2.2.3) Apinizer Api Manager Güncellenmesi
Bu ve sonraki adımlardaki komutlar, Kubernetes Control Plane görevine sahip sunucular üzerinde çalıştırılır.Deployment bilgilerini kontrol edin
Api Manager deployment imajını güncelleyin
Pod durumunu takip edin
2.2.4) Apinizer Worker ve Cache Güncellenmesi
Apinizer Api Manager imajının güncellendiğinden emin olduktan sonra Apinizer Worker ve Cache uygulamaları güncellenir.Worker ve Cache deployment imajlarını güncelleyin
Pod durumunu takip edin
2.2.5) Apinizer Portal ve Integration Güncellenmesi
Apinizer Portal ve Integration benzer şekilde güncellenebilir.Portal ve Integration deployment imajlarını güncelleyin
Pod durumlarını takip edin
3) Apinizer Uygulama Güncellemelerinin Geri Alınması
Apinizer uygulamalarında sürüm düşürülmesi desteklenmemektedir. Ancak güncellenen bir sürüm veritabanı yedekleri varsa geri alınabilir.3.1) MongoDB Veritabanı Geri Yükleme
Bu işlemin öncesinde Api Manager uygulamasının kubernetes üzerinde CrashLoopBackOff hatası ile yeniden başlatılma döngüsünde olmadığı teyit edilmelidir. En güvenli yöntem için Api Manager uygulaması replica sayısı 0’a indirilerek durdurulmalıdır.Api Manager'ı durdurun
MongoDB yedeğini geri yükleyin
--drop parametresi kullanılabilir. Bu sadece yedek dosyasında karşılığı olan koleksiyonları drop edecek ve yüklemeyi sonrasında gerçekleştirmeyi sağlayacaktır.3.2) Api Manager Uygulamasının Sürümünün Geri Alınması
Api Manager deployment imajını eski sürüme döndürün
Replica sayısını 1'e çekin
Pod durumunu takip edin
3.3) Diğer Uygulamaların Sürümünün Geri Alınması
Api Manager uygulaması çalışır hale geldiğinde diğer uygulamalar birlikte eski sürüme döndürülebilir.Deployment imajlarını eski sürüme döndürün
Pod durumlarını kontrol edin

