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 |