Instalando e executando o Bootcamp

Instalação

1 Instalar Python

1. Python versão 3.5 ou superior - https://www.python.org/downloads/release/python-375/
2. Atualizar o pip python -m pip install --upgrade pip
3. Windows: Resolvendo problema com psycopg2 pip install psycopg2

2 Clonando repositório

1. Garanta que você está numa pasta não administrativa do seu sistema operacional
2. git clone https://github.com/EncontrosDigitais/bootcamp.git

3 Instalar o Virtual Env

1. Instale o virtualenv se ainda não estiver instalado pip install virtualenv
2. Crie o ambiente virtualenv venv_bootcamp
3. Acesse o ambiente
   1. Linux/Mac: source venv_bootcamp/bin/activate
   2. Windows: venv_bootcamp/Scripts/activate.bat ou venv_bootcamp/Scripts/activate.ps1

4 Instalar Django

1. Django versão 1.11.x ou superior: pip install django

5 Instalando dependências

Para ambiente de desenvolvimento:

1. pip install -U -r requirements/local.txt

Para ambiente de produção:

1. pip install -U -r requirements/production.txt

No Windows, o diretório requirements está dentro do diretório bootcamp.

6 Instalando o Banco de dados

1. Instalar o Postgres
   1. Executável: https://www.postgresql.org/ Não precisa instalar o Stack Builder.
   2. Linux: sudo apt install postgresql postgresql-contrib
2. MAC (Opcional): instalando o postgres como serviço auto inicializável: brew services start postgresql
3. Criar a tabela bootcamp no postgres via linha de comando CREATE DATABASE bootcamp; ou se preferir via interface administrativa do postgres.

7 Variáveis de ambiente

1. Duplicar arquivo .env.example com nome .env
2. Altere no arquivo .env os dados de conexão utilizados na configuração do seu postgres.

# PostgreSQL conf
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_PASSWORD=postgres
POSTGRES_USER=postgres
POSTGRES_DB=bootcamp
DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:5432/bootcamp

8 Configurar o banco

1. python manage.py migrate

9 Instalando o Redis

O bootcamp utiliza o Redis para o sistema de notificações em WebSocket. Versão mínima é 3.x.

MAC:

1. Baixar redis: https://redis.io/
2. Rodar comando make
3. Depois rodar make test
4. Rodar redis src/redis-server

Windows:

1. Redis não é compatível com Windows, é preciso baixar a versão já compilada e abrir o redis-server.exe.

9.1 Configurando o Redis

1. Verifique no arquivo .env se a variável REDIS_URL está correta.

10 Configurando o Idioma Português

1. Instalar gettext - Comando necessário para rodar o makemessages
   1. MAC: brew install gettext
   2. Windows: https://docs.djangoproject.com/en/1.8/topics/i18n/translation/#gettext-on-windows
2. Compilar tradução python manage.py compilemessages

Execução

Para ambiente de desenvolvimento:

1. python manage.py runserver

Para ambiente de produção:

1. python manage.py runserver 0.0.0.0:8000 --settings=config.settings.production

Certifique-se que o redis esteja rodando em outro terminal para que as notificações funcionem corretamente.