Wiki

Has cargado una revisión vieja del documento! Si la guardas crearás una versión nueva con estos datos.

====== Migración SICOF ERP - Proceso: Guía de Dependencias en Microservicios ======
La siguiente sección define las dependencias básicas que se deben tener presente y utilizar en el desarrollo de los microservicios de la fábrica según la necesidad de los mismos.

=== Consideraciones Previas ===
  * Solo las depenencias básicas son requeridas
  * Las dependencias opcionales solo deben ser consideras si el microservicio aplica para el caso de la dependencia
  * Se asume conocimiento previo de la tecnología Maven / Spring Cloud / Nexflix OSS
  * Si un microservicio requiere configuraciones especiales, estas deben ser validadas con los lideres de desarrollo (Pablo Quintana, Daberson Henao, Carlos Torres, Gersain Castañeda).

===== Escenario estandar de dependencias =====
La siguiente imagen define el escenario estandar de dependencias que pueden ser utilizados en un microservicio. Posteriormente se describirá cada una deacuerdo al grupo al que pertenece.

{{:ada:howto:sicoferp:factory:migracionsicoferp:process:backend:dependencias00.png?400|}}

==== Clasificación de dependencias ====
Se definen las siguientes clasificaciones de dependencias:

* Dependencias básicas
  * Dependencias de traza
  * Dependencias de clientes
  * Dependencias de datos

===== Dependencias básicas =====
Son aquellas dependencias que deben estár presentes en todos los microservicios ya que su uso aplica la arquitectura desea en la fabrica de desarrollo. A continuación se define esas dependencias:

==== Spring Boot DevTools ====
Spring Boot DevTools((https://www.arquitecturajava.com/spring-boot-devtools-y-recarga-de-aplicaciones/)) es la herramienta de Spring Boot que nos permite reiniciar de forma automática nuestras aplicaciones cada vez que se produce un cambio en nuestro código. Utíl para la fase de desarrollo y pruebas.

==== Spring Boot Actuator ====
Spring Boot Actuator((https://openwebinars.net/blog/como-anadir-spring-boot-actuator-tu-proyecto/)) es una librería que nos proporciona herramientas de monitorización y administración de nuestra API REST de una manera bastante sencilla.

==== Spring Cloud Config Client ====
Spring Cloud Config((https://www.baeldung.com/spring-cloud-configuration)) es el enfoque cliente / servidor de Spring para almacenar y servir configuraciones distribuidas en múltiples aplicaciones y entornos.

Este almacén de configuración se versiona idealmente bajo el control de versión de Git y se puede modificar en el tiempo de ejecución de la aplicación.

==== Servicio de configuración central - ConfigServerADA ====
Se encarga de centralizar y proveer remotamente la configuración a cada microservicio. Esta configuración se mantiene convencionalmente en un repositorio, lo cual permite gestionar su propio ciclo de vida y versionamiento.

=== Ubicación ===
El código fuente está uicado en la siguiente url: [[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/core/ConfigServerADA|Ir al repositorio]]

=== Modo de uso ===
Debe estar definido como una propiedad del archivo de configuración bootstrap.yml ó bootstrap.properties como se indica a continuación:

<code>
spring:
   cloud:
      config:
         discovery:
            enabled: true
            service-id: co.ada.core.server.config
</code>

==== Servicio de registro / descubrimiento - EurekaServerADA ====
Se encarga de proveer los endpoints de los servicios para su consumo. Todo microservicio se registrará automáticamente en él en tiempo de bootstrap.

=== Ubicación ===
El código fuente está uicado en la siguiente url: [[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/core/EurekaServerADA|Ir al repositorio]]

=== Modo de uso ===
Debe estar definido como una propiedad del archivo de configuración bootstrap.yml ó bootstrap.properties como se indica a continuación:

<code>
eureka:
   client:
      serviceUrl:
         defaultZone: http://localhost:8761/eureka/
</code>

==== Servidor perimetral / exposición de servicios (Edge server) - ZuulServerADA ====
Servidor gateway en el que se expondrán los servicios a consumir. Todos los microservicios deben ser expuesto por este servidor por lo tanto deben registrar los path de rutas y deben ser únicos en todo el contexto de exposición de servicios de cada ambiente.

=== Ubicación ===
El código fuente está uicado en la siguiente url: [[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/core/ZuulServerADA|Ir al repositorio]]

=== Modo de uso ===
Cada Microservicio debe estar registrado en las rutas de reconocimiento del servidor como una sección similar a la  indicada a continuación:

<code>
zuul:
  routes:
    usuario:
      service-id: co.ada.core.service.userold
      path: /api/usuario/**
</code>

La inclusión de la ruta debe ser solicitada al administrador de rutas de configuración.

==== Servidor de Trazabilidad - ZipkinServerADA ====
Centraliza el proceso de trazas y log en los microservicios de forma centralizada.

=== Ubicación ===
El código fuente está uicado en la siguiente url: [[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/core/ZipkinServerADA|Ir al repositorio]]

=== Modo de uso ===
Cada Microservicio debe incluir la siguiente dependencia:

<code>
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-zipkin</artifactId>
</dependency>
</code>

Por defecto el servidor Zipkin se publica en el puerto 9411

[[ada:howto:sicoferp:factory:migracionsicoferp:process:backend|←Volver atrás]]

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página