Este documento describe cómo una empresa de software llamada Nabenik creó un arquetipo de Maven para iniciar proyectos de microservicios en Java de manera consistente. El arquetipo incluye un conjunto aprobado de dependencias y configuración de runtime para simplificar el desarrollo de microservicios. El documento explica cómo Nabenik evolucionó desde usar un POM de referencia compartido hasta usar arquetipos de Maven para proporcionar una plantilla preconfigurada para nuevos proyectos de microservicios.

1. Bootstraping real world Jakarta EE/MicroProfile microservices
with Maven Archetypes
Víctor Orozco - @tuxtor
1 de octubre de 2021
Software architect
1

2. Microservicio
Microservicio
Un servicio enfocado en un problema de negocio, gestionado independiente,
creado con herramientas para cumplir su propósito
Figura 1: Source: microservices.io
2

3. Microservice Chassis en Java
Panorama de chassis en Java
• DIY
• Javalin
• Spark
• Helidon SE
• Microframework runtimes
• Apache TomEE
• Dropwizard
• Payara Micro
• Full fledged runtimes (ecosistemas)
• Spring Boot
• Kumuluz EE
• Quarkus
3

4. Microservice Chassis
Microservicios en el mundo real
• Tu código
• Chassis
• Extensiones chassis
• Bibliotecas independientes
• Bibliotecas no funcionales -e.g. SCM, Testing-
• Descriptores para orquestación (Docker, Compose, K8S)
4

5. Bootstraping microservices

6. Microservice Chassis bootstrap
La forma Nabenik de iniciar proyectos
• Nabenik es una empresa que utiliza Java en casi todos sus proyectos y todos
los desarrolladores están entrenados en Java EE
• Apps creciendo desde 2014 -e.g. ERP, POS con geofence-
• Estudio de desarrollo
• Necesitabamos mantener un set de dependencias que todos los
desarrolladores conozcan
5

7. Microservice Chassis bootstrap
Un microservicio típico
• Lenguaje: Java 11 y a veces Kotlin
• Java EE / Jakarta EE (Wildfly, Payara, WebLogic)
• MicroProfile
• Persistencia: JPA + DeltaSpike Data + persistence.xml + JTA Data source
• Logs: SLF4J y proveedor CDI
• Despliegue: Docker + Kubernetes con Eclipse JKube y descriptores YAML
• Testing: Arquillian, JUnit
6

8. Microservice Chassis starters
Nuestra jornada para arrancar microservicios/servicios ligeros
1. pom.xml personalizado basado en la experiencia (EL POM de referencia)
2. Starters con manual de uso y documentación de extensiones
3. Proyecto de ejemplo que todo mundo clona y modifica
4. Arquetipo
7

9. EL POM de referencia
• Heredado de
nuestros
proyectos con EAR
• Bueno para
centralizar
versiones
• Difícil de mantener
sin quebrar algún
modulo existente
8

10. Starters
• Geniales para
principiantes
• Iniciar el proyecto
y leer la
documentación
• No siempre un
starter incluye una
dependencia que
te gusta
9

11. Proyecto de ejemplo
• Ajustado a nuestra
necesidad
• Reemplazamos
manualmente
package name,
app name y
versión
• Difícil de subir
dependencias sin
probar
apropiadamente
10

12. Arquetipo
• Basado en el
proyecto de
ejemplo
• Disponible en
repositorio interno
(y/o Maven
Central)
• Conjunto de
dependencias y
runtime aprobado
• Ajustado desde el
día 0
11

13. Creando un arquetipo de
microservicio

14. Demo
1. Crear un proyecto base
2. Usar el arquetipo maven create-from-project
3. Reemplazar strings con templates -e.g. Package name, app name, variable-
4. non-maven resources = ajuste manual
5. Probar el arquetipo
6. Subirlo a un repositorio (por si sola es otra presentación)
12

15. Víctor Orozco
• vorozco@nabenik.com
• @tuxtor
• https://vorozco.com
• https://tuxtor.shekalug.org
This work is licensed under
Creative Commons Attribution-
NonCommercial-ShareAlike 3.0
Guatemala (CC BY-NC-SA 3.0 GT).
13