Wiki

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

====== Fábrica - Servicios Web - Integraciones - MicroservicioConfigApp  ======
Este servicio pemrite generar y proveer configuraciones centralizadas para microservicios. Actualmente soporta la siguientes configuraciones:

* Registro de aplicaciones: Permite registrar configuraciones de aplicaciones las cuales a su vez permitirán el resto de configuraciones. Todas las demas confguraciones van a requerir que el microservicio que la utilice existe como configuración de aplicación.
  * Configuraciones centralizadas de Datasources: Provee configuraciones de conexiones a origenes de datos (DB - Datasources) a los microservicios. Estos previamente deben parametrizar cuales datasources pueden ser utilizados por el microservicios.
  * Configuraciones de parámetros centralizados: Provee configuraciones de parámetros a los microservicios, estos pueden ser: Texto, Número, Fecha, Texto grande (Lob) y Configuraciones en formato json.

===== Descripción del Servicio =====

^Nombre^Descripción^Tipo Servicio^Tecnología^Lenguaje^Tipo Desarrollo^Versión Desarrollo^Archivo de Configuración^
|MicroservicioConfigApp|Microservicio que gestiona y provee configuraciones centralizadas a los microservicios.|Rest|SpringBoot 2.6.3|Java 11.0.315|Nuevo|11.6.0.1|application.properties|
^Tipo Empaquetado^Gestor de Dependencias^Servidor de Despliegue^IDE Proyecto^Tipo Repositorio^Url Desarrollo^Url Calidad^Url Producción^
|war|Maven 3.8.1|WildFly 20|SpringTools 4.6|Subversión|[[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/core/Microservicios/MicroservicioConfigApp|SVN branches]]|[[http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/trunk/development/core/Microservicios/MicroservicioConfigApp|SVN trunk]]|[[|SVN tags]]|
^Dependencias^^^^^^^^
^groupId^artifactId^^version^scope^optional^Descripción^^
|org.springframework.boot|spring-boot-starter-data-jpa||N/A|N/A|N/A|API de persistencia||
|org.springframework.boot|spring-boot-starter-data-rest||N/A|N/A|N/A|API de mapeo de rutas||
|org.springframework.boot|spring-boot-starter-web||N/A|N/A|N/A|Core Servicios Web||
|org.springframework.boot|spring-boot-devtools||N/A|runtime|true|Recarga de aplicaciones||
|org.projectlombok|lombok||N/A|N/A|true|API de anotaciones para reducción de código||
|org.springframework.cloud|spring-cloud-sleuth-zipkin||N/A|N/A|true|API de gestión de logs centralizados||
|org.springframework.boot|spring-boot-starter-test||N/A|test|N/A|Core Springboot||
|com.oracle.database.jdbc|ojdbc8||N/A|runtime|N/A|Driver para bases de datos Oracle||
|org.postgresql|webjars-locator-jboss-vfs||0.1.0|N/A|N/A|Plugins para  despliegue en Wildfly||
|org.springframework.boot|spring-boot-starter-tomcat||N/A|provided|N/A|Servidor Embebido Tomcat||
|org.apache.maven.plugins|maven-compiler-plugin||3.8.1|N/A|N/A|Gestor de dependencias||
|org.springdoc|springdoc-openapi-ui||1.5.12|N/A|N/A|Plugins para generar documentación Swagger||
|org.springframework.boot|spring-boot-starter||N/A|N/A|N/A|Core Springboot||
^Documentación Operaciones^^^^^^^^
^Tipo^Documentación^^^^^^Visor^
|Swagger|http://srv-appeon-000-w23.adacsc.co/MicroservicioConfigApp/api-docs||||||https://editor.swagger.io/|
|Javadoc|http://adacsc.co:1443/svn/repository/ADA/SICOFERP/fuentes/branches/development/core/Microservicios/MicroservicioConfigApp/doc/index.html||||||Navegador Web|
^Ambientes de Despliegue^^^^^^^^
^Tipo^Url^^Observaciones^^^^^
|Desarrollo:|http://localhost:8080||Ambiente de desarrollo|||||
|Calidad:|http://srv-appeon-000-w23.adacsc.co/MicroservicioConfigApp||Ambiente de validación|||||
|Producción:| ||Ambiente de producción|||||

===== Información Adicional =====

===== Despliegue =====

==== Requisitos Técnicos Servidor ====

* Servidor Wildlfy 20 o superior
  * Java 11 o OpenJDK 11
  * S.O. Linux
  * Ram 4GB o superior
  * Disco Duro 64 GB
  * Publicar la URL y Puerto del WildFly

==== Pasos Previos: Generar war (IDE Eclipse y Spring Tools) ====
El proyecto está configurado para generar compilable war. Siga los siguientes pasos para generarlo((Se asume que el lector tiene conocimeintos previos del uso del lenguaje Java e IDE utilizado)).

* Ubiquese en la reaíz del proyecto, click derecho -> Run as... -> Maven builds...
  * En la casilla **Goals** ingrese el comando: **clean install** para generar el war. Tambien puede utilizar en su lugar la insttrucción **clean install -DskipTests** si no desea ejecutar las pruebas unitarias.
  * Al finalizar el proceso si no hay errores se generará el war en el directorio target del proyecto.

=== Nota ===
Para ubicar el war en el directorio del equipo desde el proyecto seleccione el war con click derecho y vaya a propiedades al visualizar la ventana emergente se verá la ubicación del archivo.

==== Despliegue en el servidor ====
Actualmente solo hay servidor de desarrollo:

- Acceder al servidor de despliegue por WSCP o SSH: IP: **10.1.20.84**, Usuario:**wildfly23**, Password:**vwdf5ELGR5j7v**
  - Borre el archivo SicofMobileServiceADA.war y espere que el archivo de despliegue quede inválido.
  - Borre el archivo de despliegue SicofMobileServiceADA.war.undeploy
  - Copie el nuevo war en la ruta **/opt/wildfly23/standalone/deployments** se recomienda utilizar WSCP por su interfaz gráfica. Debe esperar mientras se sube el despliegue al servidor el cual terminará correctamente si se crea el archivo SicofMobileServiceADA.war.deployed Si falla este proceso debe ir al paso 2.
  - Por último desde un navegador ingrese la url **http://10.1.20.84:3131/SicofMobileServiceADA/api/** y debera visualizar el mensaje **Online!!!** indicando que el despliegue fué realizado correctamente.

=== Notas ===

* Debe contar con VPN
  * Ejemplo de Consumo Login Multiempresa: http://10.1.20.84:3131/SicofMobileServiceADA/api/GetServicio?ping=desarrollo&nombreServicio=Login&callback=__ng_jsonp__.__req0.finished&separador=,&parametros=SICOF,1234,null,null,null&codigoMEmpresa=9999999999
  * Ejemplo de consumo Empresas: http://10.1.20.84:3131/SicofMobileServiceADA/api/GetServicio?ping=fosemed&nombreServicio=GetEmpresas&callback=__ng_jsonp__.__req0.finished&separador=,&parametros=

[[ada:howto:sicoferp:factory:integrations|←Volver atrás]]

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página