/
3.- Información técnica de desarrollo

3.- Información técnica de desarrollo

3.1.- Desarrollo: configuración y despliegue en weblogic - local

3.1.1.- Configuración nodejs

Hacemos doble click sobre el instalador de la versión 10.15.1 de nodejs en la ruta S:\TTO\node-v10.15.1-x64.msi, pulsamos sobre el botón de Ejecutar, Next en la siguiente pantalla y por ultimo aceptamos las condiciones de uso. En el siguiente paso nos aparecerá una pantalla donde podemos elegir la ruta en la que queremos instalar nodejs.


Elegimos la ruta que deseemos de nuestro equipo y pulsamos Next. En la siguiente pantalla nos aparecerán los diferentes elementos de nodejs que se nos van a instalar.


Pulsamos Next y a install, esperamos a que la instalación se complete y por último le damos a finish. Con esto tendremos nodejs instalado y añadido a nuestro path.

3.1.2.- Configuración Angular Cli (https://cli.angular.io/)

Angular CLI es la forma más cómoda para empezar a desarrollar aplicaciones web, móvil con Angular X, es una herramienta de linea de comandos que facilita la creación, generación, ejecución, testing y deploy.

Abrimos el cmd de windows y ejecutamos la siguiente instrucción

cmd
npm install -g @angular/cli@6.2.9


Una vez se ejecute, empezará a realizar una gran cantidad de descargas e instalaciones de paquetes. Es necesario tener un poco de paciencia y esperar a que termine.


Para actualizarlo:

cmd
npm uninstall -g @angular-cli
npm cache clean
npm cache verify
npm install -g @angular/cli@latest


3.1.3.- Configuración de equipo

Recursos compartidos del proyecto

Será necesario tener los siguientes recursos en nuestro equipo la carpeta C:\compartido\app\arca 

Permiso PAU - IP's

Será necesario dar de alta en el PAU la IP de nuestro equipo, para que no de error de autentificación.

Configuración de Workspace

Para gestionar el repositorio GIT, tenemos estas herramientas de trabajo. En "C:\Workspace\WS_Weblogic", crear dos carpetas llamadas "arca_core" y "arca_front", donde descargaremos el proyecto.

 Como clonar el proyecto con Sourcetree

Para poder descargar (clonar) el código del repositorio, usaremos el programa Sourcetree

Abrimos el programa y pulsaremos sobre el botón "Clone".

Aparece este menú un Sourcetree:

Pulsaremos sobre "remote account", iniciamos sesión con nuestro usuario de Bitbucket y en el siguiente menú buscaremos arca_core, entonces presionamos "Clone".

Volveremos al menú anterior y nos aparece la información de la clonación del proyecto.

  • Modificamos la carpeta destino del repositorio y su nombre.
  • En las opciones avanzadas, debemos cambiar a la rama de desarrollo que tengamos en ese momento.

Entonces pulsaremos sobre "Clone" y se descargara el proyecto en nuestro equipo.

Repetiremos el proceso para descargar el proyecto frontal "arca_front".


3.1.4.- Configuración IDE para ARCA_CORE

Una vez tengamos instalado Eclipse y Weblogic y configurado JAVA 1.7 . Nos importamos el proyecto a Eclipse.

Dentro del proyecto descargado, tenemos un entregable generado en C:\Workspace\WS_Weblogic\arca_core, en la carpeta src/conf/properties se encuentran, separados por entornos, los archivos con las propiedades de la aplicación. Para hacer funcionar la aplicación se debe copiar el contenido a C:\config\arca.

También hay que copiar el contenido de la carpeta src/conf/compartido a C:\compartido\app\arca.

Ademas, en la carpeta src/conf/data-sources se encuentran, separados por entornos, la configuración del DataSource necesario por el servidor WebLogic para conectar con la base de datos. Para instalar el DataSource ir a Servicios→Origenes de datos en la consola de administrador de Weblogic, seleccione "Nuevo"→"Origen de datos genérico" y siga los pasos que salgan en pantalla

Para desplegar el core en nuestro entorno local, hay que generar arca_core.ear y desplegarlo en nuestro Weblogic.

3.1.5.- Configuración IDE para frontales

Visual Studio Code

La solución de Visual Studio Code, puede ser la mas recomendable, ya que el plugin de eclipse consume mucha mas memoria. Para usar el Visual Studio Code accederemos a la siguiente URL:

Descargaremos la versión instalable del programa o el .zip. Una vez se haya instalado veremos una pantalla similar a la siguiente imagen:

Importación del proyecto Angular


Desde esta pantalla pulsaremos en File => Open Folder y seleccionaremos el directorio raíz del proyecto Angular. (C:\Workspace\WS_Weblogic\ARCA_FRONT)
NOTA: Para poder realizar el autoimportado de los componentes es necesario instalar una extensión. Por lo que se deberá pulsar la tecla:

  • Ctrl + p

y escribir ext install auto-import pulsar la tecla enter y en el menú lateral de la izquierda aparecerá la extensión a instalar.

Ejecución de la aplicación

Para ejecutar la aplicación dentro del Visual Studio, puedes desplegar en el menú: Ver → Terminal Integrado

Allí para compilar por primera vez, escribir el siguiente comando:

npm install


Esperar con paciencia, que termine, luego ejecutaremos el siguiente comando:

ng serve

Si todo funciona correctamente, en el terminar deberá aparecer un mensaje como el siguiente:

Comprobar la ejecución de la aplicación

Si una vez, que se ha lanzado el comando anterior y la compilación funciona correctamente, en el navegador escribimos: http://localhost:4200, y nos debería aparecer una pantalla como la siguiente:


3.2.- Generar cliente java

Actualmente, no hay cliente java para integradores.

3.3.- Entregable

La forma de desplegar la aplicación en los entornos PAEGA y AST es mediante el sistema de "Entrega continua". La creación del entregable esta automatizado mediante el archivo Jenkinsfile, de forma que al mergear cambios en el branch release/integracion se genera y se despliega automáticamente en integración. Este modo de trabajo esta definido aquí.

De todos modos, podemos generar el entregable lanzando la tarea de ant generar-entregable.xml, haciendo click derecho y Run As > Ant Build. Esto generará la estructura de carpetas entregable en el mismo módulo del workspace donde se ejecuta. En ella se incluirán las librerías, el código fuente y todos los archivos de configuración para los entornos donde se pueden desplegar.

Para compilar será necesario entrar dentro de la carpeta entregable y ejecutar un comando ant con parámetros. En este comando se indicará el entorno para el que se quiere compilar (-Dentorno), la localización de las librerías del servidor weblogic (-Dsrv.lib), las librerías instaladas en el servidor weblogic (-Dcmn.lib) y el lugar donde se registrará el log de la compilación (-l build_entregable.log).

buildEntregable.bat

@SET JAVA_HOME=C:/java/jdk1.7.0_72
@SET ANT_HOME=C:/apache-ant-1.9.6
@SET SRV_LIB=P:/ENTREGABLES/Weblogic-Librerias/Completas
@SET CMN_LIB=P:/ENTREGABLES/Weblogic-Librerias/Comunes
 
%ANT_HOME%/bin/ant -Dsrv.lib=%SRV_LIB% -Dcmn.lib=%CMN_LIB% -l build_entregable.log
pause

Una vez ejecutado el comando de forma satisfactoria se habrá generado el archivo de build_entregable.log donde se estará registrada la traza de ejecución; la carpeta build en la que se encontrarán restos de la compilación, la definición de los data-sources (conf/data-sources), los properties de la aplicación (conf/properties); y dist, con el ear generado para desplegar.

3.4.- Recursos

3.4.1.- Usuarios y roles de pruebas

Se ha solicitado un certificado electrónico del usuario de pruebas JUAN ESPAÑOL ESPAÑOL. Con el objetivo de obtener dicho certificado, se debe acceder a la carpeta Z:\Usuarios Cl@ve\Usuarios de pruebas y copiar el primer certificado con DNI 00000000T en un sitio seguro en el equipo del desarrollador.


Usuario
Organismo
Rol
00000000T - JUAN ESPAÑOL ESPAÑOLVicepresidencia

A continuación, hay que instalar el certificado en el equipo del desarrollador.

Para cualquier duda respecto a la instalación del certificado, entrar en MFE o en las las páginas oficiales.


También se dispone de un usuario admin:

aliaspass
adminOesiaadminOesia


3.4.2.- Consulta de logs


Entorno 
Ubicación de los logs
Observaciones
PAEGA - LocalhostC:\logs\app\arca\
PAEGA - Desarrollohttp://integracion/eapl_priv/sgi1?a=listar&file=%2Flogs%2Fapp%2Farca
PAEGA – Integración



DGA - desaplicaciones



DGA - preaplicaciones



DGA- aplicaciones (PRO)









Related content