- Requisitos
- Configure as variáveis de ambiente
- Execute a aplicação usando o Docker Compose
- Acesse as rotas documentadas da API com o Swagger
- licença
- Um editor de código de sua preferência
- Docker + docker compose
Note
Para clonar desse modo você precisa do git instalado.
Use o comando abaixo para clonar este repositório.
git clone https://github.com/viniciuscosmome/url-shortener.gitApós clonar o repositório, acesse a pasta criada url-shortener com seu editor de código
O arquivo .env.example tem uma cópia das variáveis de ambiente necessárias com valores de exemplo.
Crie um arquivo .env na raiz do repositório definindo suas variáveis para poder executar a aplicação.
# Define qual o ambiente em que a aplicação está executando
NODE_ENV=development
# Define em qual porta a aplicação irá executar
PORT=3000
# Define quantas vezes o hash da senha irá repetir
# -> CUIDADO! Quanto maior o número, mais o hash demora recurso para minimizar ataques de sonegação de serviço
# detalhes: https://www.npmjs.com/package/bcrypt#a-note-on-rounds
PASSWORD_SALT_ROUNDS=2
# Uma senha usada para criar o token de autenticação necessário para acesso a recursos (rotas) protegidos da aplicação.
JWT_SECRET=super-secret-password
# Configurações da base de dados
POSTGRES_USER=adminuser
POSTGRES_PASSWORD=adminpass
POSTGRES_DB=url-shortener
POSTGRES_HOST=postgres_main
POSTGRES_PORT=5432
# Use esta URL como está
DATABASE_URL="postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DB}?schema=public"Após configurar as variáveis de ambiente, execute o comando abaixo para que o ambiente no docker seja configurado e a aplicação inicie.
# [docker compose] -> comando para usar o compose
# [-f filename.yml] -> para selecionar um arquivo de configuração
# [up] -> para criar e iniciar o container
# [-d] -> para executar o container em segundo plano
docker compose -f docker-compose.dev.yml up -dApós a inicialização da API uma documentação estará disponível na rota /docs
Note
PORT tem o mesmo valor da variável de ambiente PORT que você escolheu para a sua aplicação.
http://localhost:PORT/docsurl-shortener licença MIT
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent