Настройка плагина сборки Axelix

Подключение плагина сборки Axelix — это вторая половина того, что делает сервис видимым для Axelix Master; первая половина — подключение стартера. У плагина нечего настраивать: вы его подключаете, и он записывает координаты сборки в артефакт, чтобы Master мог идентифицировать сервис. См. Что такое плагин сборки Axelix?, чтобы узнать, что он создаёт и почему он обязателен.

Подключите плагин

pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
}

plugins {
    id("com.axelixlabs.axelix") version "1.1.1"
}

Ни один из плагинов не имеет параметров конфигурации. Gradle-плагину нужно лишь, чтобы были заданы стандартные group и version проекта (он завершает сборку с ошибкой, если group пуст, поскольку Axelix использует его, чтобы различать приложения); в Maven координаты GAV есть всегда, поэтому ничего дополнительно настраивать не нужно.

Необязательная координата group

Раннее Axelix требовал, чтобы у всех управляемых им Java-приложений был указан groupId (часть G в координатах GAV). Но начиная с релиза 1.2.0 это больше не так.

Строго говоря, каждое упакованное и развёрнутое Java-приложение должно представлять собой Maven-артефактом. Однако бывают случаи, когда приложение на самом деле не предполагается публиковать в Maven-совместимый репозиторий бинарных артефактов. Так может быть, например, если приложение просто собирается «на лету» в Docker-образ и разворачивается в кластере K8S.

В таком случае Java-приложение по сути не обязано быть полноценным Maven-артефактом (поскольку технически оно никуда не публикуется), и в частности, ему не обязательно иметь groupId. Именно поэтому Gradle позволяет Java-приложениям, которые не предполагается публиковать как Maven-артефакты, опускать groupId.

Благодаря этому Axelix теперь умеет работать с проектами без groupId, когда он не задан. В этом случае Axelix просто считает, что у таких приложений пустой groupId (т.е. ""). Как следствие, если в вашей организации вы не используете groupId для своих Java-микросервисов, то вы должны гарантировать, что имена ваших микросервисов (т.е. атрибут name в ваших файлах build.gradle.kts, который преобразуется в artifactId) уникальны. Если же вы не будете этого гарантировать, то поведение Axelix Master по отношению к вашим сервисам будет неопределенно.

См. также

• Что такое плагин сборки Axelix? — что генерирует плагин и почему от него зависит регистрация.
• Настройка Spring Boot Starter — runtime-сторона, которая читает сгенерированные координаты и передаёт их в Master.