Skip to content

GitLab

Last edited by Mathias Gatti Elbern
Page history
This is an old version of this page. You can view the most recent version or browse the history.

Rodando localmente (development)

Configuração

A configuração de cada ambiente está no config/environments/<env>.js. Para desenvolvimento vamos utilizar o arquivo config/environments/development.js. Nele esta configurado para subir a aplicação na porta 3000 e utilizar o MongoDB com a seguinte config:

username: "admin",
password: "p1c4d1nh0",
database: "dev"

Requisitos

Será necessário ter em sua máquina:

Configurando MongoDB

Docker

  • Na raiz do repositório existe um arquivo chamado docker-compose.yml. Com ele é possível subir uma instancia do MongoDB, já configurada para ser utilizada localmente. Para isso é preciso ter instalado o Docker em sua máquina (Linux ou Windows). Com o Docker rodando, o seguinte comando pode ser executado docker-compose up -d

Após isto o MongoDB já estará rodando.

Sem Docker - Para os que tiverem problemas com o Windows Home

  • Também é possível utilizar o MongoDB localmente. Para isto basta configurar o usuário e senha de acordo com o env do projeto.
  1. Deve-se instalar o MongoDB localmente na máquina através do link: https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-4.4.1-signed.msi
  2. No cmd digitar 'cd C:\Program Files\MongoDB\Server\4.4\bin\mongo.exe' O mongodb deve se conectar. Verificar em qual porta está conectado o mongo. No meu caso foi a 27017
  3. Digitar o comando 'use admin'
  4. Digitar o comando para adicionar usuário 'db.createUser( { user: "admin", pwd: "p1c4d1nh0", roles: [ { role: "dbOwner", db: "dev" } ] } )'
  5. No MongoDB Compass adicionar uma conexão como segue: Hostname: localhost Port: 27017 (vai depender de qual porta o mongo está conectado) Authentication: username/password Username: admin Password: p1c4d1nh0 Authentication Database: admin
  6. Após esses passos é possível iniciar o back.

https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/

Dependências

Para que todas as dependências do projeto sejam instaladas pode ser utilizado o gerenciador de pacotes NPM.

Com o repositório clonado, navegue até o a pasta raiz do projeto, e execute, npm install.

Rodando

Depois das devidas configurações, basta executar o seguinte comando para rodar o projeto, npm run dev.

Swagger e docs

O projeto conta com um middleware do Swagger para automaticamente documentar as rotas desenvolvidas. Para visualiza-lo, com o projeto em execução, basta acessar http://localhost:3000/api/docs.