Anexo Instalacion Ubuntu - eliizquierdo/material_programacion

Visual Studio Code + Maven + Tomcat 10

Esta guía te ayudará a configurar un entorno de desarrollo completo para Java Web en Ubuntu, usando Visual Studio Code, Maven y Apache Tomcat 10.

🤖 ¿Preferís automatizarlo? Hay un script que hace todos estos pasos por vos. 👉 Ver guía interactiva

🛠️ Paso 1: Instalamos Visual Studio Code y extensiones para Java Web

1.1 Descargamos e instalamos VSCode

Opción 1: Desde Snap Store (Recomendada)

sudo snap install code --classic

Opción 2: Desde repositorio oficial de Microsoft

# Agregar clave GPG de Microsoft
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/

# Agregar repositorio
echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list

# Actualizar e instalar
sudo apt update
sudo apt install code

1.2 Instalamos extensiones necesarias

Desde la barra lateral izquierda de VSCode, hacemos clic en el ícono de Extensiones.

Buscamos e instalamos, una por una:

Language Support for Java (de Red Hat) — motor de Java: autocompletado, detección de errores, etc.
Debugger for Java — para poder correr/debuggear las clases Java
JSP Language Support — sintaxis y autocompletado en los .jsp
Database Client JDBC — para trabajar con bases de datos
MySQL — para trabajar con bases de datos

💡 Para instalar una extensión, se busca en el marketplace y una vez encontrada se presiona Install.

✅ Paso 2: Instalamos el JDK 17

2.1 Actualizar repositorios del sistema

sudo apt update

2.2 Instalar OpenJDK 17

sudo apt install openjdk-17-jdk

2.3 Verificar instalación

java -version
javac -version

2.4 Configurar versión predeterminada (si tienes múltiples versiones)

sudo update-alternatives --config java
sudo update-alternatives --config javac

⚠️ La ubicación típica del JDK en Ubuntu es: /usr/lib/jvm/java-17-openjdk-amd64

⚙️ Paso 3: Instalamos Apache Maven

Opción 1: Instalación desde repositorios (Recomendada)

sudo apt install maven

Opción 2: Instalación manual

# Descargar Maven
wget https://archive.apache.org/dist/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.tar.gz

# Extraer a directorio del sistema
sudo tar -xzf apache-maven-3.8.8-bin.tar.gz -C /opt/

# Crear enlace simbólico
sudo ln -s /opt/apache-maven-3.8.8 /opt/maven

🧹 Paso 4: Configuramos las variables de entorno de Java y Maven

4.1 Editar archivo de configuración del perfil

nano ~/.bashrc

4.2 Agregar variables de entorno

Agregar al final del archivo ~/.bashrc:

# Configuración Java y Maven
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$PATH:$JAVA_HOME/bin

# Solo si instalaste Maven manualmente
export MAVEN_HOME=/opt/maven
export PATH=$PATH:$MAVEN_HOME/bin

4.3 Recargar configuración

source ~/.bashrc

4.4 Verificar configuración

java -version
mvn -version

💡 Si instalaste Maven desde repositorios, no necesitas configurar MAVEN_HOME.

🐱 Paso 5: Instalamos y configuramos Tomcat 10

5.1 Crear usuario dedicado para Tomcat

sudo useradd -r -m -U -d /opt/tomcat -s /bin/false tomcat

5.2 Descargar Tomcat 10

cd /tmp
wget https://archive.apache.org/dist/tomcat/tomcat-10/v10.1.57/bin/apache-tomcat-10.1.57.tar.gz

5.3 Extraer e instalar

# Extraer a directorio final
sudo tar -xzf apache-tomcat-10.1.57.tar.gz -C /opt/tomcat --strip-components=1

# Cambiar propietario
sudo chown -R tomcat: /opt/tomcat

# Hacer ejecutables los scripts
sudo chmod +x /opt/tomcat/bin/*.sh

5.4 Configurar variable de entorno para Tomcat

echo 'export CATALINA_HOME=/opt/tomcat' | sudo tee -a /etc/environment

5.5 (OPCIONAL) Iniciar el servidor Tomcat

sudo /opt/tomcat/bin/startup.sh

Verificar en el navegador:http://localhost:8080

5.6 (OPCIONAL) Parar el servidor Tomcat

sudo /opt/tomcat/bin/shutdown.sh

🚀 Probamos ejecutar el proyecto demo

Paso 1: Abrir el proyecto en VSCode

# Navegar a la carpeta del proyecto
cd /ruta/del/proyecto

# Abrir VSCode en la carpeta actual
code .

Paso 2: Desplegar el proyecto a Tomcat

Desde la terminal integrada de VSCode (Ctrl+ñ para visualizarla si no está visible):

mvn clean package
mvn cargo:run

💡 Esto requiere el plugin cargo-maven3-plugin configurado en el pom.xml, apuntando a /opt/tomcat como Tomcat existente (tipo existing).

Paso 3: Verificar en el navegador

http://localhost:8080/demo

🎯 Comandos útiles para el desarrollo diario

Gestión de Tomcat

# Iniciar Tomcat standalone
sudo /opt/tomcat/bin/startup.sh

# Parar Tomcat standalone
sudo /opt/tomcat/bin/shutdown.sh

# Ver logs de Tomcat
sudo tail -f /opt/tomcat/logs/catalina.out

Comandos Maven útiles

# Limpiar y compilar proyecto
mvn clean compile

# Ejecutar pruebas
mvn test

# Crear WAR
mvn package

# Desplegar en el Tomcat instalado
mvn cargo:run

# Limpiar completamente el proyecto
mvn clean

Verificación del entorno

# Verificar versiones instaladas
java -version
javac -version
mvn -version

# Ver variables de entorno
echo $JAVA_HOME
echo $CATALINA_HOME
echo $PATH

🔧 Solución de problemas comunes

Error: JAVA_HOME no encontrado

# Verificar ruta correcta
ls /usr/lib/jvm/
# Ajustar la variable en ~/.bashrc con la ruta correcta

Error: Puerto 8080 en uso

# Ver qué proceso usa el puerto
sudo lsof -i :8080

# Matar proceso si es necesario
sudo kill -9 <PID>

Maven no encuentra dependencias

# Limpiar repositorio local
rm -rf ~/.m2/repository

# Forzar descarga de dependencias
mvn dependency:purge-local-repository

Permisos de Tomcat

# Asegurar permisos correctos
sudo chown -R tomcat: /opt/tomcat
sudo chmod +x /opt/tomcat/bin/*.sh

📋 Resumen de ubicaciones importantes

Componente	Ubicación en Ubuntu
Java JDK	`/usr/lib/jvm/java-17-openjdk-amd64`
Maven (repositorio)	`/usr/share/maven`
Maven (manual)	`/opt/maven`
Tomcat	`/opt/tomcat`
Variables de entorno	`~/.bashrc`
Repositorio Maven local	`~/.m2/repository`

🎉 ¡Listo!

Ahora tienes un entorno de desarrollo Java Web completo en Ubuntu, integrado con:

✅ Visual Studio Code con extensiones Java
✅ OpenJDK 17
✅ Apache Maven
✅ Apache Tomcat 10
✅ Variables de entorno configuradas

Puedes comenzar a desarrollar aplicaciones web Java con JSP, Servlets y Maven como gestor de dependencias.

📚 Referencias adicionales

← Resumen Tema 4 · 🏠 Inicio · Resumen completo de Servlets →