Henrique Cardoso Zanette| Home | Escopo | Processo | Design/Mockups | Configuração | Arquitetura | Código | BD | Qualidade | Frontend | Backend |
|---|
Configuração do projeto
Esta seção da Wiki visa apresentar o passo a passo de como configurar o ambiente de desenvolvimento do projeto Globo Aplausos.
Sumário
Passo a Passo para configurar o projeto
1. Você deve garantir que tem NodeJS instalado para rodar ambos os projetos. Para verificar a versão atual do seu NodeJs digite em algum terminal o comando: node --version ou node -v. Caso não tenha, realize a instalação através do LINK, e baixe a versão LTS (a versão estável atualizada).
2. Após instalar o node o NPM será instalado na sequência. Para verificar a versão da instalação digite no terminal o comando: npm --version ou npm -v.
3. Com as ferrametas instaladas, você vai clonar os projetos Frontend | Backend em uma pasta local, de sua preferência, através do comando git clone https://tools.ages.pucrs.br/globo-aplausos/globo-aplausos-frontend.git e posteriormente git clone https://tools.ages.pucrs.br/globo-aplausos/globo-aplausos-backend.git (para isso você precisará do GIT).
4. Com NodeJS e NPM instalados, bem como ambos os projetos clonados, você vai acessar a pasta raiz de
cada projeto e digitar no terminal comando npm install, para instalar as dependências do projeto.
5. Para rodar cada projeto digite no terminal o comando npm run dev, automaticamente irá abrir uma aba do seu navegador com o projeto nas seguintes portas, ou acesse o localhost nas seguintes portas:
- Frontend: 3000
- Backend: 8080
Caso esteja utilizando Docker, utilize o comando: docker compose up --build para subir o container da aplicação.
Instalando MySQL
Para instalar o Banco de Dados MySQL localmente acesse a página:
Escolha a opção do download do MySQL Installer Web Community.
Clique para começar o download.
Com o instalador baixado, execute e selecione a opção de instalação customizada.
Primeiro, selecione uma versão do SQL para baixar (pode ser a mais recente), e clique na seta verde para adicionar a instalação.
Logo após, repita o mesmo processo para a instalação do MySQL Workbench.
Os produtos a serem instalados devem ser os seguintes:
Neste passo podemos deixar a configuração padrão.
Aqui, escolha a autenticação de strong password.
Neste passo, escolha uma senha que será utilizada para o usuário raiz do MySQL.
Aqui podemos deixar a configuração padrão também.
Aqui podemos deixar a configuração padrão também.
Por fim, clique em executar, aguarde os processos e finalize a instalação do MySQL.
Pronto! Com o MySQL instalado localmente podemos realizar a conexão da aplicação com o banco de dados.
Instalando Docker Desktop
1. Baixe e instale o Docker, caso seu sistema seja Windows siga o passo a passo, se for Linux ou MacOS não é necessário.
2. Execute um terminal PowerShell como administrador e execute os seguintes comandos:
- Para habilitar o Subsistema do Windows para Linux
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart - Para habilitar o recurso de Máquina Virtual
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Após estes passos reinicie sua máquina.
3. Baixe o pacote de atualização do kernel do Linux através do seguinte comando em um terminal wsl.exe --install ou wsl.exe --update, caso não consiga baixe manualmente pelo link estático.
4. Defina o WSL 2 como a sua versão padrão wsl --set-default-version 2.
5. Instale alguma distribuição Linux, o recomendado é que instale a versão mais recente e estável Ubuntu através do comando wsl --install -d Ubuntu, ou entre na Microsoft Store e baixe a versão de sua preferência.
6. Abra o subsistema (procure Ubuntu no menu Windows) e crie seu usuário, digite um username de sua preferência e uma senha (por padrão a senha não aparece no terminal, apenas digite e pressione enter).
7. Abra o Docker Desktop, clique em Settings e depois em Resources, se tudo estiver certo irá aparecer a mensagem:
- You are using the WSL 2 backend, so resource limits are managed by Windows.
Se desejar, clique no link indicado em Resources e siga o tutorial para limitar os recursos destinados para o subsistema, para diminuir o consumo de recursos do Docker.