Bu dokümanda yalnızca Apinizer’a özel yapılması gereken işlemler anlatılmaktadır. Kubernetes cluster ve Apinizer kurulumuna dair detaylar bu dokümanın kapsamında değildir ve ayrı bir dökümanda sunulmaktadır.
Kubernetes Namespace ve Kaynak Yönetimi Özelliğinin Kapatılması
Multi-region kurulumunda, Apinizer Manager Konsolu üzerinden Kubernetes namespace ve kaynak yönetimi özelliğinin devre dışı bırakılması gerekmektedir.
Apinizer arayüzünde “Enable the management of Kubernetes Namespace and Resources with Apinizer” ayarı devre dışı bırakıldığında, Apinizer artık Kubernetes üzerinde namespace ve kaynakları otomatik olarak oluşturmaz veya güncellemez.
Bu durumda:
- Kubernetes kaynaklarının (Deployment, Service, Secret, Role, vb.) yönetimi manuel olarak YAML dosyaları üzerinden gerçekleştirilmelidir.
- Bu yöntem, çoklu cluster yapılarında daha fazla esneklik ve kontrol sağlar ve Multi Region kurulumunu kolaylaştırır.
Administration menüsüne gidin
Apinizer Manager Konsolu’nda Administration menüsünü açın.
System Settings → General Settings sekmesini açın
System Settings altından General Settings sekmesine gidin.
Kubernetes yönetimini devre dışı bırakın
“Enable the management of Kubernetes Namespace and Resources with Apinizer” seçeneğini devre dışı bırakın (disable).
Değişiklikleri kaydedin
Yapılan değişiklikleri kaydedin.
Kubernetes Namespace ve Kaynak Yönetimi ayarı - General Settings sayfası
Ortam Oluşturma
Apinizer Manager Konsolu üzerinden multi-region yapılandırması için ortam oluşturulur. Bu işlem ile Apinizer’ın hangi ortam(namespace) ve hangi cluster’lara erişip yönetmesi gerektiği bilgisi tanımlanır.
Örnek olarak, prod isimli mevcut bir ortamın cluster’ına, farklı bir bölgede kurduğumuz yeni ortamı aşağıdaki adımlar ile tanımlayabilirsiniz.
Gateway Environments sayfasına gidin
Administration > Server Management > Gateway Environments sayfasını açın.Gateway Runtime'ları sayfası - Multi-region ortam yapılandırması
Gateway ve Cache Management API Access URLs tanımlayın
Gateway and Cache Management API Access URLs bölümünde yeni eklenen cluster’a ait Gateway ve Cache bileşenlerinin yönetim API erişim bilgilerini tanımlayın.Çok ÖnemliBu adımda her cluster için Apinizer Manager Konsolu tarafından erişilebilir Gateway ve Cache adresleri girilmelidir.
Gateway and Cache Management API Access URLs - Cluster erişim bilgileri
Erişimi test edin ve kaydedin
“Try it” butonunu kullanarak erişimin sağlandığını test edin. Erişim başarılı ise kaydedin.Try it butonu ile erişim testi - Bağlantı doğrulama
Cluster Bilgisinin YAML Dosyalarına Eklenmesi
Aynı ortama (namespace’e) ait fakat farklı coğrafi ortamda çalışan Apinizer Worker ve Cache uygulamalarına hangi cluster’a ait olduklarını belirtmek için aşağıdaki ayarın yapılması gerekmektedir. Bu ayar ile her bir worker’ın hangi cache’e bağlanacağı da belirlenmiş olur.
Her bir Worker Deployment tanımına aşağıdaki ortam değişkeni eklenmelidir:
spec:
containers:
env:
- name: environmentClusterName
value: <NAME>
Çok Önemli
<NAME> Worker’ın bağlanacağı Cache’in bulunduğu cluster’ı temsil eden isimdir.
- Bu isim, Apinizer arayüzünde Gateway Environments altında tanımlanan cluster adı ile birebir aynı olmalıdır.
- Her cluster’daki Worker bileşeni, yalnızca kendi bölgesinde bulunan Cache bileşeni ile iletişim kurar.
Sonraki Adımlar