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
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:
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.
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ÑOL | Vicepresidencia |
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:
alias | pass |
---|---|
adminOesia | adminOesia |
3.4.2.- Consulta de logs
Entorno | Ubicación de los logs | Observaciones |
---|---|---|
PAEGA - Localhost | C:\logs\app\arca\ | |
PAEGA - Desarrollo | http://integracion/eapl_priv/sgi1?a=listar&file=%2Flogs%2Fapp%2Farca | |
PAEGA – Integración | ||
DGA - desaplicaciones | ||
DGA - preaplicaciones | ||
DGA- aplicaciones (PRO) |