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 |