Keşif nasıl çalışır?
Axelix Master'ın Spring Boot örneklerini Kubernetes'te kendisi bularak veya örneklerin kendilerini kaydetmesine izin vererek nasıl öğrendiği ve durumlarını nasıl güncel tuttuğu.
Master yalnızca bildiği örnekleri gösterebilir ve yönetebilir. Örnekleri iki yoldan biriyle öğrenir: Master bunları kendisi bulur (otomatik keşif) veya örnek kendisini Master'a bildirir (kendiliğinden kayıt).
Keşfedilmenin iki yolu
┌─ Kubernetes cluster ─────────────────────────────┐
│ │
│ ┌──────────────────┐ ┌──────────────────┐ │
│ │ orders-service │ │ billing-service │ │
│ └────────▲─────────┘ └─────────▲────────┘ │
│ │ │ │ ┌────────────────────┐
│ └────────────┬───────────┘ │ │ inventory-service │
│ │ │ │ (VM, Docker, ...) │
│ │ auto-discovery: │ └─────────┬──────────┘
│ │ Master finds the pods │ │
│ │ and polls them │ │ self-registration:
│ ┌───────┴───────┐ │ │ the service registers
│ │ Axelix Master │◀────────────────┼───────────────┘ once, then heartbeats
│ └───────────────┘ │
│ │
└──────────────────────────────────────────────────┘Bu diyagramlardaki her servis, Axelix derleme eklentisiyle derlenmiş ve Axelix starter çalıştıran bir Spring Boot uygulamasıdır.
| Otomatik keşif | Kendiliğinden kayıt | |
|---|---|---|
| Çağrıyı kim başlatır? | Master servisi çağırır | Servis Master'ı çağırır |
| Nerede çalışır? | Yalnızca Kubernetes | Servisin Master'a erişebildiği her yer |
| Nasıl etkinleştirilir? | Master'da axelix.master.discovery.auto.enabled | Serviste axelix.sbs.discovery.self-registration |
Kendiliğinden kayıt Master'da da etkinleştirilmelidir. axelix.master.discovery.self-registration.enabled uygulama özelliği
varsayılan olarak true olsa da resmî Helm chart bunu varsayılan olarak devre dışı bırakır. Helm dağıtımlarında,
iki keşif yöntemini birlikte kullanırken de chart değerlerinde axelix.master.discovery.selfRegistration.enabled=true ayarlayın.
Master servislerinizle aynı Kubernetes kümesinde çalışıyorsa otomatik keşif için servis tarafında ek kurulum gerekmez. Kendiliğinden kayıt, düz sanal makineler, Docker Compose veya Master'ın tarayamadığı ağlar gibi diğer durumları kapsar.
İki yöntem aynı anda çalışabilir
Seçim tüm servisler için topluca değil, her servis için ayrı yapılır. Bir Master, Kubernetes kümesindeki servisleri otomatik keşfederken başka yerlerde çalışan servislerin kendiliğinden kayıtlarını da kabul edebilir. Örneğin sanal makinelerdeki üç uygulama kendiliğinden kayıt olurken kümedeki her servis otomatik keşfedilebilir.
Bir kez tam durum, ardından küçük güncellemeler
Axelix 1.3.0'dan itibaren her iki yöntem de aynı yaklaşımı izler. Master, bir örneğin tam durumunu yalnızca bir kez alır:
kendiliğinden kayıtta kayıt isteğinde, otomatik keşifte ise ilk axelix-metadata çağrısında. Bundan sonra örnek yalnızca
küçük ve sık güncellemeler gönderir: kendiliğinden kayıtta yaşam sinyali, otomatik keşifte axelix-ping yanıtı.
Her güncellemenin iki görevi vardır. Birincisi, örneğin hâlâ çalıştığını Master'a bildirir. İkincisi, zamanla değişen sınırlı bilgileri taşır: örneğin sağlık durumu, heap kullanımı ve işlem istatistikleri. Böylece yeni bir sorunlu işlem, yeniden kayıt gerektirmeden Master'da görünür. Aşağıdaki diyagramlar bu davranışı gösterir.
1.3.0'dan önce Master tam durumu her seferinde alıyordu: her otomatik keşif taramasında ve her kendiliğinden kayıt yaşam sinyalinde.
Otomatik keşif
Axelix Master Kubernetes API orders-service
│ │ │
│ which pods are there? │ │
│─────────────────────────────▶│ │
│◀─────────────────────────────│ │
│ │
│ first scan: axelix-metadata │
│────────────────────────────────────────────────────────────▶│
│◀──────────────────────────────────────── full registration ─│
│ │
│ every next scan (each minute by default): axelix-ping │
│────────────────────────────────────────────────────────────▶│
│◀─────────────────────────────── health, heap, transactions ─│İlk çağrı tam kayıt bilgilerini döndürür: derleme koordinatları, sürümler ve Axelix'in topladığı analizler. Ardından örnek Master'da görünür. Master ve servisteki imzalama anahtarı ve algoritma aynı olmalıdır.
Bu ilk yoklamada Master henüz starter sürümünü bilmez. AXELIX.MASTER öznesine ve eski starter'ların gerektirdiği eski
taleplere sahip bir uyumluluk JWT'si gönderir. 1.3 ve üzeri starter'lar Master kimliğini kabul eder ve bu ek talepleri yok sayar.
Bu uyumluluk biçiminin 1.6'da kaldırılması planlanmaktadır.
Sonraki arayüz ve MCP çağrılarında Master önce kullanıcının yetkilerini denetler. 1.3 ve üzeri starter'lara kullanıcı rolleri
veya yetkileri içermeyen kısa ömürlü bir AXELIX.MASTER teknik kullanıcı JWT'si gönderir. Eski starter'lar eski yetki adlarıyla
yeniden düzenlenmiş bir kullanıcı belirteci alır ve izinleri kendileri uygulamaya devam eder.
Her tarama, otomatik keşfedilen örneklerin tüm listesini değiştirir. Bu nedenle Kubernetes'in artık bildirmediği pod bir sonraki taramada kaybolur. Master'ın erişemediği pod da listeden çıkar ve erişilebildiği bir sonraki taramada geri gelir.
1.3.0'dan eski starter kullanan örneklerde axelix-ping bulunmadığından Master, her taramada bunların tam axelix-metadata
bilgilerini okur.
Kendiliğinden kayıt
inventory-service Axelix Master
│ │
│ on startup: register (full description, │
│ actuator URL, instance name) │
│──────────────────────────────────────────────────▶│ the instance appears
│ │
│ every 15 s: heartbeat (health, heap, │
│ transactions) │
│──────────────────────────────────────────────────▶│
│──────────────────────────────────────────────────▶│
│ │
│ heartbeat after Master lost the instance │
│──────────────────────────────────────────────────▶│
│◀─────────────────────────────── unknown instance ─│
│ register again │
│──────────────────────────────────────────────────▶│
│ │
╳ the service stops, heartbeats stop │
│ removed on next eviction run
│ after 45 s without a heartbeatVarsayılan yaşam sinyali zaman aşımı 45 saniyedir. Master, güncelliğini yitiren örnekleri zaman aşımı dolduğu anda değil, varsayılan olarak dakikada bir çalışan bir sonraki çıkarma işleminde kaldırır.
1.3.0'dan eski starter kullanıldığında her yaşam sinyali tam bir kayıttır.
Master, boş bir veritabanıyla yeniden başlatıldığında veya kaçırılan yaşam sinyallerinin ardından örneği kaldırdığında bir örneği kaybedebilir. Her iki durumda da bir sonraki yaşam sinyali servisin yeniden kaydolmasını sağlar; böylece tüm servisler bir yaşam sinyali aralığı içinde yeniden görünür. Kayıt ve yaşam sinyalleri paylaşılan JWT imzalama anahtarıyla imzalanır; anahtarlar farklıysa Master bunları reddeder.
1.3 ve üzeri starter her iki isteği de öznesi AXELX.MANAGED_SERVICE olan bir teknik kullanıcı JWT'siyle imzalar
(bu yazım iletişim protokolündeki tanımlayıcıdır). JWT rol veya yetki taşımaz. Master bu uç noktalarda yalnızca yönetilen servis
kimliğini kabul eder. Eski starter'lardan gelen eski AXELIX.STARTER öznesini de kabul eder; bu uyumluluk takma adının 1.6'da
kaldırılması planlanmaktadır.
Her iki durumda Master'ın ihtiyaç duydukları
Keşif, Master'a yalnızca bir örneğin var olduğunu bildirir. Her arayüz sayfası, MCP aracı ve eylem (günlük düzeyini değiştirmek gibi) hâlâ Master'dan servise yapılan bir çağrıdır. Bu nedenle servis hangi yöntemle keşfedilmiş olursa olsun Master, servisin actuator uç noktalarına HTTP üzerinden erişebilmelidir. Uygulama actuator uç noktalarını kendi güvenliğiyle koruyorsa Master çağrılarına nasıl izin verileceğini öğrenmek için Sorun giderme sayfasına bakın.
Ayrıca bakın
Mimari
Axelix'in merkezinde Axelix Master bulunur. Master, yönetmek istediğiniz her Spring Boot servisiyle servis tarafındaki Axelix Starter bağımlılığı üzerinden iletişim kurar. Web arayüzü ve MCP sunucusu Master içinde çalışır; böylece tek bir süreç hem tarayıcıya hem yapay zekâ ajanına aynı verileri sunar.
Başlarken
Bu sayfa Axelix'i bir kuruluşta kullanıma almanın önerilen yolunu açıklar: hangi ortamlardan başlanacağı, bileşenlerin hangi sırayla kurulacağı ve üretime nasıl güvenle geçileceği. Her adım somut komutlar, minimum yapılandırma ve tam başvuru için ayrıntılı yapılandırma sayfasına bağlantılar sunar.