Pular para conteúdo

Instalação do Ambiente de Desenvolvimento

Este guia fornece instruções detalhadas para configurar o ambiente de desenvolvimento necessário para o bootcamp. Dependendo do seu sistema operacional, siga as instruções correspondentes.

Requisitos Comuns

Independentemente do sistema operacional, você precisará instalar:

  • Java JDK 17 ou superior
  • Maven
  • Node.js (versão 18 ou superior)
  • Python (versão 3.12 ou superior)
  • Docker e Docker Compose
  • Git
  • VS Code ou IntelliJ IDEA

Instalação por Sistema Operacional

Selecione seu sistema operacional para ver as instruções específicas:

Windows

Opção 1: Instalação Manual

  1. Instalar o WSL (Windows Subsystem for Linux):

    • Abra o PowerShell como Administrador
    • Execute: wsl --install
    • Reinicie o computador
    • Após reiniciar, o Ubuntu será instalado automaticamente

  2. Instalar o Chocolatey:

    • Abra o PowerShell como Administrador
    • Execute: 
      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 as ferramentas necessárias: 

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

  4. Instalar o Docker:

    • No terminal do Ubuntu WSL, execute: 
      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 ferramentas Python: 

    pip install mkdocs poetry

  6. Instalar Jest: 

    npm install -g jest

Opção 2: Script Automatizado

Alternativamente, você pode usar o script windows.bat contido na pasta install_scripts. Este script assume que você já instalou o Ubuntu WSL e está executando como administrador.

Ubuntu/Linux

Opção 1: Instalação Manual

  1. Atualizar a lista de pacotes: 

    sudo apt update

  2. Instalar as ferramentas necessárias: 

    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. Adicionar o repositório do 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. Atualizar a lista de pacotes novamente: 

    sudo apt update

  5. Instalar o 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

Opção 2: Script Automatizado

Alternativamente, você pode usar o script ubuntu.sh contido na pasta install_scripts do projeto, que contém todos os passos automatizados.

macOS

Opção 1: Instalação Manual

  1. Instalar o Homebrew (se ainda não estiver instalado): 

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

  2. Adicionar o Homebrew ao PATH: 

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

  3. Instalar as ferramentas necessárias: 

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

  4. Instalar o Rancher Desktop Instala o rancher desktop que dá acesso ao docker, docker compose e uma instancia local de kubernetes com kubectl e helm

brew install --cask rancher

  1. Configurar variáveis de ambiente para o 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 o Poetry: 

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

  4. Inicializar e iniciar a máquina Podman: 

    podman machine init
podman machine start

Verificação da Instalação

Após a instalação, verifique se tudo foi instalado corretamente:

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

Configuração do VS Code

O VS Code é o editor recomendado para o bootcamp. Instale as seguintes extensões para melhorar sua experiência de desenvolvimento:

Para Java e 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 Testes

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

Outras Extensões Úteis

  • Docker
  • Remote - WSL (para usuários Windows)
  • GitLens
  • Git Graph
  • Material Icon Theme
  • Markdown All in One

Configuração do Docker

Para garantir que o Docker esteja configurado corretamente:

  1. Verificar a instalação: 

    docker --version
docker-compose --version

  2. Iniciar o serviço Docker (Linux): 

    sudo systemctl start docker
sudo systemctl enable docker

  3. Adicionar seu usuário ao grupo docker (Linux): 

    sudo usermod -aG docker $USER
newgrp docker

Próximos Passos

Após configurar seu ambiente de desenvolvimento, você está pronto para começar a trabalhar no projeto. Consulte a documentação específica de cada sprint para obter mais detalhes sobre as tarefas e requisitos.