Helm ile Apinizer Kurulumu
Bu doküman, Kubernetes ortamına Helm kullanarak Apinizer kurulumunun temel adımlarını anlatmaktadır.
Apinizer, kurulumu sırasında MongoDB'ye ihtiyaç duyar. Eğer bir MongoDB kurulu değilse öncelikle onun kurulması gerekmektedir.
Ön Koşullar
Kubernetes cluster’ınızın hazır ve erişilebilir olması
Helm’in ortamınızda kurulu olması
- MongoDB uygulamasının kurulu olması
Eğer helm kurulu değilse, Helm Kurulum Dokümanı sayfasını inceleyebilirsiniz.
1) Reponun Eklenmesi
Helm’e apinizer chart reposu eklenir.
helm repo add apinizer-charts https://apinizer1.github.io/apinizer-charts
helm repo update2) Apinizer Kurulumu
Aşağıdaki komutu çalıştırarak herhangi bir özel ayar yapmadan Apinizer kurulumunu gerçekleştirebilirsiniz:
helm install apinizer-charts apinizer-charts/apinizerNot: Mevcut kurulumda Apinizer 2025.07.0 sürümü kullanılmaktadır. Tüm Apinizer sürümlerini Docker Hub üzerinden inceleyebilirsiniz.
Opsiyonel Parametreler
| Seçenek | Varsayılan Değer | Açıklama |
|---|---|---|
| image.manager | apinizercloud/manager:2025.07.0 | Apinizer manager imajının sürümünü belirtir. |
| image.worker | apinizercloud/worker:2025.07.0 | Apinizer worker imajının sürümünü belirtir. |
| image.cache | apinizercloud/cache:2025.07.0 | Apinizer cache imajının sürümünü belirtir. |
| mongoDB.hostNames[0] | mongo-db-0.mongo-service.mongo.svc.cluster.local | MongoDB’yi Helm ile kurduysanız, bu değer varsayılan olarak kullanılmalı ve değiştirilmemelidir. Kendi MongoDB’nizi kullanmak istiyorsanız, bu değeri ihtiyacınıza uygun şekilde değiştirebilirsiniz. |
| mongoDB.username | Helm ile MongoDB kurulumu yapıldıysa: kubectl get secret -n mongo mongodb-secret -o jsonpath="{.data.MONGO_ROOT_USERNAME}" | base64 --decode; echo | MongoDB’yi Helm ile kurduysanız, bu değer varsayılan olarak kullanılmalı ve değiştirilmemelidir. Kendi MongoDB’nizi kullanmak istiyorsanız, bu değeri ihtiyacınıza uygun şekilde değiştirebilirsiniz. |
| mongoDB.password | Helm ile MongoDB kurulumu yapıldıysa: kubectl get secret -n mongo mongodb-secret -o jsonpath="{.data.MONGO_ROOT_PASSWORD}" | base64 --decode; echo | MongoDB’yi Helm ile kurduysanız, bu değer varsayılan olarak kullanılmalı ve değiştirilmemelidir. Kendi MongoDB’nizi kullanmak istiyorsanız, bu değeri ihtiyacınıza uygun şekilde değiştirebilirsiniz. |
| mongoDB.dbName | apinizerdb | MongoDB’yi Helm ile kurduysanız, bu değer varsayılan olarak kullanılmalı ve değiştirilmemelidir. Kendi MongoDB’nizi kullanmak istiyorsanız, bu değeri ihtiyacınıza uygun şekilde değiştirebilirsiniz. |
| mongoDB.authSource | admin | MongoDB’yi Helm ile kurduysanız, bu değer varsayılan olarak kullanılmalı ve değiştirilmemelidir. Kendi MongoDB’nizi kullanmak istiyorsanız, bu değeri ihtiyacınıza uygun şekilde değiştirebilirsiniz. |
| mongoDB.port | 25080 | MongoDB’yi Helm ile kurduysanız, bu değer varsayılan olarak kullanılmalı ve değiştirilmemelidir. Kendi MongoDB’nizi kullanmak istiyorsanız, bu değeri ihtiyacınıza uygun şekilde değiştirebilirsiniz. |
| environment.deploy | true | Bu değer, Apinizer'da bir environment oluşturulmasını ve deploy edilmesini sağlar. Eğer environment oluşturulmasını istemiyorsanız, bu değeri |
| ns.namespace | prod | Apinizer, environment eklemesi yaparken belirtilen namespace altında çalışır. |
| access.url | apigateway.apinizer.com | Varsayılan olarak, bu değer environment'ların Access URL alanına eklenir. Helm kurulumu sırasında kendi DNS adresinizi veya IP adresinizi belirtebilir; ayrıca kurulum sonrasında arayüz üzerinden kolayca güncelleyebilirsiniz. |
Apinizer bileşenlerini kurarken aşağıdaki opsiyonel parametrelerin örnek kullanımı ile MongoDB bağlantı bilgileri ve environment deploy durumu belirtilebilir:
helm install apinizer-charts apinizer-charts/apinizer \
--set mongoDB.hostNames[0]=<mongo-hostname0> \
--set mongoDB.hostNames[1]=<mongo-hostname1> \
--set mongoDB.hostNames[1]=<mongo-hostname2> \
--set mongoDB.username=<username> \
--set mongoDB.password=<passoword> \
--set mongoDB.port=<port> \
--set environment.deploy=<true|false>