Saltar a contenido

Instalación del Entorno de Desarrollo

Esta guía proporciona instrucciones detalladas para configurar el entorno de desarrollo necesario para el bootcamp. Dependiendo de tu sistema operativo, sigue las instrucciones correspondientes.

Requisitos Comunes

Independientemente del sistema operativo, necesitarás instalar:

  • Java JDK 17 o superior
  • Maven
  • Node.js (versión 18 o superior)
  • Python (versión 3.12 o superior)
  • Docker y Docker Compose
  • Git
  • VS Code o IntelliJ IDEA

Instalación por Sistema Operativo

Selecciona tu sistema operativo para ver las instrucciones específicas:

Windows

Opción 1: Instalación Manual

  1. Instalar WSL (Subsistema de Windows para Linux):

    • Abre PowerShell como Administrador
    • Ejecuta: wsl --install
    • Reinicia el computador
    • Después de reiniciar, Ubuntu se instalará automáticamente

  2. Instalar Chocolatey:

    • Abre PowerShell como Administrador
    • Ejecuta: 
      Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

  3. Instalar las herramientas necesarias: 

    choco install openjdk17 -y
choco install maven -y
choco install nodejs -y
choco install python --version=3.12.0 -y

  4. Instalar Docker:

    • En la terminal de Ubuntu WSL, ejecuta: 
      sudo apt install -y apt-transport-https ca-certificates curl
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
echo "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update
sudo apt install -y docker-ce

  5. Instalar herramientas de Python: 

    pip install mkdocs poetry

  6. Instalar Jest: 

    npm install -g jest

Opción 2: Script Automatizado

Alternativamente, puedes usar el script windows.bat que se encuentra en la carpeta install_scripts. Este script asume que ya has instalado Ubuntu WSL y lo estás ejecutando como administrador.

Ubuntu/Linux

Opción 1: Instalación Manual

  1. Actualizar la lista de paquetes: 

    sudo apt update

  2. Instalar las herramientas necesarias: 

    sudo apt install -y git openjdk-17-jdk maven python3 python3-pip python3-poetry pipx nodejs npm apt-transport-https ca-certificates curl software-properties-common

  3. Agregar el repositorio de Docker: 

    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

  4. Actualizar la lista de paquetes nuevamente: 

    sudo apt update

  5. Instalar Docker: 

    sudo apt install -y docker-ce

  6. Instalar Jest: 

    npm install -g jest

  7. Instalar MkDocs: 

    pipx install mkdocs --include-deps
pipx inject mkdocs mkdocs-material mkdocs-simple-plugin plantuml-markdown mkdocs-mermaid2-plugin mkdocs_puml --include-deps --force
pipx ensurepath
source ~/.bashrc

Opción 2: Script Automatizado

Alternativamente, puedes usar el script ubuntu.sh que se encuentra en la carpeta install_scripts del proyecto, el cual contiene todos los pasos automatizados.

macOS

Opción 1: Instalación Manual

  1. Instalar Homebrew (si aún no está instalado): 

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. Agregar Homebrew al PATH: 

    echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

  3. Instalar las herramientas necesarias: 

    brew install openjdk@17
brew install maven
brew install python3
brew install node

  4. Instalar Rancher Desktop Instala Rancher Desktop, que da acceso a Docker, Docker Compose y una instancia local de Kubernetes con kubectl y helm.

brew install --cask rancher

  1. Configurar las variables de entorno para Java: 

    echo 'export JAVA_HOME="$(brew --prefix openjdk@17)"' >> ~/.bash_profile
echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

  2. Instalar Jest: 

    npm install -g jest

  3. Instalar Poetry: 

    brew install pipx
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
pipx install poetry

  4. Inicializar e iniciar la máquina Podman: 

    podman machine init
podman machine start

Verificación de la Instalación

Después de la instalación, verifica que todo se haya instalado correctamente:

java -version
mvn --version
node --version
npm --version
python3 --version
docker --version
git --version
mkdocs --version
poetry --version

Configuración de VS Code

VS Code es el editor recomendado para el bootcamp. Instala las siguientes extensiones para mejorar tu experiencia de desarrollo:

Para Java y JavaScript

  • Extension Pack for Java
  • Spring Boot Extension Pack
  • Debugger for Java
  • Maven for Java
  • ESLint
  • Prettier
  • JavaScript and TypeScript Nightly

Para Python

  • Python
  • Pylance
  • Python Indent
  • Python Docstring Generator

Para Pruebas

  • Test Explorer UI
  • Java Test Runner
  • Python Test Explorer
  • Jest Test Explorer

Otras Extensiones Útiles

  • Docker
  • Remote - WSL (para usuarios de Windows)
  • GitLens
  • Git Graph
  • Material Icon Theme
  • Markdown All in One

Configuración de Docker

Para asegurar que Docker esté configurado correctamente:

  1. Verificar la instalación: 

    docker --version
docker-compose --version

  2. Iniciar el servicio de Docker (Linux): 

    sudo systemctl start docker
sudo systemctl enable docker

  3. Agregar tu usuario al grupo docker (Linux): 

    sudo usermod -aG docker $USER
newgrp docker

Próximos Pasos

Después de configurar tu entorno de desarrollo, estás listo para comenzar a trabajar en el proyecto. Consulta la documentación específica de cada sprint para obtener más detalles sobre las tareas y requisitos.