Passo a Passo para Instalação e Configuração do Ambiente
Recomendação: Instalação do WSL (Windows Subsystem for Linux) - toda a configuração será baseada nele
aqui.
No caso de utilizar linux ou mac só pular essa etapa e a parte do docker para Windows, olhar a instalação do docker-
Habilite o WSL no Windows:
- Abra o PowerShell como administrador e execute o seguinte comando:
wsl --install
- Reinicie o computador se solicitado.
- Abra o PowerShell como administrador e execute o seguinte comando:
-
Escolha uma Distribuição Linux:
- Após a reinicialização, instale uma distribuição Linux (ex: Ubuntu) pela Microsoft Store.
-
Configure o WSL:
- Abra o Ubuntu instalado e siga as instruções para configurar seu nome de usuário e senha.
-
Atualize os pacotes da distribuição:
- Execute os comandos:
sudo apt update sudo apt upgrade
- Execute os comandos:
1. Instalação do Docker
-
Instale o Docker Desktop no Windows:
- Baixe e instale o Docker Desktop a partir do site oficial.
- Durante a instalação, certifique-se de habilitar a integração com WSL 2.
-
Verifique a instalação do Docker:
- No terminal do WSL, execute:
docker --version
- O comando deve retornar a versão do Docker instalada.
- No terminal do WSL, execute:
2. Instalação do Git
-
Instale o Git no seu terminal:
- No terminal do WSL, execute o seguinte comando para instalar o Git:
sudo apt install git
- No terminal do WSL, execute o seguinte comando para instalar o Git:
-
Configure o Git:
- Após a instalação, configure o Git com seu nome de usuário e email:
git config --global user.name "Seu Nome" git config --global user.email "[email protected]"
- Após a instalação, configure o Git com seu nome de usuário e email:
-
Verifique a instalação:
- Verifique se o Git foi instalado corretamente:
git --version
- Verifique se o Git foi instalado corretamente:
3. Configuração para rodar o Frontend
-
Instale o NVM (Node Version Manager) no WSL:
- Baixe e instale o NVM executando:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
- Carregue o NVM no shell atual:
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
- Baixe e instale o NVM executando:
-
Instale a versão LTS do Node.js usando NVM:
- Liste as versões disponíveis:
nvm ls-remote
- Instale a versão LTS mais recente (por exemplo, 18.x):
nvm install --lts
- Use a versão instalada:
nvm use --lts
- Verifique a instalação:
node -v npm -v
- Liste as versões disponíveis:
-
Entre no Frontend do Projeto:
- No dentro do diretório de frontend, execute:
npm install
- No dentro do diretório de frontend, execute:
-
Execute o Servidor de Desenvolvimento:
- Inicie o servidor:
npm run dev
- O Vite iniciará o servidor de desenvolvimento, geralmente acessível em
http://localhost:5173
.
- Inicie o servidor:
4. Configuração para rodar o Backend
-
Entre no Backend do Projeto, Construa e Inicie o Container:
- No diretório raiz do projeto, Execute os comandos:
docker-compose build docker-compose up #ou docker-compose up -d #para liberar seu terminal enquanto o container roda
- O NestJS deve estar rodando em
http://localhost:3000
.
- No diretório raiz do projeto, Execute os comandos:
5. Extra - Dicas de extensões para IDE
- Instale essas extensões do Visual Studio Code para facilitar o desenvolvimento: