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:

settings.gradle.kts
pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
}

Ardından build.gradle.kts dosyasında eklentiyi uygulayın:

build.gradle.kts
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ı

YayımlandıŞu sürümden itibaren kullanılabilir: 1.2.0

İ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.

Bu sayfada

GitHub üzerinde düzenleSorun bildir