Como Instalar o Framework de Aplicação Web Django no Debian 10

Django é um framework de aplicação web de código aberto que ajuda você a desenvolver sites e aplicações dinâmicas. É seguro, rápido e estável, permitindo que você crie um site complexo com menos código. Existem várias maneiras de instalar o Django em seu sistema. Você pode instalá-lo usando o repositório Debian, usando o PIP ou a partir do repositório Git. Você pode escolher qualquer método dependendo de suas necessidades. O Django permite que você crie um projeto em ambientes virtuais Python. Dessa forma, você pode criar múltiplos ambientes Django em um único sistema.

Neste tutorial, aprenderemos como instalar o framework web Django com PIP no Debian 10. Também aprenderemos como criar uma aplicação Django e conectá-la a um banco de dados.

Pré-requisitos

• Um servidor rodando Debian 10.
• Uma senha de root configurada em seu servidor.

Começando

Antes de começar, atualize seu sistema com a versão mais recente. Você pode fazer isso executando o seguinte comando:

apt-get update -y  
apt-get upgrade -y

Uma vez que seu sistema esteja atualizado, reinicie-o para aplicar as mudanças.

Instalar Django

Django é escrito na linguagem Python. Portanto, você precisará instalar as dependências do Python em seu sistema para instalar o Django. Você pode instalar todas elas com o seguinte comando:

apt-get install python3 python3-pip tree -y

Após instalar todos os pacotes, você pode verificar a versão instalada do PIP com o seguinte comando:

pip3 -V

Você deve obter a seguinte saída:

pip 18.1 from /usr/lib/python3/dist-packages/pip (python 3.7)

Agora, você pode prosseguir para instalar o Django usando o comando PIP conforme mostrado abaixo:

pip3 install Django

Uma vez que a instalação foi concluída, verifique a versão do Django usando o seguinte comando:

django-admin --version

Você deve ver a seguinte saída:

3.0.2

Neste ponto, o Django foi instalado em seu servidor. Você pode agora prosseguir para o próximo passo.

Criar um Projeto Django

Agora vamos começar a criar um projeto Django de exemplo. Primeiro, mude o diretório para o /opt onde você deseja criar um projeto Django:

cd /opt

Em seguida, execute o seguinte comando para criar um novo projeto Django chamado Dproject:

django-admin startproject Dproject

Uma vez que o projeto foi criado, você pode ver a estrutura de diretórios deste projeto com o seguinte comando:

tree

Você deve obter a seguinte saída:

.
??? Dproject
    ??? Dproject
    ?   ??? asgi.py
    ?   ??? __init__.py
    ?   ??? settings.py
    ?   ??? urls.py
    ?   ??? wsgi.py
    ??? manage.py

Em seguida, mude o diretório para o Dproject e migre as mudanças pendentes com o seguinte comando:

cd Dproject  
python3 manage.py migrate

Uma vez que a migração foi concluída com sucesso, você deve ver a seguinte saída:

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 sessions.0001_initial... OK

Neste ponto, um novo projeto Django foi criado dentro do diretório /opt.

Criar um Super Usuário para Django

Em seguida, você precisará criar um superusuário para o Django acessar a interface administrativa do Django. Você pode criá-lo com o seguinte comando:

python3 manage.py createsuperuser

Forneça seu nome de usuário desejado, endereço de e-mail e senha conforme mostrado abaixo:

Username (leave blank to use 'root'): admin
Email address: [email protected]
Password: 
Password (again): 
Superuser created successfully.

Iniciar o Servidor Django

Por padrão, o Django não é acessível a partir do sistema remoto. Portanto, você precisará configurar o Django e definir o IP do seu servidor. Você pode fazer isso editando o arquivo settings.py.

nano /opt/Dproject/Dproject/settings.py

Altere a seguinte linha:

ALLOWED_HOSTS = ['your-server-ip']

Salve e feche o arquivo quando terminar. Em seguida, inicie o servidor Django com o seguinte comando:

cd /opt/Django  
python3 manage.py runserver 0.0.0.0:8000

Uma vez que o servidor tenha sido iniciado com sucesso, você deve obter a seguinte saída:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:01:23
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

Acessar a Aplicação Django

Neste ponto, a aplicação Django está iniciada e ouvindo na porta 8000. Para acessá-la, abra seu navegador web e digite a URL http://your-server-ip:8000. Você deve ver a aplicação Django na seguinte tela:

Para acessar a interface administrativa do Django, abra seu navegador web e digite a URL http://your-server-ip:8000/admin. Você será redirecionado para a página de login do Django:

Forneça seu nome de usuário, senha do administrador do Django e clique no botão Log in. Você deve ver a interface administrativa do Django na seguinte tela:

Instalar o Conector de Banco de Dados MariaDB

Em seguida, você precisará instalar o conector de banco de dados MariaDB e outros pacotes de desenvolvimento para conectar o Django ao banco de dados MariaDB. Você pode instalar todos eles usando o seguinte comando:

apt-get install mariadb-server python3-dev libmariadb-dev libmariadbclient-dev -y

Uma vez que todos os pacotes estejam instalados, você pode instalar a biblioteca mysqlclient usando o comando PIP conforme mostrado abaixo:

pip3 install mysqlclient

Uma vez instalado, faça login no shell do MariaDB com o seguinte comando:

mysql

Em seguida, defina a senha root para o MariaDB com o seguinte comando.

MariaDB [(none)]> SET PASSWORD FOR 'root'@'localhost' = PASSWORD("newpassword");

Em seguida, crie um banco de dados para o Django com o seguinte comando:

MariaDB [(none)]> create database testdb;

Você pode ver o banco de dados criado acima usando o seguinte comando:

MariaDB [(none)]> show databases;

Você deve obter a seguinte saída:

+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| testdb             |
+--------------------+

Em seguida, limpe os privilégios e saia do shell do MariaDB com o seguinte comando:

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

Configurar o Django para Conexão com MariaDB

Em seguida, você precisará definir as credenciais do banco de dados MariaDB no Django. Você pode defini-las editando o arquivo settings.py:

nano /opt/Dproject/Dproject/settings.py

Encontre as seguintes linhas:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

E substitua-as pelas seguintes linhas:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS': {
        'read_default_file': '/etc/mysql/mariadb.conf.d/50-client.cnf',
        },
    }
}

Salve e feche o arquivo quando terminar. Em seguida, edite o arquivo de credenciais do cliente MariaDB conforme mostrado abaixo:

nano /etc/mysql/mariadb.conf.d/50-client.cnf

Defina suas credenciais do banco de dados MariaDB conforme mostrado abaixo:

[client]
database = testdb 
user = root   
password = newpassword
default-character-set = utf8

Salve e feche o arquivo e reinicie o serviço MariaDB para implementar as mudanças:

systemctl restart mariadb

Em seguida, mude o diretório para o projeto Django e migre as novas mudanças com o seguinte comando:

cd /opt/Dproject  
python3 manage.py migrate

Uma vez que a migração foi concluída com sucesso, você pode prosseguir para o próximo passo.

Testar Conexão com MariaDB

Neste ponto, o Django está configurado para conectar ao banco de dados MariaDB. É hora de testá-lo.

Para isso, inicie o servidor Django com o seguinte comando:

cd /opt/Django  
python3 manage.py runserver 0.0.0.0:8000

Uma vez que o servidor Django tenha sido iniciado com sucesso, você deve obter a seguinte saída:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:30:49
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

Você pode agora acessar sua aplicação Django usando a URL http://your-server-ip:8000. Você deve ver sua aplicação Django na seguinte tela:

Após testar, você pode parar o servidor Django a qualquer momento pressionando CTRL + C em seu terminal.

Conclusão

Parabéns! você instalou com sucesso o Django e o conectou ao banco de dados MariaDB no servidor Debian 10. Agora você pode começar a desenvolver sua aplicação web e aplicar migrações em sua aplicação Django. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.