Muestra las diferencias entre dos versiones de la página.
Próxima revisión | Revisión previa | ||
ada:howto:sicoferp:factory:migracionsicoferp:process:backend:guiaservicesandserver [2020/04/29 10:51] carlos.torres creado |
ada:howto:sicoferp:factory:migracionsicoferp:process:backend:guiaservicesandserver [2020/05/18 16:34] (actual) carlos.torres [Servidor de Trazabilidad - ZipkinServerADA] |
||
---|---|---|---|
Línea 4: | Línea 4: | ||
=== Consideraciones Previas === | === Consideraciones Previas === | ||
* Las configuraciones han sido implementadas para el trabajo en ambientes locales. | * Las configuraciones han sido implementadas para el trabajo en ambientes locales. | ||
+ | * Se asume conocimiento previo de la tecnología 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). | * Si un microservicio requiere configuraciones especiales, estas deben ser validadas con los lideres de desarrollo (Pablo Quintana, Daberson Henao, Carlos Torres, Gersain Castañeda). | ||
- | ===== Servicios Generales ===== | + | ===== Servicios y Servidores Generales ===== |
- | Se han definido los siguientes servicios generales los cuales pueden ser utilizados segun la necesidad y complejidad del desarrollo. | + | Se han definido los siguientes servicios y servidores generales los cuales pueden ser utilizados segun la necesidad y complejidad del desarrollo. |
- | ==== Servidor de configuración central ==== | + | ==== Servicio de configuración central - ConfigServerADA ==== |
- | se encargará 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. | + | 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]] | ||
- | http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/core/ConfigServerADA | + | === 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 yaml> | ||
+ | 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 yaml> | ||
+ | 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 yaml> | ||
+ | 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 xml> | ||
+ | <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]] |