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 |