Configuração do projeto

Sumário

• Passo a Passo para configurar o projeto
• Instalando Docker Desktop

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 o MySQL

Para instalar o Banco de Dados MySQL acesse a página:

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.