A0.1 Entrega 1 Apoyo: apartado c

Instalación y verificación del entorno

Disponer de un entorno de desarrollo completo y reproducible: JDK 25, Maven, Git, Docker e IDE instalados y verificados, con la salida guardada como evidencia.

Tu progreso en esta tarea 0/12 pasos completados

1Instalar el JDK 25

Java 25 es la versión LTS vigente: recibe soporte durante años. Evita versiones no-LTS posteriores para no arriesgar la compatibilidad de librerías.

bash
# Windows
winget install EclipseAdoptium.Temurin.25.JDK

# Linux (Debian/Ubuntu)
sudo apt update
sudo apt install temurin-25-jdk

# macOS
brew install --cask temurin@25

# Alternativa multiplataforma (SDKMAN!)
sdk install java 25-tem
sdk default java 25-tem
bash
java -version
javac -version
echo $JAVA_HOME      # Windows PowerShell: echo $env:JAVA_HOME
JAVA_HOME vacíoMaven y otras herramientas lo necesitan. Definirlo en las variables de entorno del sistema apuntando a la carpeta del JDK (no a bin). En Linux/macOS, exportarlo en ~/.bashrc o ~/.zshrc:
bash
export JAVA_HOME=/usr/lib/jvm/temurin-25-jdk-amd64
export PATH="$JAVA_HOME/bin:$PATH"

2Instalar Maven

Maven descarga librerías, compila, ejecuta pruebas y empaqueta el proyecto.

bash
# Windows
winget install Apache.Maven

# Debian/Ubuntu
sudo apt install maven

# macOS
brew install maven
bash
mvn -version
Maven usa un JDK distintoMaven mira JAVA_HOME, no el java del PATH. Si java -version dice 25 pero mvn -version dice otra cosa, revisa JAVA_HOME.

3Instalar y configurar Git

El nombre y el correo configurados aparecerán en el historial de commits que se evalúa: usa los reales de tu cuenta de GitHub/GitLab.

bash
# Windows
winget install Git.Git

# Debian/Ubuntu
sudo apt install git

# macOS
brew install git
bash
git config --global user.name "Nombre Apellidos"
git config --global user.email "correo@ejemplo.com"
git config --global init.defaultBranch main
git config --global core.autocrlf input    # en Windows: true

ssh-keygen -t ed25519 -C "correo@ejemplo.com"
cat ~/.ssh/id_ed25519.pub    # pégala en Settings → SSH keys de tu plataforma
ssh -T git@github.com        # verificación

4Instalar Docker y el IDE

Docker levantará los tres gestores de bases de datos del curso (MariaDB, PostgreSQL, MongoDB) sin instalarlos de forma nativa.

HerramientaNotas
Docker Engine/Desktop + ComposeEn Windows/macOS: Docker Desktop (Windows requiere WSL 2). En Linux: Docker Engine + usuario en el grupo docker
IntelliJ IDEA Community o VS CodeCommunity basta para todo el módulo. En VS Code: Extension Pack for Java, Spring Boot Extension Pack y Docker
DBeaver CommunityCliente universal para H2, MariaDB y PostgreSQL
bash
docker --version
docker compose version
docker run --rm hello-world
Docker pide sudo en LinuxAñade tu usuario al grupo docker y reinicia sesión: sudo usermod -aG docker $USER

5Entregable: docs/entorno.md

Documento con la salida literal de la checklist de arranque.

bash
java -version
mvn -version
git --version
docker --version
docker compose version
ComprobaciónEstado
java -version responde 25.x☐
JAVA_HOME apunta al JDK 25☐
mvn -version usa el JDK 25☐
git --version responde y credenciales configuradas☐
docker run --rm hello-world funciona sin sudo☐
docker compose version responde v2☐
IDE reconoce el nivel de lenguaje 25☐
DBeaver instalado☐
Cuenta GitHub/GitLab y clave SSH registrada☐

!Problemas frecuentes

IDE compila con otro nivel de lenguajeAunque el pom.xml declare Java 25, el IDE mantiene su propia configuración. En IntelliJ: File → Project Structure → Project SDK y Language level.
Rutas con espacios o tildesEvita rutas tipo C:\Users\...\Mis documentos\.... Usa una ruta corta sin espacios, por ejemplo C:\dev\multagal.

✓Criterios de aceptación

  • java -version responde versión 25.x
  • mvn -version confirma uso del JDK 25
  • Todos los comandos de la checklist reportan versiones válidas

Adaptado de apartado c — Entorno de desarrollo y apartado i — Actividades.