configuracao.md
0 → 100644
# Passo a Passo para Instalação e Configuração do Ambiente | ||
## Recomendação: Instalação do WSL (Windows Subsystem for Linux) - todo a configuração será baseada nele - se utilizar linux ou mac só pular essa primeira etapa e a parte do docker para Windows | ||
1. **Habilite o WSL no Windows**: | ||
- Abra o PowerShell como administrador e execute o seguinte comando: | ||
```powershell | ||
wsl --install | ||
``` | ||
- Reinicie o computador se solicitado. | ||
2. **Escolha uma Distribuição Linux**: | ||
- Após a reinicialização, instale uma distribuição Linux (ex: Ubuntu) pela Microsoft Store. | ||
3. **Configure o WSL**: | ||
- Abra o Ubuntu instalado e siga as instruções para configurar seu nome de usuário e senha. | ||
4. **Atualize os pacotes da distribuição**: | ||
- Execute os comandos: | ||
```bash | ||
sudo apt update | ||
sudo apt upgrade | ||
``` | ||
## 1. Instalação do Docker | ||
1. **Instale o Docker Desktop no Windows**: | ||
- Baixe e instale o Docker Desktop a partir do [site oficial](https://www.docker.com/products/docker-desktop). | ||
- Durante a instalação, certifique-se de habilitar a integração com WSL 2. | ||
2. **Verifique a instalação do Docker**: | ||
- No terminal do WSL, execute: | ||
```bash | ||
docker --version | ||
``` | ||
- O comando deve retornar a versão do Docker instalada. | ||
## 2. Instalação do Git | ||
1. **Instale o Git no seu terminal**: | ||
- No terminal do WSL, execute o seguinte comando para instalar o Git: | ||
```bash | ||
sudo apt install git | ||
``` | ||
2. **Configure o Git**: | ||
- Após a instalação, configure o Git com seu nome de usuário e email: | ||
```bash | ||
git config --global user.name "Seu Nome" | ||
git config --global user.email "[email protected]" | ||
``` | ||
3. **Verifique a instalação**: | ||
- Verifique se o Git foi instalado corretamente: | ||
```bash | ||
git --version | ||
``` | ||
## 3. Configuração para rodar o Frontend | ||
1. **Instale o NVM (Node Version Manager) no WSL**: | ||
- Baixe e instale o NVM executando: | ||
```bash | ||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash | ||
``` | ||
- Carregue o NVM no shell atual: | ||
```bash | ||
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" | ||
``` | ||
2. **Instale a versão LTS do Node.js usando NVM**: | ||
- Liste as versões disponíveis: | ||
```bash | ||
nvm ls-remote | ||
``` | ||
- Instale a versão LTS mais recente (por exemplo, 18.x): | ||
```bash | ||
nvm install --lts | ||
``` | ||
- Use a versão instalada: | ||
```bash | ||
nvm use --lts | ||
``` | ||
- Verifique a instalação: | ||
```bash | ||
node -v | ||
npm -v | ||
``` | ||
3. **Entre no Frontend do Projeto**: | ||
- No dentro do diretório de frontend, execute: | ||
```bash | ||
npm install | ||
``` | ||
4. **Execute o Servidor de Desenvolvimento**: | ||
- Inicie o servidor: | ||
```bash | ||
npm run dev | ||
``` | ||
- O Vite iniciará o servidor de desenvolvimento, geralmente acessível em `http://localhost:5173`. | ||
## 4. Configuração para rodar o Backend | ||
1. **Entre no Backend do Projeto, Construa e Inicie o Container**: | ||
- No diretório raiz do projeto, Execute os comandos: | ||
```bash | ||
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`. | ||
## 5. Extra - Dicas de extensões para IDE | ||
1. **Instale essas extensões do Visual Studio Code para facilitar o desenvolvimento**: | ||
- [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss) | ||
- [Prettier - Code formatter](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) | ||
- [EditorConfig for VS Code](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig) | ||
\ No newline at end of file |