Настройка плагина сборки Axelix
При использовании плагина Axelix для сборки координаты сборки записываются в артефакт, чтобы Axelix Master мог идентифицировать экземпляр.
Подключение плагина сборки Axelix — это вторая половина того, что делает сервис видимым для Axelix Master; первая половина — подключение стартера. У плагина нечего настраивать: вы его подключаете, и он записывает координаты сборки в артефакт, чтобы Master мог идентифицировать сервис. См. Что такое плагин сборки Axelix?, чтобы узнать, что он создаёт и почему он обязателен.
Обязателен для регистрации
Master идентифицирует каждое приложение по его groupId + artifactId. Без плагина файл
META-INF/axelix-info.properties отсутствует, координаты пусты, и Master отклоняет регистрацию — сервис так и не
появится в UI. Эти же координаты используются как ключ для инсайтов по
персистентности (анализ N+1 и маппинга сущностей). Подключайте плагин к
каждому сервису, которым вы хотите управлять через Axelix.
На данный момент плагины публикуются только в Maven Central. Публикация в Gradle Plugin Portal запланирована; до тех
пор сборки на Gradle должны получать плагин из Maven Central (см. блок pluginManagement ниже). Держите версию плагина в
соответствии с версией стартера.
Подключите плагин
Поскольку плагина пока нет в Gradle Plugin Portal, добавьте mavenCentral() в pluginManagement в вашем
settings.gradle.kts:
pluginManagement {
repositories {
gradlePluginPortal()
mavenCentral()
}
}Затем подключите плагин в build.gradle.kts:
plugins {
id("com.axelixlabs.axelix") version "1.0.0"
}Ни один из плагинов не имеет параметров конфигурации. Gradle-плагину нужно лишь, чтобы были заданы стандартные group
и version проекта (он завершает сборку с ошибкой, если group пуст, поскольку Axelix использует его, чтобы различать
приложения); в Maven координаты GAV есть всегда, поэтому ничего дополнительно настраивать не нужно.
См. также
- Что такое плагин сборки Axelix? — что генерирует плагин и почему от него зависит регистрация.
- Настройка Spring Boot Starter — runtime-сторона, которая читает сгенерированные координаты и передаёт их в Master.
Что такое плагин сборки Axelix?
Плагин сборки Axelix — это небольшой Gradle или Maven-плагин, который вы подключаете к каждому сервису, которым хотите управлять через Axelix. Он выполняется во время сборки и записывает файл `META-INF/axelix-info.properties` внутрь артефакта вашего приложения. Этот файл несёт набор информации, по которой Master отличает одно приложение от другого.
Глоссарий
В этом документе приведены определения ключевых терминов и сокращений, используемых в документации и кодовой базе Axelix.