| ... | ... | @@ -5,17 +5,43 @@ |
|
|
|
|
|
|
|
## Sumário
|
|
|
|
- [Passo a Passo para configurar o projeto](#passo-a-passo-para-configurar-o-projeto)
|
|
|
|
- [Como instalar docker](#Instalando docker)
|
|
|
|
|
|
|
|
## 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**](https://nodejs.org/en), e baixe a versão LTS (a versão estável atualizada).
|
|
|
|
**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**](https://nodejs.org/en), e baixe a versão LTS (a versão estável atualizada).
|
|
|
|
|
|
|
|
2. Após instalar o node o [**NPM**](https://www.npmjs.com/get-npm) será instalado na sequência. Para verificar a versão da instalação digite no terminal o comando: `npm --version` ou `npm -v`.
|
|
|
|
**2.** Após instalar o node o [**NPM**](https://www.npmjs.com/get-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**](https://tools.ages.pucrs.br/globo-aplausos/globo-aplausos-frontend) | [**Backend**](https://tools.ages.pucrs.br/globo-aplausos/globo-aplausos-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**](https://git-scm.com/downloads)).
|
|
|
|
**3.** Com as ferrametas instaladas, você vai clonar os projetos [**Frontend**](https://tools.ages.pucrs.br/globo-aplausos/globo-aplausos-frontend) | [**Backend**](https://tools.ages.pucrs.br/globo-aplausos/globo-aplausos-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**](https://git-scm.com/downloads)).
|
|
|
|
|
|
|
|
4. Com NodeJS e NPM instalados, bem como ambos os projetos clonados, você vai acessar a pasta raiz de
|
|
|
|
**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:
|
|
|
|
**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
|
|
|
|
|
|
|
|
**6.** WIP `docker compose up --build`
|
|
|
|
## Instalando Docker Desktop
|
|
|
|
**1.** Baixe e instale o [**Docker**](https://www.docker.com/products/docker-desktop/), 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**](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) 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, recomendo que instale a versão mais recente estável Ubuntu através do comando `wsl --install -d Ubuntu`, ou entre na [Microsoft Store](https://apps.microsoft.com/store/search/linux) 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. |
|
|
\ No newline at end of file |
