README.rst

SciELO - On-line Public Access Catalog

Instalação e configuração

Em nossa wiki você tem as diferentes guias de instalação e configuração para diferentes ambientes:

• De desenvolvimento
• De produção com Gunicorn/Nginx/Supervisor em CentOS
• De produção com Chaussette/Nginx/Circus em CentOS

Guia de configuração do site

Pode acessar nossa wiki para ter uma guia completa e como ajustar a configuração a partir de un arquivo de configuração em cada instância ou utilizando variáveis de ambiente.

Como executar os tests

• Para rodar os tests de unidade, pode executar: make test
• Para ter o relatório de coverage deve executar: make test_coverage

Arquivos: Dockerfile* e docker-compose*.yml

• Dockerfile: contém as definições para construir a imagem pronta para instalar em produção
• Dockerfile-dev: contém as definições para construir a imagem pronta para instalar em desenvolvimento
• docker-compose.yml: contém as definições para iniciar todos os containers necessários para rodar em produção
• docker-compose-build.yml: contém as definições para construir as imagems e iniciar todos os containers necessários para rodar no Travis/CI
• docker-compose.yml: contém as definições para iniciar todos os containers necessários para rodar em desenvolvimento

Instalação utilizando Docker para desenvolvimento

Para executar o ambiente (de desenvolvimento) com Docker, utilizando as definições do arquivo Dockerfile-dev e docker-compose.yml-dev na raiz do projeto. Simplesmente executar:

1. executar: make dev_compose_build para construir a imagem do OPAC.
2. executar: make dev_compose_up para rodar os containers.
3. acessar pelo browser: http://localhost ou no caso de utilizar OSx trocar localhost pela IP da maquina default (ver na saída do comando: docker-machine ip)
4. para inspecionar os logs, executar: make dev_compose_logs
5. para parar os containers, executar: make dev_compose_stop
6. para abrir uma terminal dentro do container, executar: make dev_compose_exec_shell_webapp

Reportar problemas, ou solicitar mudanças

Para reportar problemas, bugs, ou simplesmente solicitar alguma nova funcionalidade, pode criar um ticket com seus pedidos.

Equipe responsável por instalação, desenvolvimento e manutenção

• Jamil Atta Junior (Desenvolvimento) <jamil.atta@scielo.org>
• Juan Funez (Desenvolvimento) <juan.funez@scielo.org>
• Rondineli Gama Saad (Infraestrutura) <rondineli.saad@scielo.org>