Instalando o Django Web Framework no Ubuntu 20.04

Django é um framework web de alto nível que permite o desenvolvimento rápido de sites seguros e de fácil manutenção. É um framework gratuito e de código aberto escrito em Python. O Django também é popular por recursos adicionais como desempenho, segurança, escalabilidade, portabilidade e manutenibilidade.

Este guia irá demonstrar como instalar o Django e configurar uma aplicação web simples no Ubuntu 20.04.

Django no Ubuntu

Existem várias maneiras de instalar o Django no sistema. Cada método se adequa a um objetivo diferente.

• Instalação global: O Django está prontamente disponível nos repositórios oficiais de pacotes do Ubuntu. Podemos instalá-lo diretamente usando o gerenciador de pacotes APT. Embora o método de instalação seja simples, ele oferece menos flexibilidade do que outros métodos. Além disso, pode não conter a versão mais recente do framework.
• Instalando usando o pip em um ambiente virtual: Usando ferramentas como venv e virtualenv, podemos estabelecer um ambiente virtual e instalar o Django nele. O benefício dessa abordagem é que ela não afeta o sistema como um todo. Também permite personalização e pacotes por projeto. É o método mais prático e recomendado para trabalhar com o Django.
• Instalando a versão de desenvolvimento do Django: O Django também está disponível no GitHub. A versão de desenvolvimento mais recente terá os recursos/correções mais recentes. No entanto, isso vem com o custo de possíveis problemas de desempenho e estabilidade.

Este guia pressupõe que você tenha um servidor Ubuntu configurado corretamente. Se você ainda não tem um servidor Ubuntu, pode seguir o nosso guia sobre como configurar seu próprio servidor Ubuntu.

Instalando o Django no Ubuntu

1. Instalação global usando o gerenciador de pacotes

O Django está prontamente disponível nos repositórios de pacotes oficiais. O processo de instalação é bastante simples. Primeiro, atualize o índice de pacotes do APT:

Em seguida, verifique a versão do Python instalada. Por padrão, o Ubuntu 20.04 vem com o Python 3.8:

Agora, estamos prontos para instalar o Django:

Podemos verificar se a instalação foi bem-sucedida. Execute o seguinte comando para verificar a versão do Django:

Isso verifica que o Django foi instalado com sucesso. Observe que a versão do Django não é a versão estável mais recente. No momento em que este artigo foi escrito, a versão mais recente do Django disponível é v3.2.5 (versão LTS).

2. Instalando o Django com pip (em um ambiente virtual)

Esta é a maneira recomendada de instalar o Django porque oferece a maior flexibilidade. Geraremos o ambiente virtual usando o módulo venv que vem como parte da biblioteca padrão do Python 3. Ele permite que você crie ambientes virtuais Python e instale pacotes Python sem causar alterações em outras partes do sistema. Você pode ter vários ambientes virtuais com configurações exclusivas.

Vamos começar. Primeiro, precisamos dos módulos Python pip e venv :

Os módulos foram instalados com sucesso. Agora, criaremos um diretório dedicado para o ambiente virtual:

Em seguida, mude o diretório ativo para o novo diretório:

Agora, podemos dizer ao venv para estabelecer um ambiente virtual dentro do diretório. Quanto ao nome do ambiente, deve ser algo descritivo:

O venv criará uma cópia do Python e do pip em uma estrutura de diretórios isolada dentro do diretório do projeto. Ele conterá um diretório com o nome selecionado que contém a hierarquia de arquivos onde todos os pacotes são instalados.

Para instalar pacotes adicionais, precisamos ativar o ambiente:

O prompt do shell deve mudar para algo assim:

Dentro do ambiente virtual, agora podemos instalar o Django:

Verifique se a instalação foi bem-sucedida:

Para sair do ambiente virtual, execute o seguinte comando:

3. Instalando a versão de desenvolvimento do Django

A versão de desenvolvimento do Django está diretamente disponível no GitHub. Usaremos o git para cloná-lo e implantá-lo dentro de um ambiente virtual.

Primeiro, certifique-se de que temos as ferramentas necessárias instaladas. O seguinte comando instalará o venv e o pip (módulos Python) e o git:

Em seguida, clone o repositório do Django. Ele conterá todos os recursos e correções de bugs mais recentes (à custa da estabilidade). Vamos cloná-lo para um diretório ~/django-dev:

Altere o diretório atual para o repositório clonado:

Depois disso, estabeleça um ambiente virtual usando o módulo venv do Python:

Em seguida, ative o ambiente virtual:

Agora, podemos instalar o Django que clonamos do GitHub. Aqui, a flag -e refere-se ao modo “editável” para permitir a instalação a partir do controle de versão:

Finalmente, verifique a instalação:

Projeto Django de Exemplo

Até agora, demonstramos como instalar o Django no sistema. Agora, é hora de colocar o Django em ação. Nesta seção, demonstraremos como criar um projeto Django de exemplo. O projeto de exemplo será criado dentro de um ambiente virtual.

Crie um diretório para o projeto de exemplo:

Altere o diretório atual para o diretório do projeto:

Em seguida, use o módulo venv para estabelecer um ambiente virtual Python:

O ambiente virtual está pronto. Ative o ambiente:

Podemos instalar o Django dentro do ambiente:

Podemos usar o django-admin para construir a base do projeto. Aqui, o projeto de exemplo será chamado sampleproject. O projeto terá um diretório dentro do diretório do ambiente que inclui todos os arquivos necessários.

• manage.py: Um script de gerenciamento que administra várias tarefas específicas do Django.
• projeto de exemplo: Um diretório com o nome do projeto que contém o código real do projeto.

No entanto, não queremos uma teia de aranha de muitos diretórios aninhados. Portanto, diga ao Django para colocar os arquivos e diretórios no diretório atual:

O próximo passo é migrar o banco de dados. Por padrão, o Django usa o SQLite. Migrações aplicam quaisquer alterações feitas nos modelos do Django ao esquema do banco de dados. Execute o seguinte comando para migrar o banco de dados:

Finalmente, estabeleceremos um usuário administrador para usar a interface de administração do Django. Execute o seguinte comando:

Ele solicitará um nome de usuário, um endereço de e-mail e uma senha para o usuário.

ALLOWED_HOSTS nas Configurações do Django

Para testar a aplicação, precisamos modificar uma determinada diretiva nas configurações do Django. Abra o arquivo settings.py em um editor de texto:

Estamos interessados na diretiva ALLOWED_HOSTS. Ela descreve uma lista de endereços ou nomes de domínio que podem se conectar à instância do Django. Qualquer solicitação de host recebida de um host que não esteja na lista gerará uma exceção. Isso é exigido pelo Django para evitar certas classes de vulnerabilidades de segurança.

Dentro dos colchetes, liste os endereços IP ou nomes de domínio associados ao servidor Django. Cada item será listado entre aspas, separado por uma vírgula (,). Veja como seria a estrutura da diretiva:

Salve a lista e feche o editor.

Testando o Servidor

Agora podemos iniciar o servidor de implantação do Django. Ele apresentará um projeto Django novo. Observe que ele deve ser usado apenas para fins de desenvolvimento. Para uma implantação completa, siga o guia oficial do Django sobre implantação.

Antes de acessar o servidor de desenvolvimento, certifique-se de que o firewall permite o acesso à porta 8000. Se você seguir o configuração do servidor Ubuntu, então diga ao UFW para abrir a porta 8000 para comunicação:

O UFW é um firewall comum disponível em todas as principais distribuições Linux. Aqui está um guia explicando vários conceitos básicos do UFW. O servidor de desenvolvimento está agora pronto para ser executado. Inicie o servidor:

Em seguida, visite o endereço IP do servidor na porta 8000 em um navegador web. Ele abrirá a página de boas-vindas do Django:

Para acessar o painel de administração do Django, adicione /admin/ no final do URL:

Insira o nome de usuário e a senha do administrador para acessar a seção de administração:

Você pode parar o servidor pressionando CTRL-C no terminal.

Considerações Finais

O projeto Django oferece uma base estrutural para projetar um site mais completo. Ele fornece as principais ferramentas necessárias para alimentar uma aplicação web. Aproveitar um framework web como o Django permite um desenvolvimento de projeto mais rápido e que você dedique mais tempo aos aspectos exclusivos da sua aplicação.

Boa computação!