Axelix derleme eklentisini yapılandırma
Axelix derleme eklentisi, Master'ın örneği tanımlayabilmesi için derleme koordinatlarınızı uygulama çıktısına işler.
Axelix derleme eklentisini uygulamak, bir servisi Axelix Master için görünür kılmanın ikinci yarısıdır; ilk yarısı starter bağlantısını kurmaktır. Eklentide yapılandırılacak bir şey yoktur: uyguladığınızda Master'ın örneği tanımlayabilmesi için derleme koordinatlarını çıktıya işler. Neler ürettiği ve neden gerekli olduğu için Axelix derleme eklentisi nedir? sayfasına bakın.
Kayıt için gereklidir
Master her uygulamayı groupId + artifactId ile tanımlar. Eklenti olmadan META-INF/axelix-info.properties dosyası bulunmaz, koordinatlar boş kalır ve Master kaydı reddeder; örnek arayüzde hiçbir zaman görünmez. Aynı koordinatlar kalıcılık analizlerini (N+1 ve varlık eşleme analizi) de ilişkilendirir. Axelix'in yönetmesini istediğiniz her servise eklentiyi uygulayın.
Eklentiler şu anda yalnızca Maven Central'da yayımlanır. Gradle Plugin Portal'da yayımlama yol haritasındadır; o zamana kadar Gradle derlemeleri eklentiyi Maven Central'dan çözümlemelidir (aşağıdaki pluginManagement bloğuna bakın). Eklenti sürümünü starter sürümüyle eş tutun.
Eklentiyi uygulama
Eklenti henüz Gradle Plugin Portal'da olmadığından settings.gradle.kts dosyasındaki pluginManagement bölümüne mavenCentral() ekleyin:
pluginManagement {
repositories {
gradlePluginPortal()
mavenCentral()
}
}Ardından build.gradle.kts dosyasında eklentiyi uygulayın:
plugins {
id("com.axelixlabs.axelix") version "1.3.1"
}İki eklenti de herhangi bir yapılandırma seçeneği sunmaz. Gradle eklentisi yalnızca standart proje version değerinin ayarlanmasını gerektirir (Axelix 1.2.0 öncesinde group boşsa derleme de başarısız olurdu; sonraki bölüme bakın). Maven her zaman GAV koordinatlarına sahiptir, dolayısıyla başka bir şey gerekmez.
İsteğe bağlı group koordinatı
İlk sürümlerde Axelix, yönettiği tüm Java uygulamalarının groupId değerine (GAV'ın G bölümü) sahip olmasını gerektiriyordu. Ancak 1.2.0 sürümünden itibaren bu zorunluluk kaldırılmıştır.
Teknik olarak paketlenip dağıtılan her Java uygulamasının bir Maven çıktısı olması beklenir. Ancak uygulamanın Maven uyumlu bir ikili dosya deposuna dağıtılmasının amaçlanmadığı durumlar vardır. Örneğin uygulama doğrudan bir Docker imajı olarak oluşturulup K8S kümesine dağıtılabilir.
Bu durumda Java uygulamasının tam bir Maven çıktısı olması gerekmez (teknik olarak Nexus/Artifactory'ye dağıtılmadığından); özellikle groupId zorunlu değildir. Tam da bu nedenle Gradle, Maven çıktısı olarak dağıtılması amaçlanmayan Java uygulamalarının groupId değerini atlamasına izin verir.
Dolayısıyla Axelix artık groupId içermeyen projeleri işleyebilir. Bu durumda Axelix, uygulamaların boş bir groupId değerine (yani "") sahip olduğunu varsayar. Sonuç olarak kuruluşunuzdaki Java mikroservislerinde groupId kullanmıyorsanız mikroservis adlarının (build.gradle.kts dosyalarınızdaki, artifactId olarak çözümlenen name özelliğinin) benzersiz olduğundan emin olmalısınız. Adlar benzersiz değilse Axelix Master'ın Spring Boot uygulamalarınızla davranışı tanımsızdır.
İlgili konular
- Axelix derleme eklentisi nedir? — eklenti neler üretir ve kayıt neden buna bağlıdır?
- Spring Boot Starter'ı yapılandırma — üretilen koordinatları okuyup Master'a bildiren çalışma zamanı bileşeni.
Axelix derleme eklentisi nedir?
Axelix derleme eklentisi, Axelix'in yönetmesini istediğiniz her servise uyguladığınız küçük bir Gradle veya Maven eklentisidir. Derleme sırasında çalışarak uygulama çıktısına META-INF/axelix-info.properties dosyasını yazar. Bu dosya, Master'ın uygulamaları birbirinden ayırmak için kullandığı kimliği taşır.
Sözlük
Bu belge, Axelix dokümantasyonu ve kod tabanında kullanılan temel terimleri ve kısaltmaları tanımlar.