Como instalar o Django.

Este documento lhe dirá como instalar e rodar o Django.

Instalando Python

Sendo um framework Web Python, Django requer Python. Veja Qual versão do Python eu posso usar com Django? para detalhes.

Get the latest version of Python at https://www.python.org/downloads/ or with your operating system’s package manager.

Django no Jython

Se você usa o Jython (uma implementação do Python para a plataforma Java), você precisa seguir alguns passos adicionais. Para maiores informações veja Rodando o Django no Jython.

Python no Windows

Se você está apenas começando com o Django e usando Windows, você talvez ache Como instalar o Django no Windows útil.

Instalando o Apache e o mod_wsgi

Se você quer apenas experimentar o Django, passe a frente para a próxima seção; o Django inclui um servidor Web leve que você pode usar para testes, aí você não precisa configurar o Apache anté que esteja pronto para implantar o Django em produção.

Se você quer usar o Django em um site em produção, use o Apache com mod_wsgi. O mod_wsgi pode operar em um dos dois modos: um modo embutido e um modo de “deamon”. No modo embutido, mod_wsgi é similar ao mod_perl – ele embuti Python dentro do Apache e carrega o código Python na memória quando o servidor inicia. O código permanece na memória durante a vida do processo Apache, o que leva a significativos ganhos de performance se comparado com outros arranjos de servidores. No modo “deamon”, mod_wsgi desova um processo “deamon” independente que lida com as requisições. O processo “deamon” pode rodar com um usuário diferente do usuário do servidor Web, possivelmente levando a uma melhora de segurança, e o processo “deamon” pode ser reiniciado sem ter que reiniciar todo o servidor web Apache, possivelmente fazendo com que o a atualização do seu código seja menos penoso.Consulte a documentação do mod_wsgi para determinar qual modo é correto para sua instalação. Assegure-se de ter o Apache instalado, com o módulo mod_wsgi ativado. O Django irá trabahar com qualquer versao do Apache que de suporte a mod_wsgi.

Veja Como usar o Django com mod_wsgi para informações de como configurar o mod_wsgi depois de tê-lo instalado.

Se não pode usar o mod_wsgi por alguma razão, não se preocupe: o Django suporta muitas outras opções para implantação. Uma é uWSGI; ele trabalha bem com o nginx. Adina, o Django segue a especificação (PEP 3333) WSGI, o qual lhe permiti rodar em uma variedade de plataformas de servidores.

Tenha seu banco de dados rodando

Se você planeja usar a funcionalidade de API de banco de dados do Django, terá que assegurar que um servidor de banco de dados está rodando. O Django suporta muitos tipos diferentes de servidores de bancos de dados diferentes, e oficialmente tem suporte para PostgreSQL, MySQL, Oracle e SQLite.

Se você está desenvolvendo um projeto simples ou alguma coisa que você não planeja implantar em um ambiente de produção, SQLite é geralmente a opção mais simples já que não requer que rode um servidor em separado. Porém, o SQLite tem muitas diferenças de outros bancos de dados, se você estiver trabalhando em algo substancial, é recomendado que você desenvolva com o mesmo banco de dados que planeja usar em produção.

Além dos bancos de dados oficialmente suportados, existem “backends” fornecidos por terceiros que permitem que você use outros bancos de dados com o Django.

Além do “backend” do banco de dados, você precisa assegurar que seus “bindings” para Python para o banco de dados estão instalados.

Se você planeja usar o comando manage.py migrate do Django para automaticamente criar as tabelas do banco de dados para seus modelos (depois de primeiro instalar o Django e criar um projeto), você precisa se assegurar que o Django tem permissão para criar e alterar tabelas no banco de dados que estiver usando; Se você planeja criar manualmente as tabelas, você pode simplesmente dar permissões de SELECT, INSERT, UPDATE and DELETE ao Django. Depois de criar um usuário do banco de dados com estas permissões, você irá especificar os detalhes no arquivo de configuração do seu projeto, veja DATABASES para detalhes.

Se você está usando o framework de testes do Django para testar consultas no banco de dados, o Django irá precisar de permissão para criar o banco de dados de teste.

Remova qualquer versão antiga do Django

Se estiver fazendo uma atualização de sua instalação do Django vindo uma versão anterior, você precisa desinstalar a versão antiga do Django antes de instalar a nova versão.

Se você previamente instalou o Django usando o pip ou easy_install, instalando novamente com o pip ou easy_install eles irão automaticamente cuidar da versão anterior, de modo que não precisa fazer isso você mesmo.

Se você previamente instalou o DJango usando python setup.py install, desinstalar é somente deletar o diretório django do seu Python site-packages. Para encontrar o diretório que você precisa remover, você pode executar o seguinte no “prompt” do seu “shell” (não no “prompt” interativo do Python):

$ python -c "import django; print(django.__path__)"

Instalando o código do Django.

As instruções de instalação são um pouco diferentes dependendo de se você está instalando um pacote de uma distribuição específica, fazendo o download da última versão oficial, ou pegando a última versão em desenvolvimento.

É fácil, não importa a maneira que você escolheu.

Instalando uma versão oficial com pip

Este é o modo recomendável de instalar o Django.

  1. Instale o pip. A maneira mais fácil é usar o standalone pip installer. Se sua distribuição já tem o pip instalado, você talvez precisa atualizá-lo se estiver desatualizado, você saberá porque a instalação não irá funcionar.
  2. Dê uma olhada no virtualenv e no virtualenvwrapper. Essas ferramentas fornecem ambientes Python isolados, o qual é mais prático que instalar os pacotes no sistema. Eles também permitem instalar pacotes sem previlégios de administrador. O tutorial de contribuição passa por como criar um virtualenv para Python 3.
  3. Depois que tenha criado e ativado um ambiente virtua, execute o comando pip install Django no “prompt” do seu shell.

Instalando um pacote de uma distribuição específica.

Verifique as notas específicas de distribuições para ver se sua plataforma/distribuição fornecem pacotes/instaladores oficiais do Django. Pacotes fornecidos por distribuições tipicamente irão permitir uma instalação automática de dependências e facilmente atualizar os “paths”; contudo, estes pacotes raramente irão conter a última versão do Django.

Instalando a versão de desenvolvimento.

Acompanhando o desenvolvimento do Django.

Se você decidir usar a última versão de desenvolvimento do Django, você precisará acompanhar de perto o the development timeline, e irá querer manter um olho no notas de desenvolvimento para o próximo lançamento. Isso lhe ajudará a se manter no topo de qualquer nova funcionalidade que você talvez queira usar, assim como qualquer mudança que você precise fazer no seu código quando atualizar sua cópia do Django. (Para lançamentos estabilizados, qualquer mudança necessária é documentada nas notas de lançamento.)

Se você quiser ser capaz de ocasionalmenete atualizar o seu código Django com as últimas correções e melhorias, siga estas instruções:

  1. Assegure-se que tenha instalado o Git e que você pode executar seus comandos no seu shell. (Digite git help no “prompt” do seu shell para testar.)

  2. Pegue o pricipal ramo de desenvolvimento do Django como aqui:

    $ git clone git://github.com/django/django.git

    Isso irá criar um diretório django no seu diretório corrente.

  3. Assegure-se que o interpretador Python pode carregar o código do Django. A maneira mais conveniente de fazer isso é usar o vittualenv, virtualenvwrapper, e pip. O tutorial de contribuição passa por como criar um virtualenv no Python 3.

  4. Depois de configurar e ativar o virtualenv, rode o seguinte comando:

    $ pip install -e django/

    Isso fará com que o código do Django seja passível de importação, e fará co que o comando utilitário django-admin esteja disponível. Em outras palavras, você está pronto.

Quando quiser atualizar sua cópia do código fonte do Django, apenas rode o comando git pull de dentro do diretório do Django. Quando fizer isso, o Git automaticamente irá baixar qualquer mudança.

Usando o Django
Modelos e bancos de dados
Back to Top