O Dreamhost utiliza o Passenger WSGI para servir aplicações escritas em Python, por isso, o processo aqui descrito é referente ao deploy utilizando o Passenger WSGI.

Configuração do domínio

O primeiro passo é configurar um domínio para fazer o deploy da aplicação. Entre no painel de configuração de domínios e adicione um novo domínio ou sub-domínio, ou então edite a configuração de um domínio já existente.

Após inserir o nome do novo domínio ou sub-domínio, na seção “Web Options“, marque a opção “Passenger (Ruby/Python apps only)“.

Um detalhe importante é, que ao utilizar o Passenger, o caminho especificado em “Web directory” deve terminar em public. Por exemplo, se o domínio configurado é exemplo.com.br, então o caminho ficará exemplo.com.br/public.

Configuração do banco de dados MySQL

Uma vez configurado o domínio, deve ser criado um banco de dados para a aplicação. A criação do banco pode ser feita na página de gerência de banco de dados MySQL. Tenha pelo menos um hostname configurado, pois no Dreamhost não pode ser usado simplesmente localhost ao configurar o host do servidor de banco de dados na aplicação.

Deploy da apliação Django

Agora que o domínio e o banco de dados da aplicação estão criados, criaremos uma aplicação Django e faremos o deploy utilizando o virtualenv.

Primeiro é necessário criar o ambiente virtual para nossa apliação, lembrando que será feito o uso do virtualenvwrapper para nos auxiliar:

mkvirtualenv projeto

Ao executar o comando anterior, o ambiente virtual criada já será ativado, repare o prefixo () no prompt do shell:

(projeto)user@host:path/to/projeto.com.br$

Posteriormente, o virtualenv poderá ser ativado usando o comando:

workon projeto

Para completar o nome do projeto poderá ser utilizado o tab, assim como é feito para completar comandos do sistema.

Agora que temos o ambiente virtual criado, podemos instalar o Django:

pip install django

Como o Dreamhost oferece somente o MySQL como servidor de banco de dados, teremos que instalar também o driver do MySQL para Python:

pip install mysql-python

Terminado a instalação dos pacotes necessários, poderemos fazer o setup de nossa aplicação. Primeiramente devemos entrar no diretório que foi configurado o domínio, estarei utilizando o domínio projeto.com.br como exemplo.

cd projeto.com.br

Lembre-se que, como estamos utilizando o Passenger, dentro do diretório projeto.com.br deverá ter o diretório public, como foi definido anteriormente na configuração do domínio.

Agora poderá ser criado o projeto Django:

django-admin.py startproject projeto

Também deverá ser criado o arquivo passenger_wsgi.py:

touch passenger_wsgi.py

Edite esse arquivo e adicione o seguinte conteúdo:

import sys, os
 
INTERP = os.path.join(os.environ['HOME'], '.virtualenvs', 'projeto', 'bin', 'python')
if sys.executable != INTERP: os.execl(INTERP, INTERP, *sys.argv)
 
sys.path.append(os.getcwd())
os.environ['DJANGO_SETTINGS_MODULE'] = "projeto.settings"
import django.core.handlers.wsgi
application = django.core.handlers.wsgi.WSGIHandler()

Nossa aplicação está quase pronta para ser rodada. Falta fazer a configuração do banco de dados e do admin. Também será criar um link simbólico para os arquivos estáticos do admin.

Configuração da aplicação

Entre no diretório do projeto:

cd projeto

E edite o arquivo settings.py, primeiro a configuração do banco de dados:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'database_name',
        'USER': 'user',
        'PASSWORD': 'password',
        'HOST': 'hostname.domain.com',
        'PORT': '',
    }
}

Primeiro definimos que utilizaremos o MySQL como banco de dados, em seguida configuramos o nome do banco de dados, nome do usuário e senha. Finalmente, é configurado o host do servidor do banco de dados, repare que devemos entrar com o hostname configurado na página de gerência de banco de dados MySQL.

Ainda no arquivo settings.py, deverá ser configurado STATIC_ROOT para que os arquivos estáticos do django admin sejam cerregados.

STATIC_ROOT = '/home/user/projeto.com.br/public/static'

Para finalizar a configuração da aplicação, devemos adicionar o django admin no INSTALLED_APPS, para isso decomente a linha:

# 'django.contrib.admin',

Com isso finalizamos a configuração do projeto. O próximo passo é configurar o arquivo urls.py descomentando as linhas:

# from django.contrib import admin
# admin.autodiscover()
# url(r'^admin/', include(admin.site.urls)),

Em seguida criaremos o link simbólico para os arquivos estáticos do django admin:

mkdir public/static
ln -s ~/.virtualenvs/projeto/lib/python2.7/site-packages/django/contrib/admin/media/ public/static/admin

Finalmente, para terminar o deploy, execute o comando syncdb para que as tabelas do banco de dados e um super-usuário seja criado:

cd projeto
python manage.py syncdb

Uma vez terminado a execução do syncdb, poderemos acessar nosso projeto no navegador. No exemplo desse post bastaria acessar a URL http://projeto.com.br/admin.

Referências

• Django (Dreamhost Wiki)
• Passenger WSGI (Dreamhost Wiki)
• Installing Django With virtualenv on Dreamhost

Como exemplo, será demonstrado como instalar uma versão do Python e do Django diferente da oferecida pelo serviço de hospedagem compartilhada do Dreamhost. No momento da escrita do post as versões do Python e do Django oferecidas são, respectivamente, 2.5.2 e 1.2.1. Serão instaladas as versões atuais que são 2.7.2 para o Python e 1.3.1 para o Django.

Além disso, será configurado o pip, virtualenv e virtualenvwrapper para facilitar manter diversos projetos e criar ambientes virtuais para atender as necessidades de cada projeto.

Antes de iniciar tenha certeza que seu usuário tenha acesso SSH. É desejável ter algum conhecimento sobre Linux para facilitar o entendimento das  etapas descritas.

Configuração inicial do ambiente

Sua conta deve estar configurada como descrito:

Primeiro, crie os diretórios necessários:

cd ~
# Criação dos diretórios raiz (e log/setup)
mkdir -pv soft run www log log/setup backup data
# Criação dos subdiretórios dentro de run (nosso FHS)
for subdir in bin etc include lib man share
do
  mkdir -pv run/${subdir}
done
# link simbólicos para manter os manuais em um local comum
ln -sv ../man run/share/man
# link simbólico dentro de log para os logs do apache
ln -sv ../logs log/vhosts

Em seguida, edite o arquivo ~/.bashrc para configurar o ambiente, adicione as seguintes linhas:

# Variável para facilitar as instalações
export RUN=$HOME/run

# Adiciona o run/bin ao PATH do sistema
PATH=$RUN/bin:$PATH

# Define os caminhos para bibliotecas
export LD_LIBRARY_PATH=$RUN/lib:$LD_LIBRARY_PATH
export LD_RUN_PATH=$RUN/lib:$LD_RUN_PATH

  Para maiores informações e outras configurações visite Unix account setup. Para instalar o Python, somente as configurações descritas são suficientes.

Instalação do Python 2.7.2

# Diretório para baixar e compilar o Python
cd ~/soft
# Download do Python 2.7.2
wget http://python.org/ftp/python/2.7.2/Python-2.7.2.tgz
# Extrai o conteúdo do pacote
tar -zxvf Python-2.7.2.tgz
# Acessa o diretório com o conteúdo extraido
cd Python-2.7.2
# Configura a instalação, repare no prefixo informado
./configure --prefix=$RUN
# Compilação do Python
make
# Instalação do Python
make install
# Se tudo ocorreu bem, teremos o python 2.7.2 instalado
python --version

# Diretório para baixar e compilar o Python
cd ~/soft
# Download do setuptools para o Python 2.7.x
wget http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg
# Instalação do setuptools, repare no prefixo informado
sh setuptools-0.6c11-py2.7.egg --prefix=$RUN

easy_install pip

pip install virtualenvwrapper

export WORKON_HOME=~/.virtualenvs
source virtualenvwrapper.sh

Essa configuração informa que os ambientes virtuais serão instalados no diretório ~/.virtualenvs.

Para que esse configuração tenha efeito imediado execute o comando:

. ~/.bashrc

Caso o comando anterior não seja executado, somente na próxima vez que iniciar uma sessão SSH, as configurações entrarão em vigor.

Instalação do Django

Finalmente, para instalação do Django, já que temos o pip instalado, basta executar o comando:

pip install django

Com isso teremos o Django disponível no sistema. Eu tenho a preferência de instalar o Django sempre que criar um virtualenv, pois dessa forma cada projeto pode permanescer com sua versão requerida do Django.

Maiores informações

Para maiores informações consulte as referências:

• Unix account setup
• Django (Dreamhost Wiki)
• Python (Dreamhost Wiki)

Para execução do script, primeiramente será necessário editar algumas configurações no dominio hospedado.

Configuração do dominio

Será necessário ativar o passenger para seu dominio, para isso basta seguir esses passos:

1. Abra a página de configuração dos domínios do painel de controle e edite o domínio desejado.
2. Vá até a seção “Users, Files, and Paths”, e assegure que o web direcotry do seu dominio termine com “/public”, por exemplo, “/home/usuario/elyezer.com/public”.
3. Após a modificação anterior, vá até a seção “Web Options” e marque o checkbox para ativar o “Passenger”.

Após as modificações anteriores, basta executar o script para poder fazer o deploy de sua aplicação.

Utilizando o script para o deploy da aplicação Django

Agora será necessário que você acesse seu servidor via SSH, e após entrar no diretório da sua aplicação, execute os seguintes comandos:

wget http://wiki.dreamhost.com/django-setup.py
python django-setup.py

O script irá orientá-lo durante o restante do processo de configuração de sua aplicação. Para maiores informações, visite a página do wiki do Dreamhost sobre o Django.

Conclusões

Para quem já havia feito o deploy anteriormente de uma aplicação Django no Dreamhost perceberá que o processo de configuração está muito mais simples, quase como um One Click Install. Com isso o Dreamhost anuncia que está suportando “oficialmente” aplicações em Django em sua hospedagem.

Ainda não tem um servidor de hospedagem?

Aproveite esse novo recurso oferecido pelo Dreamhost e cadastre-se agora mesmo. Utilize o código promocional DHDJANGO para obter um desconto de até $90 dólares ao se cadastrar.

Então aproveite, ao assinar a hospedagem oferecida pela Dreamhost e usar o promocode DESCTOTAL você estará adquirindo uma excelente hospedagem e ainda aproveitará a promoção de ter espaço em disco e tranferência mensal ilimitados para sempre! E de quebra, ao usar o promocode DESCTOTAL, poderá conseguir até $97,00 dolares de desconto.

Corra pois a promoção de espaço e transferência, oferecido pela Dreamhost, está acabando. Porém você ainda poderá assinar até o final de janeiro do ano que vem usando o promocode DESCTOTAL para obter um desconto de até $97,00 dólares no pagamento do plano.

Clique aqui e confira o que você terá em seu plano caso assine, ou então clique aqui e vá direto a pagina de cadastro.

Feliz hospedagem nova!