| File | Date | Author | Commit |
|---|---|---|---|
| website | 2013-12-19 |
|
[3b7cf3] Arquivos estáticos funcionando. Instalado Found... |
| .hgignore | 2013-12-15 |
|
[e8c987] Commit inicial 3. Agora vai? |
| README.rst | 2013-12-15 |
|
[2a93a5] Criado arquivo de README. |
| requirements.txt | 2013-12-19 |
|
[3b7cf3] Arquivos estáticos funcionando. Instalado Found... |
| runserver.sh | 2013-12-12 |
|
[bcf700] First Commit |
Este tutorial visa mostrar os passos para a correta instalação dos requisitos para o site.
Note
Este tutorial deve ser complementado assim que novas funcionalidades forem adicionadas e necessitarem de configurações adcionais. Favor rever os passos que não ficarem claros ou que não funcionam sob algum aspecto.
O Python deve ser instalado para a instalação e codificação do site. Utilizar a versão 2.7 ou posterior. A versão 3 ainda não possui grande compatibilidade.
pip é um gerenciador de pacodes que sera usado para instalar os aplicativos que vamos usar, bem como suas dependencias.
Inicialmente vamos baixar o arquivo ez_setup.py:
$ wget https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py
Executamos o arquivo:
# python ez_setup.py
Agora efetivamente baixar o pip em get-pip.py:
$ wget https://raw.github.com/pypa/pip/master/contrib/get-pip.py
E então instalamos o pip:
# python get-pip.py
Agora que temos o pip, em tese é possível instalar qualquer pacote. Porém na, prática NÃO se instala os pacotes globalmente, devemos criar um ambiente isolado para que seja instalado os pacotes de versões específicas para cada projeto. O virtualenv na pratica faz uma copia dos binários e das bibliotecas para a pasta do projeto, onde não é necessário permissões root para instalar pacotes, além de permitir um maior controle de quais versões dos requisitos são utilizadas. A instalação é bastante simples:
# pip install virtualenv
Com isto podemos ir para a pasta do projeto e criar o ambiente virtual:
$ virtualenv env
Isto irá criar uma pasta env contendo apenas o pacote python padrão. Para utilizar este ambiente, basta este comando:
$ source env/bin/activate
Com isso o shell será modificado para (env)[user@host]. Um simples teste pip freeze mostra a existencia de apenas o pacote basico.
O processo de instalação de pré-requisitos pode se tornar bastante complexo. Uma combinação de versões erradas pode resultar em erros futuros. Este passo foi baseado no tutorial de Instalação do Django CMS
O único pacote que exige um pouco de atenção é o Pillow, pois este exige a instalação de pacotes separadamente.:
# yum install libjpeg-devel libpng-devel python-devel
Existe um arquivo chamado requirements.txt o qual contem todos os pré- requisitos para o site. para instalar, utilize o seguinte comando (no ambiente virtual:
$ pip install --download-cache=~/.pip-cache -r requirements.txt
Com isto tudo deve funcionar corretamente
Atualmente o banco de dados utilizado é o próprio SQLite, por padrão do Django. Antes de testarmos o site, necessariamente precisamos rodar os seguintes comandos:
$ python manage.py syncdb $ python manage.py migrate
Após isso, o comando python manage.py cms check deverá funcionar e não encontrar nenhum erro. Nginx =====
Precisamos configurar o nginx para redirecionar as requisições para o django. Para isso precisamos primeiramente do módulo Flup. No ambiente virtual execute:
$ easy_install Flup
Após isso, utilize o script para ativar o fast-cgi, escutando assim requisições de fora:
$ ./runserver.sh