Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
ada:howto:sicoferp:factory:migracionsicoferp:process:backend:guiaconfiguraciondesarrollo [2020/04/15 16:51] carlos.torres |
ada:howto:sicoferp:factory:migracionsicoferp:process:backend:guiaconfiguraciondesarrollo [2020/05/19 12:06] (actual) carlos.torres [Nombre del Microservicio y configuración POM (Maven)] |
||
---|---|---|---|
Línea 21: | Línea 21: | ||
* Configuración Centralizada: Archivos [[https://es.wikipedia.org/wiki/YAML|Yaml]] | * Configuración Centralizada: Archivos [[https://es.wikipedia.org/wiki/YAML|Yaml]] | ||
* Configuración Local: Archivos [[https://en.wikipedia.org/wiki/.properties|Properties]] | * Configuración Local: Archivos [[https://en.wikipedia.org/wiki/.properties|Properties]] | ||
+ | |||
+ | ==== Nombre del Microservicio y configuración POM (Maven) ==== | ||
+ | * Todo microservicio que represente lógica del negocio debe iniciar con la palabra Microservicio y terminar con la palabra ADA y debe usar nomeclatura //**Camel Case**//((https://es.wikipedia.org/wiki/Camel_case)) sin signos de puntuación. **Ejemplo: MicroservicioPruebaModelADA** | ||
+ | * El **groupId** del proyecto debe ser el nombre del paquete principal. **Ejemplo: <groupId>co.ada.test.prueba</groupId>** | ||
+ | * El **artifactId** y **name** deben ser iguales al nombre del proyecto. **Ejemplo: <artifactId>MicroservicioPruebaModelADA</artifactId>** y **<name>MicroservicioPruebaModel</name>** | ||
+ | * Todo microservicio debe contener una descripción. **Ejemplo: <description>Microservico de prueba para conexiones multiples</description>** | ||
+ | * Todo microservicio debe definir empaquetado tipo jar. **Ejemplo: <packaging>jar</packaging>** | ||
+ | * Todo desarrollador que actualice el microservicio debe registrarse en el POM en la etiqueta Developer. | ||
+ | |||
+ | //**Ejemplo Sección Nombre:**// | ||
+ | <code xml> | ||
+ | <groupId>co.ada.test.microservicio.pruebamodel</groupId> | ||
+ | <artifactId>MicroservicioPruebaModelADA</artifactId> | ||
+ | <version>0.0.1-SNAPSHOT</version> | ||
+ | <name>MicroservicioPruebaModelADA</name> | ||
+ | <description>Microservico modelo de prueba</description> | ||
+ | <packaging>jar</packaging> | ||
+ | </code> | ||
+ | |||
+ | //**Ejemplo Sección Developers:**// | ||
+ | <code xml> | ||
+ | <developers> | ||
+ | <developer> | ||
+ | <id>carlos.torres</id> | ||
+ | <name>Carlos Torres</name> | ||
+ | <email>carlos.torres@ada.co</email> | ||
+ | <organization>ADA S.A.</organization> | ||
+ | <organizationUrl>www.ada.co</organizationUrl> | ||
+ | <roles> | ||
+ | <role>architect</role> | ||
+ | <role>developer</role> | ||
+ | </roles> | ||
+ | <timezone>America/Bogota</timezone> | ||
+ | </developer> | ||
+ | </developers> | ||
+ | </code> | ||
+ | |||
==== Reglas de Nombre del Microservicio y Archivo de Configuración ==== | ==== Reglas de Nombre del Microservicio y Archivo de Configuración ==== | ||
Línea 26: | Línea 63: | ||
* El nombre del archivo de configuración centralizada debe ser **bootstrap.yml** | * El nombre del archivo de configuración centralizada debe ser **bootstrap.yml** | ||
* El nombre del archivo de configuracion local debe ser **application.properties** | * El nombre del archivo de configuracion local debe ser **application.properties** | ||
- | * Deben existir configuraciones por cada ambiente de despliegue en el repositorio de configuración y cada archivo de configuración debe indica el perfil los cuales son dev: desarrollo - test: QA - prod: producción **Ejemplo:** Microservicio: Terceros, Paquete Principal: //co.ada.sicof.terceros//, Nombre del Microservicio spring.application.name=co.ada.sicof.terceros, perfil de ambiente de despliegue de desarrollo: dev, Nombre del archivo de configuración: **co.ada.sicof.terceros-dev.yml** | + | * Deben existir configuraciones por cada ambiente de despliegue en el repositorio de configuración y cada archivo de configuración debe indicar el perfil los cuales son dev: desarrollo - test: QA - prod: producción **Ejemplo:** Microservicio: Terceros, Paquete Principal: //co.ada.sicof.terceros//, Nombre del Microservicio spring.application.name=co.ada.sicof.terceros, perfil de ambiente de despliegue de desarrollo: dev, Nombre del archivo de configuración: **co.ada.sicof.terceros-dev.yml** |
* La creación de los archivos de configuración centralizada deben ser solicitados al administrador del repositorio de configuración (Pablo Quintana / Carlos Torres). | * La creación de los archivos de configuración centralizada deben ser solicitados al administrador del repositorio de configuración (Pablo Quintana / Carlos Torres). | ||
Línea 48: | Línea 85: | ||
Esta es la dependencia que debe agregar en el POM del microservicio. | Esta es la dependencia que debe agregar en el POM del microservicio. | ||
- | <code> | + | <code xml> |
<dependency> | <dependency> | ||
<groupId>co.ada.models</groupId> | <groupId>co.ada.models</groupId> |