Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Cómo Construir Microservicios Con Spring Boot (I)
Cómo Construir Microservicios Con Spring Boot (I)
Los microservicios suponen un nuevo estilo de arquitectura software para el diseño de aplicaciones.
En este post explicaré como crear y desplegar microservicios desde cero utilizando Spring Boot, uno
de los frameworks más populares para su construcción.
La tendencia es que las aplicaciones sean diseñadas con un enfoque orientado a microservicios,
construyendo múltiples servicios que colaboran entre si, en lugar del enfoque monolítico, donde se
construye y despliega una única aplicación que contenga todas las funcionalidades.
Pueden ser auto-contenidos, de tal forma que incluyen todo lo necesario para prestar su
servicio
Servicios pequeños, lo que facilita el mantenimiento. Ej: Personas, Productos, Posición
Global, etc
Principio de responsabilidad única: cada microservicio hará una única cosa, pero la hará bien
Políglotas: una arquitectura basada en microservicios facilita la integración entre diferentes
tecnologías (lenguajes de programación, BBDD…etc)
Despliegues unitarios: los microservicios pueden ser desplegados por separado, lo que
garantiza que cada despliegue de un microservicio no implica un despliegue de toda la
plataforma. Tienen la posibilidad de incorporar un servidor web embebido como Tomcat o
Jetty
Escalado eficiente: una arquitectura basada en microservicios permite un escalado elástico
horizontal, pudiendo crear tantas instancias de un microservicio como sea necesario.
Sobre el ejercicio práctico
Voy a intentar explicar, de la manera más simple posible, como construir una sencilla aplicación
compuesta por tres microservicios:
El objetivo es implementar un típico Hola Mundo con microservicios. Para ello, greeting-client-service
llamará al método greeting del microservicio greeting-service usando RESTful API, pasándole como
parámetro de entrada un nombre (Ej: “Rob”) y recibiendo como contestación un saludo (Ej: “Hello,
Rob!”).
Configuración
Para la implementación de los microservicios, utilizaremos Spring Boot y Spring Cloud. El
ejemplo estará compuesto de tres proyectos (uno por cada microservicio). A continuación muestro la
configuración de los ficheros POM.xml.
<parent>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-parent</artifactId>
<version>Brixton.RELEASE</version>
</parent>
<groupId>net.robertocrespo</groupId>
<artifactId>microservice-XXXX</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>microservice-greeting</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<!-- Setup Spring Boot -->
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<!-- Setup Spring MVC & REST, use Embedded Tomcat -->
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<!-- Spring Cloud starter -->
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
<!-- Eureka for service registration -->
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka-server</artifactId>
</dependency>
</dependencies>
Microservicio Registration
Como comenté antes, para implementar este servicio utilizaremos Eureka, un servidor de registro y
descubrimiento de microservicios open source desarrollado por Netflix. Levantar una instancia de este
servidor con Spring Cloud es muy sencillo. Aquí tienes el código completo:
@SpringBootApplication
@EnableEurekaServer
public class RegistrationServer {
Por defecto, cuando inicias una aplicación spring boot , se busca un fichero llamado
application.properties o application.yml para acceder a su configuración, el cual deberá estar ubicado
en la carpeta resources de nuestro proyecto. Su configuración es la siguiente:
Observa que:
Microservicio Greeting
Este microservicio gestionará peticiones que reciba por HTTP para devolver un saludo (greeting) a los
nombres de las personas que reciba como entrada. Al arrancar greeting-service lo primero que hará
será registrarse en Eureka.
@EnableAutoConfiguration
@EnableDiscoveryClient
@SpringBootApplication
public class GreetingServer {
# Spring properties
spring:
application:
name: greeting-service # Service registers under this name
freemarker:
enabled: false # Ignore Eureka dashboard FreeMarker templates
thymeleaf:
cache: false # Allow Thymeleaf templates to be reloaded at runtime
prefix: classpath:/templates/ # Trailing / mandatory
# Template location for this application only
# HTTP Server
server:
port: 2222 # HTTP (Tomcat) port
Este microservicio utilizará Spring REST para ofrecer un interface RESTful sobre HTTP y poder así
acceder a sus operaciones.
@RestController
public class GreetingController {
@RequestMapping("/greeting/{name}")
public Greeting greeting(@PathVariable("name") String name) {
return new Greeting(String.format(template, name));
}
}
El método greeting devolverá un objeto de tipo Greeting, cuya clase se muestra a continuación:
Microservicio ClientGreeting
Para consumir un servicio RESTful, Spring proporcionar la clase RestTemplate que nos permite enviar
peticiones HTTP a un servidor RESTful y recuperar los datos en formatos como JSON y XML. En
nuestro ejemplo usaremos JSON como formato de intercambio de datos, para lo cual vamos a
apoyarnos en Jackson, una librería java para el procesamiento y parseo de datos JSON.
@Service
public class ClientGreetingService {
@Autowired
protected RestTemplate restTemplate;
protected String serviceUrl;
return greeting;
}
}
RestTemplate ha sido configurado por Spring Cloud para usar un HttpRequestClient personalizado que
utiliza Netflix Ribbon para realizar la búsqueda del microservicio. Ribbon además es un balanceador
de carga, por lo que si tienes varias instancias disponibles de un microservicio, selecciona una para ti.
La petición REST realizada en la clase ClientGreetingService devuelve un mensaje JSON que
pasearemos, usando Jackson, a un objeto de la clase Greeting. A continuación muestro la definición de
esta clase:
import com.fasterxml.jackson.annotation.JsonRootName;
@JsonRootName("Greeting")
public class Greeting {
protected String content;
protected Greeting() {
this.content = "Hello!";
}
@Controller
public class ClientGreetingController {
//constructor
public ClientGreetingController(ClientGreetingService helloWorldService) {
this.helloWorldService = helloWorldService;
}
@RequestMapping("/greeting")
public String goHome() {
return "index";
}
@RequestMapping("/greeting/{name}")
public String greeting(Model model, @PathVariable("name") String name) {
model.addAttribute("greeting", greeting.getContent());
return "greeting";
}
}
@Controller
public class ClientGreetingHomeController {
@RequestMapping("/")
public String home() {
return "index";
}
}
@SpringBootApplication
@EnableDiscoveryClient
@ComponentScan(useDefaultFilters = false) // Disable component scanner
public class ClientGreetingServer {
//A customized RestTemplate that has the ribbon load balancer build in
@LoadBalanced
@Bean
RestTemplate restTemplate() {
return new RestTemplate();
}
@Bean
public ClientGreetingHomeController homeController() {
return new ClientGreetingHomeController();
}
}
# HTTP Server
server:
port: 3333 # HTTP (Tomcat) port
Ya solo queda ejecutar este microservicio y probar que todo funciona correctamente. Comprueba que
al levantar el microservicio, aparece registrado en la consola de Eureka
Prueba a cambiar el nombre que se pasa como parámetro y comprueba que el resultado devuelto es
distinto. Te animo a crear nuevas operaciones en este microservicio greeting-service y probar a
invocarlas así como a crear nuevos microservicios un poco más complejos para la gestión de conceptos
como usuarios, productos, etc.