Healthcheck ve Sürüm Adresleri
Genel Yaklaşım
Apinizer modüllerinin healthcheck ve sürüm kontrollerini iki ana yöntemle gerçekleştirebilirsiniz:
- Kubernetes İçinden
- Kubernetes Dışından
Küme içindeki bir pod üzerinden curl komutu kullanarak dahili servis isimleri aracılığıyla istek atarak gerçekleştirilir. Bu yöntem, cluster içi iletişim problemlerini teşhis etmek için idealdir.
Modülleriniz dışarıya (NodePort, LoadBalancer, Ingress) açılmışsa, yerel makinenizden veya sunucu üzerinden doğrudan erişim URL'lerine istek atarak gerçekleştirilir. Bu yöntem, genel erişilebilirliği ve harici entegrasyonları test etmek için kullanışlıdır.
Kubernetes İçinden Kontroller
Bu yöntem ile Apinizer modüllerinin Kubernetes kümesi içindeki dahili ağ üzerinden erişilebilirliğini ve durumunu kontrol edebilirsiniz.
Pod'lar ve Durumları
Kümedeki tüm Pod'ları ve onların durumlarını kontrol edin:
kubectl get pods -A
Bu komut sisteminizdeki bütün pod'ların çıktısını verir. Aşağıdaki örnekte tüm pod'lar sağlıklı bir şekilde çalışmaktadır:
Çıktıda, tüm Pod'ların Running (Çalışıyor) durumda olduğunu ve READY (Hazır) sütununun 1/1 olduğunu görebilirsiniz. Bu durum pod'ların sağlıklı olduğunu gösterir.
Servis Bilgileri
Pod'lar arasındaki iletişimi sağlayan Servislerin bilgilerini kontrol edin:
kubectl get svc -A
Örnek çıktı:
Aşağıdaki tabloda Apinizer modüllerinin servis bilgileri verilmiştir:
| Modül | Servis Adı | Servis Türü | Namespace | Internal Port | External Port (Dışarıya Açılan) |
|---|---|---|---|---|---|
| Manager | manager | NodePort | apinizer | 8080 | 32080 |
| Worker | worker-http-service | NodePort | prod | 8091 | 30080 |
| Cache | cache-http-service | ClusterIp | prod | 8090 | - |
| Integration | integration-http-service | NodePort | apinizer-integration | 8092 | 30088 |
| Portal | apinizer-portal-service | NodePort | apinizer-portal | 8080 | 32090 |
Bu bilgiler ışığında aşağıdaki şablonda URL'ler oluşturulabilir ve bu URL'lere Kubernetes içindeki herhangi bir pod üzerinden curl atılarak kontrol edilebilir:
http://<SERVICE_NAME>.<NAMESPACE>.svc.cluster.local:<SERVICE_INTERNAL_PORT>/apinizer/management/health
Modül Bazlı Kontroller
Manager
Healthcheck:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://manager.apinizer.svc.cluster.local:8080/apinizer/management/health
Sürüm Bilgisi:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://manager.apinizer.svc.cluster.local:8080/apinizer/management/version
Worker
Healthcheck:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://worker-http-service.prod.svc.cluster.local:8091/apinizer/management/health
Sürüm Bilgisi:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://worker-http-service.prod.svc.cluster.local:8091/apinizer/management/version
Cache
Healthcheck:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://cache-http-service.prod.svc.cluster.local:8090/apinizer/management/health
Sürüm Bilgisi:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://cache-http-service.prod.svc.cluster.local:8090/apinizer/management/version
Integration
Healthcheck:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://integration-http-service.apinizer-integration.svc.cluster.local:8092/apinizer/management/health
Sürüm Bilgisi:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://integration-http-service.apinizer-integration.svc.cluster.local:8092/apinizer/management/version
Portal
Healthcheck:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://apinizer-portal-service.apinizer-portal.svc.cluster.local:8080/apinizer/management/health
Sürüm Bilgisi:
kubectl exec -it <any_pod_name> -n <namespace> -- curl -X GET http://apinizer-portal-service.apinizer-portal.svc.cluster.local:8080/apinizer/management/version
Kubernetes Dışından Kontroller
Eğer Apinizer modülleriniz Kubernetes dışından erişilebilir şekilde yapılandırılmışsa (örneğin NodePort, LoadBalancer tipi servisler veya bir Ingress Controller aracılığıyla), Postman gibi bir HTTP istemcisi veya yerel terminalinizden curl ile doğrudan istek gönderebilirsiniz.
Apinizer modüllerinin NodePort servis tipi ile dışarıya açılan servisleri için Kubernetes Node IP adresleri ve Node Portları aracılığıyla herhangi bir istemciden erişim sağlanabilmektedir. Aşağıdaki tablo, Apinizer servislerinin detaylarını sunmaktadır:
| Modül | Servis Adı | Servis Türü | Namespace | Internal Port | External Port (Dışarıya Açılan) |
|---|---|---|---|---|---|
| Manager | manager | NodePort | apinizer | 8080 | 32080 |
| Worker | worker-http-service | NodePort | prod | 8091 | 30080 |
| Cache | cache-http-service | ClusterIp | prod | 8090 | - |
| Integration | integration-http-service | NodePort | apinizer-integration | 8092 | 30088 |
| Portal | apinizer-portal-service | NodePort | apinizer-portal | 8080 | 32090 |
Modül Bazlı Kontroller
Manager
Healthcheck:
curl "http://<MANAGER_ACCESS_URL>/apinizer/management/health"
Sürüm Bilgisi:
curl "http://<MANAGER_ACCESS_URL>/apinizer/management/version"
Worker
Healthcheck:
curl "http://<WORKER_ACCESS_URL>/apinizer/management/health"
Sürüm Bilgisi:
curl "http://<WORKER_ACCESS_URL>/apinizer/management/version"
Integration
Healthcheck:
curl "http://<INTEGRATION_ACCESS_URL>/apinizer/management/health"
Sürüm Bilgisi:
curl "http://<INTEGRATION_ACCESS_URL>/apinizer/management/version"
Portal
Healthcheck:
curl "http://<PORTAL_ACCESS_URL>/apinizer/management/health"
Sürüm Bilgisi:
curl "http://<PORTAL_ACCESS_URL>/apinizer/management/version"
Cache Modülü: Cache modülü varsayılan olarak kurulumlarda dışarıya açılmamaktadır (ClusterIP servis türü). Bu nedenle, Kubernetes dışından doğrudan health-check ve version-check yapmak istiyorsanız, Cache servisinin 8090 numaralı portunun dışarıya erişilebilir şekilde yapılandırılması gerekmektedir.