Skip to content

Instalación Entorno

Jump to bottom
Octavio Montero edited this page Nov 19, 2020 · 10 revisions

Descargas

A continuación se detalla el software necesario y/o de utilidad para los desarrollos en el proyecto

  • Java 11 Disponible aquí
  • IDE IntelliJ Idea Community o Ultimate a partir del 2019. Se recomienda el uso de la versión Ultimate (con licencia) debido a la compatiblidad con ciertos plugins que nos facilitarán el trabajo. También recomendamos su descarga a través de la herramienta ToolBox la cual nos mantendrá siempre actualizados
  • Git: Para la gestión del código, teniendo en cuenta que podemos usar tanto el cliente para git como el plugin para IntelliJ intentando siempre preguntar al equipo para que trabajemos de la forma mas estándar posible.
  • Maven: En su última versión (https://maven.apache.org/download.cgi)

Instalar y configurar Java 11

Para la instalación de la JDK usaremos los procesos básicos, Una vez descargada la jdk y descomprimida, añadiremos la ruta (sin olvidar el /bin) a nuestro path

Para asegurarnos que la instalación se ha realizado correctamente probaremos a lanzar desde la terminal el comando java -version

[IMAGEN]

Instalar y configurar IntelliJ

El proyecto está preparado para desplegar tanto en Eclipse como IntelliJ (Abstenerse de usar NetBeans). En este caso, se recomienda usar IntelliJ por ser el que usa prácticamente todo el equipo de desarrollo. El proceso de instalación es bastante sencillo e intuitivo. Abrimos la herramienta ToolBox y buscamos el IDE para Java IntelliJ en su versión Community o Ultimate (mejor opción) y instalamos.

Para configurar el IDE y antes de continuar debemos seguir las indicaciones de este apartado.

Instalar y configurar repositorio

Para la gestión del código, trabajamos con la solución de Azure Devops (Repo) basada en Git cuya URL de clonación del proyecto HUB es:

IMPORANTE En el caso que se desee trabajar con algún cliente para git saber que habrá que generar un PAT (Personal Access Token) en Azure devops para su correcta autenticación (Solicitar responsable)

Instalar y configurar maven

Una vez descargado, descomprimir el fichero en la ruta de instalación de maven en nuestro equipo. De nuevo configuraremos la variable de entorno par poder lanzarlo desde consola.

Comprobaremos que está instalado lanzando el comando mvn -version

[IMAGEN] Una vez instalado, pasamos a la configuración de nuestro settings a nivel general. Para ello, en nuestra carpeta de usuario del sistema (C:/Users/{nombre_usuario} para Windows o /home/{nombre_usuario} en ubuntu) vamos a localizar la carpeta .m2 y en su interior crearemos (en caso que no exista) o modificaremos el fichero settings.xml añadiendo el siguiente contenido, respectivo a los perfiles y las librerías propias de arquitectura de W2M (Estas librerías no están en maven central):

<id>Artifact</id>
   <activation>
      <activeByDefault>true</activeByDefault>
   </activation>
   <repositories>
      <repository>
         <id>releases</id>
         <url>https://pkgs.dev.azure.com/world2meet/_packaging/releases/maven/v1</url>
         <releases>
            <enabled>true</enabled>
         </releases>
         <snapshots>
            <enabled>false</enabled>
         </snapshots>
      </repository>
      <repository>
         <id>snapshots</id>
         <url>https://pkgs.dev.azure.com/world2meet/_packaging/snapshots/maven/v1</url>
         <releases>
            <enabled>false</enabled>
         </releases>
         <snapshots>
            <enabled>true</enabled>
         </snapshots>
      </repository>
   </repositories>
</profile>

Compilación

Por regla general IntelliJ descarga las librerías de forma automática. De todos modos tenemos la opción del Maven Update (Obligatorio haber instalado el plugin de maven para IntelliJ) Una vez todas las librerías se han descargado, podemos proceder a compilar el proyecto de la manera normal:

mvn clean package Bien desde la terminal de IntelliJ o bien a través del plugin de maven para Intelij (Botón derecho del proyecto > Run Maven > clean y Botón derecho del proyecto > Run Maven > package.

[IMAGEN]

Para asegurarnos que ha ido bien esa descarga debemos haber revisado el log y comprobado que las librerías se van descargando de nuestro artifactory.

Despliegue

Se arranca con el boot de springboot, por defecto tira del perfil dev, está todo configurado para que arranque en local sin tener que modificar nada, solo tener en cuenta que es necesario estar en la red de w2m para las conexiones a bbdd.

Ahora que el equipo es mas grande, se va a plantear el dockerizar una imagen con la base de datos y tener disponible para las conexiones en local. Pero por ahora siguen estando conectadas al entorno de dev de W2M.

Servicio Web

Si no configuramos nada y dejamos por defecto, la aplicación automáticamente desplegará en el puerto 8080 y tendrá público un Swagger (para más información de swagger ver aquí) en la direcicón:

Clone this wiki locally