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
• Instalando MySQL
• Instalando Docker Desktop
• Conectando o Banco de Dados ao Backend

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.

Conectando o Banco de Dados ao Backend