Como Instalar o Framework Web Django no Ubuntu 22.04

Tutoriais
Django Python Ubuntu

Introdução

O Django é um framework web completo em Python para desenvolvimento de sites e aplicações dinâmicas. Usando o Django, você pode criar rapidamente aplicações web em Python e contar com o framework para fazer a maior parte do trabalho pesado.

Neste guia, você irá configurar o Django em um servidor Ubuntu 22.04. Após a instalação, você iniciará um novo projeto para usar como base para o seu site.

Métodos Diferentes

Há diferentes maneiras de instalar o Django, dependendo das suas necessidades e de como você deseja configurar seu ambiente de desenvolvimento. Estes têm diferentes vantagens e um método pode ser mais adequado à sua situação específica do que outros.

Alguns dos diferentes métodos incluem:

  • Instalação global a partir de pacotes: Os repositórios oficiais do Ubuntu contêm pacotes do Django que podem ser instalados com o gerenciador de pacotes convencional apt. Isso é simples, mas não tão flexível quanto alguns outros métodos. Além disso, a versão contida nos repositórios pode estar defasada em relação às versões oficiais disponíveis no projeto.
  • Instale com pip em um ambiente virtual: Você pode criar um ambiente autocontido para seus projetos usando ferramentas como venv e virtualenv. Um ambiente virtual permite que você instale o Django em um diretório de projeto sem afetar o sistema maior, juntamente com outras personalizações e pacotes específicos do projeto. Este é geralmente o método mais prático e recomendado para trabalhar com o Django.
  • Instale a versão de desenvolvimento com git: Se desejar instalar a última versão de desenvolvimento em vez da versão estável, você pode obter o código do repositório Git. Isso é necessário para obter os últimos recursos/correções e pode ser feito dentro do seu ambiente virtual. No entanto, as versões de desenvolvimento não têm as mesmas garantias de estabilidade que as versões mais estáveis.

Pré-requisitos

Antes de começar, você deve ter um usuário não root com privilégios sudo disponível no seu servidor Ubuntu 22.04. Para configurar isso, siga nosso guia de configuração inicial do servidor Ubuntu 22.04.

Instalação Global a partir de Pacotes

Se deseja instalar o Django usando os repositórios do Ubuntu, o processo é bastante direto.

Primeiro, atualize o índice de pacotes local com o apt: 

  1. sudo apt update

Em seguida, verifique qual versão do Python está instalada. O 22.04 é fornecido com o Python 3.10 por padrão, o que você pode verificar digitando: 

  1. python3 -V

Você deverá ver uma saída como esta: 

Output
Python 3.10.4

Depois, instale o Django: 

  1. sudo apt install python3-django

Você pode testar se a instalação foi bem-sucedida digitando: 

  1. django-admin --version



Output
3.2.12

Isso significa que o software foi instalado com sucesso. Você também pode observar que a versão do Django não é a mais recente. Para saber mais sobre como usar o software, pule para aprender como criar um projeto de exemplo.

Instalar com pip em um Ambiente Virtual

A maneira mais flexível de instalar o Django no seu sistema é dentro de um ambiente virtual. Mostraremos como instalar o Django em um ambiente virtual que criaremos com o módulo venv, parte da biblioteca padrão do Python 3. Esta ferramenta permite criar ambientes virtuais Python e instalar pacotes Python sem afetar o restante do sistema. Portanto, você pode selecionar pacotes Python em uma base por projeto, independentemente de conflitos com os requisitos de outros projetos.

Vamos começar atualizando o índice de pacotes local:

  1. sudo apt update

Verifique a versão do Python que você tem instalada:

  1. python3 -V



Output
Python 3.10.4

Em seguida, vamos instalar o pip e o venv nos repositórios do Ubuntu:

  1. sudo apt install python3-pip python3-venv

Agora, sempre que iniciar um novo projeto, você pode criar um ambiente virtual para ele. Comece criando e movendo-se para um novo diretório de projeto:

  1. mkdir ~/newproject

  2. cd ~/newproject

Em seguida, crie um ambiente virtual dentro do diretório do projeto usando o comando python compatível com sua versão do Python. Chamaremos nosso ambiente virtual de my_env, mas você deve nomeá-lo de forma descritiva:

  1. python3 -m venv my_env

Isso irá instalar versões independentes do Python e do pip em uma estrutura de diretório isolada dentro do diretório do seu projeto. Um diretório será criado com o nome que você selecionar, que conterá a hierarquia de arquivos onde seus pacotes serão instalados.

Para instalar pacotes no ambiente isolado, você deve ativá-lo digitando:

  1. source my_env/bin/activate

Seu prompt deverá mudar para refletir que você está agora em seu ambiente virtual. Ele se parecerá com algo assim (my_env)nome_de_usuário@nome_do_host:~/novo_projeto$.

No seu novo ambiente, você pode usar o pip para instalar o Django. Independentemente da sua versão do Python, o pip deve ser chamado apenas de pip quando estiver no seu ambiente virtual. Além disso, observe que você não precisa usar sudo pois está instalando localmente:

  1. pip install django

Você pode verificar a instalação digitando:

  1. django-admin --version



Output
4.0.4

Observe que sua versão pode ser diferente da versão mostrada aqui.

Para sair do seu ambiente virtual, você precisa emitir o comando deactivate de qualquer lugar do sistema:

  1. deactivate

Seu prompt deve voltar ao formato convencional. Quando desejar trabalhar em seu projeto novamente, reative seu ambiente virtual movendo-se de volta para o diretório do projeto e ativando-o:

  1. cd ~/newproject

  2. source my_env/bin/activate

Instalação da Versão de Desenvolvimento com Git

Se você precisar de uma versão de desenvolvimento do Django, pode baixar e instalar o Django do seu repositório Git. Vamos fazer isso de dentro de um ambiente virtual.

Primeiro, vamos atualizar o índice local de pacotes:

  1. sudo apt update

Verifique a versão do Python que você tem instalada:

  1. python3 -V



Output
Python 3.10.4

Em seguida, instale o pip e o venv dos repositórios oficiais:

  1. sudo apt install python3-pip python3-venv

O próximo passo é clonar o repositório do Django. Entre os lançamentos, este repositório terá recursos e correções de bugs mais atualizados, com possíveis custos de estabilidade. Você pode clonar o repositório para um diretório chamado ~/django-dev dentro do seu diretório pessoal digitando:

  1. git clone git://github.com/django/django ~/django-dev

Mude para este diretório:

  1. cd ~/django-dev

Crie um ambiente virtual usando o comando python que seja compatível com sua versão instalada do Python:

  1. python3 -m venv my_env

Ative-o:

  1. source my_env/bin/activate

Em seguida, você pode instalar o repositório usando pip. A opção -e irá instalar no modo “editável”, o que é necessário ao instalar a partir do controle de versão:

  1. pip install -e ~/django-dev

Você pode verificar se a instalação foi bem-sucedida digitando:

  1. django-admin --version



Output
4.0.4.2

Novamente, a versão que você vê exibida pode não corresponder ao que é mostrado aqui.

Agora você tem a versão mais recente do Django em seu ambiente virtual.

Criando um Projeto de Exemplo

Com o Django instalado, você pode começar a construir seu projeto. Vamos explicar como criar um projeto e testá-lo em seu servidor de desenvolvimento usando um ambiente virtual.

Primeiro, crie um diretório para o seu projeto e entre nele:

  1. mkdir ~/django-test

  2. cd ~/django-test

Em seguida, crie seu ambiente virtual:

  1. python3 -m venv my_env

Ative o ambiente:

  1. source my_env/bin/activate

Instale o Django:

  1. pip install django

Para construir seu projeto, você pode usar django-admin com o comando startproject. Vamos chamar nosso projeto de djangoproject, mas você pode substituir isso por um nome diferente. startproject criará um diretório dentro do diretório de trabalho atual que inclui:

  • A management script, manage.py, which you can use to administer various Django-specific tasks.
  • A directory (with the same name as the project) that includes the actual project code.

Para evitar ter muitos diretórios aninhados, no entanto, vamos dizer ao Django para colocar o script de gerenciamento e o diretório interno no diretório atual (observe o ponto final):

  1. django-admin startproject djangoproject .

Para migrar o banco de dados (este exemplo usa SQLite por padrão), vamos usar o comando migrate com manage.py. As migrações aplicam quaisquer alterações que você fez em seus models Django ao esquema do seu banco de dados.

Para migrar o banco de dados, digite:

  1. python manage.py migrate

Você verá uma saída como a seguinte:

Output
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying auth.0012_alter_user_first_name_max_length... OK
  Applying sessions.0001_initial... OK

Finalmente, vamos criar um usuário administrativo para que você possa usar a interface de administração do Django. Vamos fazer isso com o comando createsuperuser:

  1. python manage.py createsuperuser

Você será solicitado a fornecer um nome de usuário, um endereço de e-mail e uma senha para o usuário.

Modificando ALLOWED_HOSTS nas Configurações do Django

Para testar com sucesso sua aplicação, será necessário modificar uma das diretrizes nas configurações do Django.

Abra o arquivo de configurações digitando:

  1. nano ~/django-test/djangoproject/settings.py

Dentro, localize a diretiva ALLOWED_HOSTS. Isso define uma lista de endereços ou nomes de domínio que podem ser usados para se conectar à instância do Django. Uma solicitação de entrada com um cabeçalho Host que não estiver nesta lista irá gerar uma exceção. O Django requer que você defina isso para prevenir uma certa classe de vulnerabilidade de segurança.

Nos colchetes, liste os endereços IP ou nomes de domínio associados ao seu servidor Django. Cada item deve ser listado entre aspas, com entradas separadas por vírgula. Se você deseja solicitações para um domínio inteiro e quaisquer subdomínios, adicione um ponto ao início da entrada:

~/django-test/djangoproject/settings.py
ALLOWED_HOSTS = ['your_server_ip_or_domain', 'your_second_ip_or_domain', . . .]

Quando terminar, salve o arquivo e saia do seu editor.

Testando o Servidor de Desenvolvimento

Depois de ter um usuário, você pode iniciar o servidor de desenvolvimento do Django para ver como fica um projeto Django novo. Você só deve usar isso para fins de desenvolvimento. Quando estiver pronto para implantar, certifique-se de seguir as diretrizes de implantação do Django cuidadosamente.

Antes de tentar o servidor de desenvolvimento, verifique se você abriu a porta apropriada no seu firewall. Se você seguiu o guia de configuração inicial do servidor e está usando o UFW, pode abrir a porta 8000 digitando:

  1. sudo ufw allow 8000

Inicie o servidor de desenvolvimento:

  1. python manage.py runserver your_server_ip:8000

Visite o endereço IP do seu servidor seguido por :8000 no seu navegador da web:

http://your_server_ip:8000

Você deverá ver algo parecido com isto:

Para acessar a interface de administração, adicione /admin/ ao final da sua URL:

http://your_server_ip:8000/admin/

Isso o levará para uma tela de login:

Se você inserir o nome de usuário e senha de administrador que acabou de criar, terá acesso à seção principal de administração do site:

Para obter mais informações sobre como trabalhar com a interface de administração do Django, consulte “Como Habilitar e Conectar a Interface de Administração do Django”.

Quando terminar de explorar o site padrão, você pode interromper o servidor de desenvolvimento digitando CTRL-C no seu terminal.

O projeto Django que você criou fornece a base estrutural para projetar um site mais completo. Confira a documentação do Django para obter mais informações sobre como construir suas aplicações e personalizar seu site.

Conclusão

Agora você deve ter o Django instalado no seu servidor Ubuntu 22.04, fornecendo as principais ferramentas que você precisa para criar poderosas aplicações web. Você também deve saber como iniciar um novo projeto e lançar o servidor de desenvolvimento. Alavancar um framework web completo como o Django pode ajudar a tornar o desenvolvimento mais rápido, permitindo que você se concentre apenas nos aspectos únicos de suas aplicações.

Se você deseja obter mais informações sobre como trabalhar com Django, incluindo discussões detalhadas sobre coisas como modelos e visualizações, por favor, consulte nossa série de desenvolvimento do Django.

Source:
https://www.digitalocean.com/community/tutorials/how-to-install-the-django-web-framework-on-ubuntu-22-04