====== Migración SICOF ERP - Proceso: Guía de Servicios y Tecnologías ======
La siguiente sección define los servicios y tecnologías 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 ===
  * 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).

===== Servicios y Servidores Generales =====
Se han definido los siguientes servicios y servidores generales los cuales pueden ser utilizados segun la necesidad y complejidad del desarrollo.

==== 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 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]]