Wiki

Proceso para la creación de microservicios basados en un arquetipo

Archivos para realizar el proceso:

1. Bajar de la ruta http://10.1.140.120/ada-microservices-ecosystem/config/ecosystemtemplateproject ó http://adacsc.co:1443/svn/repository/ADA/Ecosistema/Java/Core/GeneracionDeArtefactos/ecosystemtemplateproject/ el proyecto base para la generación de artefactos (Arquetipo).
2. Luego abrirla en el ide donde se este trabajando y realizar la ejecución de este comando clean install -DskipTests -U -X ,esto permitirá la actualización de dependencias, instalación y limpieza del código fuente.
3. Luego deberá descargar de esta ruta. http://adacsc.co:1443/svn/repository/ADA/Ecosistema/Java/Core/GeneracionDeArtefactos/ArchivosPrincipalesParaConstruccionDeArtefacto/ los archivos necesarios para la construcción de su arquetipo.

Para empezar a realizar la creación del artefacto

1. Se deberá ubicar en la ruta raíz donde realizo la importación del punto 1 del paso anterior.
2. Cuando se encuentre en la ruta del proyecto, deberá abrir el cmd y ejecutar el siguiente comando mvnw archetype:create-from-project,este proceso realizará la creación del directorio target/archetype/target/
3. Se deberá dirigir a la ruta \ecosystemtemplateproject\target\generated-sources\archetype\target y allí deberá cargar los archivos que descargo en el punto 3 de Archivos para realizar el proceso .
4. En la ruta \ecosystemtemplateproject\target\generated-sources\archetype\target ejecutar el siguiente comando :mvnw install:install-file -Dfile=EcosystemTemplateProject-archetype-0.0.7.jar -DgroupId=com.ada.ecosystem.config -DartifactId=EcosystemTemplateProject-archetype -Dversion=0.0.7 -Dpackaging=jar . (Nota:deberá validar en el proyecto EcosystemTemplateProject en el pom tenga la version correspondiente al .jar ,Por ejemplo en este caso EcosystemTemplateProject-archetype-0.0.7.jar esta en la version 0.0.7 la cual se encuentra parametrizada en el pom) .
5. Luego de haber realizado los pasos anteriores, tendrá parametrizado un artefacto base ,el cual podrá usar para construir artefactos con una estructura base funcional.

Creación de artefacto

1. Deberá crear una carpeta donde tenga los archivos del punto tres del apartado “Archivos para realizar el proceso”,allí deberá abrir el cmd y ejecutar el siguiente comando mvnw archetype:generate -DarchetypeGroupId=com.ada.ecosystem.config -DarchetypeArtifactId=EcosystemTemplateProject-archetype -DarchetypeVersion=0.0.7 (Nota :tenga presente que el apartado del comando DarchetypeVersion=0.0.7 varia acorde de la ejecución del comando del punto 4 del apartado “Para empezar a realizar la creación del artefacto”)
2. Al momento de ejecutar el comando le pedirá lo siguiente:
3. GroupId: El Group ID identifica a un grupo de proyectos relacionados. Es como un “nombre de dominio invertido” que representa a una organización, empresa o proyecto global bajo el cual se encuentran diferentes módulos o artefactos. Ejemplo com.ada.ecosystem.module.presupuesto
4. Artefact id: El Artifact ID es el nombre que se le da a tu proyecto o módulo en particular. Este nombre debe ser único, ya que es el identificador específico para tu artefacto dentro del grupo de proyectos. Ejemplo :OrdenesDePago.

Se debe resaltar que se debe consultar los servicios ya existentes para que no se creen servicios por crear, estos los podrán encontrar en:

1. Version: La versión es el número o etiqueta que asignas a un artefacto para indicar su estado o evolución en el ciclo de vida del proyecto. Define si es una versión estable, una de desarrollo, o una específica que se puede usar en distintos entornos. Ejemplo 0.0.1-SNAPSHOT.
2. Package: El package es una declaración que se encuentra al principio de los archivos Java, indicando en qué “paquete” está organizada una clase en particular. Ejemplo com.ada.ecosystem.module.ordenpago

Luego de haber realizado estos pasos en la carpeta que creó en el paso 1 del la etapa Creación de artefacto,deberá encontrar su proyecto con el nombre que asignó en el artefactId,cabe resaltar que los archivos properties deben estar precreados en git en la ruta http://10.1.140.120/ada-microservices-ecosystem/config/config-data/-/tree/main/dev y adicional a esto en cada archivo properties ,usted deberá modificar la etiqueta spring.application.name colocando el nombre correspondiente a los asignados en el archivo properties, Por ejemplo: si sus archivos properties se llaman ordenes-de-pago.properties,ordenes-de-pago-dev.properties,ordenes-de-pago-prod.properties,ordenes-de-pago-qa.properties, el nombre que usted deberá colocar en los archivos de propiedades de su proyecto será ordenes-de-pago.

Este proceso lo debería realizar la persona que tenga un conocimiento técnico avanzado ,para evitar bloqueos o problemas futuros con los servicios creados.

←Regresar