Muestra las diferencias entre dos versiones de la página.
Próxima revisión | Revisión previa | ||
ada:howto:sicoferp:factory:integrations:deployspringboot [2022/03/22 12:21] administraidor creado |
ada:howto:sicoferp:factory:integrations:deployspringboot [2022/04/04 20:20] (actual) administraidor |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
- | ==== Pasos Previos: Generar war (IDE Eclipse y Spring Tools) ==== | + | ====== Fábrica - Servicios Web - Integraciones - Despliegue Springboot ====== |
- | 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)). | + | Esta sección esta dedicada al depsliegue de los Servicios Springboot. |
- | * Ubiquese en la reaíz del proyecto, click derecho -> Run as... -> Maven builds... | + | ===== Generar Compilado (IDE Eclipse y Spring Tools) ===== |
- | * 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. | + | |
+ | === Pasos Previos === | ||
+ | * La generación del ejecutable dependerá de la configuración del POM el cual se define en la etiqueta <packaging> | ||
+ | * Se asume que el lector tiene conocimeintos previos del uso del lenguaje Java e IDE (Eclipse, Spring Tools) | ||
+ | |||
+ | ==== Generar compilado war ==== | ||
+ | Siga los siguientes pasos: | ||
+ | |||
+ | * Ubiquese en la raíz del proyecto (Carpeta principal con el nombre del proyecto), | ||
+ | * Click derecho para visualizar un menu emerguente y seleccione la opción -> Run as... -> Maven builds... | ||
+ | * Aparece un formulario flotante. En la casilla **Goals** ingrese el comando: **clean install -DskipTests** para generar el war((Tambien puede utilizar en su lugar la instrucción **clean install** si desea ejecutar las pruebas unitarias.)) | ||
* Al finalizar el proceso si no hay errores se generará el war en el directorio target del proyecto. | * Al finalizar el proceso si no hay errores se generará el war en el directorio target del proyecto. | ||
Línea 9: | Línea 19: | ||
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. | 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 ==== | + | ==== Generar compilado jar ==== |
- | Actualmente solo hay servidor de desarrollo: | + | Siga los siguientes pasos: |
+ | |||
+ | * Ubiquese en la raíz del proyecto (Carpeta principal con el nombre del proyecto), | ||
+ | * Click derecho para visualizar un menu emerguente y seleccione la opción -> Run as... -> Maven builds... | ||
+ | * Aparece un formulario flotante. En la casilla **Goals** ingrese el comando: **clean package -DskipTests** para generar el jar((Tambien puede utilizar en su lugar la instrucción **clean package** si desea ejecutar las pruebas unitarias.)) | ||
+ | * Al finalizar el proceso si no hay errores se generará el jar en el directorio target del proyecto. | ||
+ | |||
+ | === Nota === | ||
+ | Para ubicar el jar en el directorio del equipo desde el proyecto seleccione el jar con click derecho y vaya a propiedades al visualizar la ventana emergente se verá la ubicación del archivo. | ||
+ | |||
+ | |||
+ | ===== Despliegue war en servidor ===== | ||
+ | |||
+ | === Pasos Previos === | ||
+ | * Por lo general el war se genera con la estructura del POM y en la mayoria de los casos se genera el nombre de la siguiente forma **Nombre Servicio-0.0.1-SNAPSHOT.war** se recomienda modificar el nombre del archivo generado a **Nombre Servicio.war** ya que ese será el path base utilizado en el despliegue. | ||
+ | * Se asume que el servidor para despliegue war es un servidor wildfly. | ||
+ | |||
+ | Siga los siguientes pasos: | ||
+ | |||
+ | - Acceder al servidor de despliegue por WSCP o SSH | ||
+ | - Si existe un despliegue previo, borre el archivo **Nombre Servicio.war** y espere que el archivo de despliegue quede inválido (Haga caso omiso de este punto si es la primera vez). | ||
+ | - Si existe un despliegue previo, borre el archivo de despliegue **Nombre Servicio.war**.undeploy (Haga caso omiso de este punto si es la primera vez). | ||
+ | - Copie el nuevo war en la ruta de despliegue del servidor por lo general termina en **/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 **Nombre Servicio.war**.deployed. Si falla este proceso debe ir al paso 2. | ||
+ | - Por último desde un navegador ingrese la url **http://Ip servidor:Puerto/Nombre Servicio/** y debera visualizar el contenido inicial del servicio indicando que el despliegue fué realizado correctamente. | ||
+ | |||
+ | ===== Despliegue jar en servidor ===== | ||
+ | |||
+ | === Pasos Previos === | ||
+ | * Por lo general el jar se genera con la estructura del POM y en la mayoria de los casos se genera el nombre de la siguiente forma **Nombre Servicio-0.0.1-SNAPSHOT.jar** se recomienda modificar el nombre del archivo generado a **Nombre Servicio.jar** ya que ese será el path base utilizado en el despliegue. | ||
+ | * Este método de despliegue contiene embebido su propio servidor web por lo tanto el puerto utilziado en el properties será el utilizado en el despliegue y debe asegurarse que está disponible. | ||
+ | |||
+ | Siga los siguientes pasos: | ||
+ | |||
+ | - Acceder al servidor de despliegue por WSCP o SSH | ||
+ | - Si existe un despliegue previo debe identificar el proceso en ejecución con el comentado ps -aux | grep **Nombre Servicio.jar** y si existe se devolver un **identificador númerico**. | ||
+ | - Si existe un despliegue previo ejecute el comando kill -**identificador númerico** para quitar el proceso. - | ||
+ | - Borre el archivo **Nombre Servicio.jar** | ||
+ | - Copie el nuevo jar en la ruta de despliegue del servidor. Se recomienda utilizar WSCP por su interfaz gráfica. | ||
+ | - Ubiquese en la ruta donde copio el jar y ejecute el comando nohup java -jar **Nombre Servicio.jar** & | ||
+ | - Por último desde un navegador ingrese la url **http://Ip servidor:Puerto Properties** y debera visualizar el contenido inicial del servicio indicando que el despliegue fué realizado correctamente. | ||
+ | |||
+ | ===== Despliegue/Ejecutar jar en local ===== | ||
+ | |||
+ | === Pasos Previos === | ||
+ | * Por lo general el jar se genera con la estructura del POM y en la mayoria de los casos se genera el nombre de la siguiente forma **Nombre Servicio-0.0.1-SNAPSHOT.jar** se recomienda modificar el nombre del archivo generado a **Nombre Servicio.jar** ya que ese será el path base utilizado en el despliegue. | ||
+ | * Este método de despliegue contiene embebido su propio servidor web por lo tanto el puerto utiliziado en el properties será el utilizado en el despliegue y debe asegurarse que está disponible. | ||
+ | |||
+ | Siga los siguientes pasos: | ||
+ | |||
+ | - Acceder a la ruta donde se genero el jar. | ||
+ | - Ejecute el comando java -jar **Nombre Servicio.jar** | ||
+ | - Por último desde un navegador ingrese la url **http://localhost:Puerto** y debera visualizar el contenido inicial del servicio indicando que el despliegue fué realizado correctamente. | ||
- | - Acceder al servidor de despliegue por WSCP o SSH: IP: **10.1.20.84**, Usuario:**wildfly23**, Password:**vwdf5ELGR5j7v** | + | [[ada:howto:sicoferp:factory:integrations|←Volver atras]] |
- | - 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. | + | |