====== Fábrica - Servicios Web - Integraciones - Despliegue Springboot ====== Esta sección esta dedicada al depsliegue de los Servicios Springboot. ===== Generar Compilado (IDE Eclipse y Spring Tools) ===== === Pasos Previos === * La generación del ejecutable dependerá de la configuración del POM el cual se define en la etiqueta * 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. === Nota === 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. ==== Generar compilado jar ==== 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. [[ada:howto:sicoferp:factory:integrations|←Volver atras]]