Configuración del plugin de compilación de Axelix
Aplicar el plugin de compilación de Axelix incorpora las coordenadas de compilación al artefacto para que Axelix Master pueda identificar la instancia.
Aplicar el plugin de compilación de Axelix es la segunda parte de hacer visible un servicio para Axelix Master; la primera es conectar el starter. El plugin no tiene nada que configurar: se aplica y añade las coordenadas de compilación al artefacto para que Master pueda identificar la instancia. Consulte ¿Qué es el plugin de compilación de Axelix? para conocer qué produce y por qué es obligatorio.
Obligatorio para el registro
Master identifica cada aplicación por su groupId + artifactId. Sin el plugin, falta el archivo
META-INF/axelix-info.properties, las coordenadas están vacías y Master rechaza el registro:
la instancia nunca aparece en la interfaz. Las mismas coordenadas también identifican los análisis de
persistencia (análisis de N+1 y de mapeo de entidades). Aplique el plugin a todos los
servicios que desee gestionar con Axelix.
Actualmente, los plugins se publican solo en Maven Central. La publicación en Gradle Plugin Portal está prevista;
hasta entonces, las compilaciones de Gradle deben resolver el plugin desde Maven Central (véase el bloque pluginManagement siguiente). Mantenga la
versión del plugin sincronizada con la del starter.
Aplicar el plugin
Como el plugin todavía no está en Gradle Plugin Portal, añada mavenCentral() a pluginManagement en su
settings.gradle.kts:
pluginManagement {
repositories {
gradlePluginPortal()
mavenCentral()
}
}Después, aplique el plugin en build.gradle.kts:
plugins {
id("com.axelixlabs.axelix") version "1.3.1"
}Ninguno de los plugins ofrece opciones de configuración. El plugin de Gradle solo necesita que esté establecida la propiedad estándar version
del proyecto (antes de Axelix 1.2.0 también provocaba un fallo de compilación si group estaba vacío; véase la siguiente sección); Maven siempre dispone de sus
coordenadas GAV, por lo que no se necesita nada más.
Coordenada group opcional
En sus primeras versiones, Axelix exigía que todas las aplicaciones Java que gestionaba tuvieran groupId (la G de GAV). Sin embargo,
desde la versión 1.2.0 esto ya no es necesario.
Técnicamente, toda aplicación Java que se empaqueta y despliega debería ser un artefacto Maven. No obstante, hay casos en los que la aplicación no está destinada a publicarse en un repositorio binario compatible con Maven. Por ejemplo, puede ensamblarse directamente como imagen Docker y desplegarse en un clúster K8S.
En ese caso, la aplicación Java no necesita ser un artefacto Maven completo (ya que técnicamente no se publica
en Nexus/Artifactory) y, en particular, no necesita tener groupId. Precisamente por ello,
Gradle permite omitir groupId en las aplicaciones Java que no se publicarán como artefactos Maven.
Por tanto, Axelix ahora puede gestionar proyectos sin groupId. En ese caso, Axelix considera simplemente que
esas aplicaciones tienen un groupId vacío (es decir, ""). Por ello, si su organización omite groupId en sus
microservicios Java, debe asegurarse de que los nombres de los microservicios (es decir, el atributo name de sus archivos build.gradle.kts,
que se resuelve como artifactId) sean únicos. Si los nombres no son únicos, el comportamiento de Axelix Master con sus aplicaciones
Spring Boot queda indefinido.
Información relacionada
- ¿Qué es el plugin de compilación de Axelix?: qué genera el plugin y por qué el registro depende de él.
- Configuración de Spring Boot Starter: el componente de ejecución que lee las coordenadas generadas y las comunica a Master.
Configuración de Spring Boot Starter
Cómo integrar Axelix Spring Boot Starter en una aplicación Spring Boot para que Axelix Master pueda descubrirla, leer su estado y actuar sobre ella.
Panel
Dashboard es una página de inicio de Axelix. Resume todos los servicios de Spring Boot que Axelix Master sigue actualmente: las versiones de ejecución del conjunto, cuántas instancias están sanas en ese momento y el consumo de memoria agregado.