Debian 11에 Django Framework를 설치하는 방법

이 튜토리얼은 다음 OS 버전에 대해 존재합니다.

데비안 11(불스아이)
데비안 10(버스터)

이 페이지에서

전제 조건
시작하기\n
PostgreSQL 데이터베이스 서버 설치
Python 가상 환경 만들기\n
Django 설치 및 구성
Django 개발 서버 실행\n
Gunicorn으로 Django 확인\n
Gunicorn용 Systemd 서비스 파일 만들기
Django의 역방향 프록시로 Nginx 구성\n
결론

Django는 Python으로 작성된 무료 오픈 소스 웹 개발 프레임워크입니다. 복잡한 데이터베이스 기반 Python 응용 프로그램을 개발하는 데 사용됩니다. Python 프로젝트를 생성하기 위한 Python 스크립트 세트와 함께 제공됩니다. Windows, macOS, Linux/Unix 및 Solaris를 포함하여 Python을 실행할 수 있는 모든 운영 체제에서 실행할 수 있습니다. 개발자가 적은 코드를 작성하고 짧은 시간에 새 웹 사이트를 만들 수 있도록 도와줍니다.

이 튜토리얼에서는 Debian 11에서 PostgreSQL 데이터베이스를 사용하여 Python 가상 환경에서 Django를 설정하는 방법을 설명합니다. 그런 다음 Nginx를 Django의 리버스 프록시로 설치하고 구성합니다.

전제 조건

Debian 11을 실행하는 서버.\n
서버 IP를 가리키는 유효한 도메인 이름입니다.\n
루트 암호는 서버에서 구성됩니다.\n

시작하기

시작하기 전에 시스템 패키지를 최신 버전으로 업데이트하는 것이 좋습니다. 다음 명령을 사용하여 수행할 수 있습니다.

apt-get update -y

모든 패키지가 업데이트되면 다음 명령을 사용하여 다른 Python 도구와 Nginx 패키지를 설치합니다.

apt-get install python3-pip python3-dev libpq-dev curl nginx -y

필요한 모든 패키지가 설치되면 다음 단계로 진행할 수 있습니다.

PostgreSQL 데이터베이스 서버 설치

여기에서는 PostgreSQL을 데이터베이스 백엔드로 사용합니다. 따라서 다음 명령을 사용하여 설치해 보겠습니다.

apt-get install postgresql postgresql-contrib -y

PostgreSQL이 설치되면 다음 명령을 사용하여 PostgreSQL 셸에 연결합니다.

su - postgres
psql

다음으로 다음 명령을 사용하여 Django용 데이터베이스와 사용자를 생성합니다.

CREATE DATABASE django;
CREATE USER django WITH PASSWORD 'password';

다음으로 다음 명령을 사용하여 일부 필수 역할을 부여합니다.

ALTER ROLE django SET client_encoding TO 'utf8';
ALTER ROLE django SET default_transaction_isolation TO 'read committed';
ALTER ROLE django SET timezone TO 'UTC';
GRANT ALL PRIVILEGES ON DATABASE django TO django;

그런 다음 다음 명령을 사용하여 PostgreSQL 셸을 종료합니다.

\q
exit

이 시점에서 PostgreSQL 데이터베이스는 Django에 대해 준비되었습니다. 이제 다음 단계를 진행할 수 있습니다.

Python 가상 환경 만들기

다음으로 Django 프로젝트를 만들려면 Python 가상 환경을 만들어야 합니다.

먼저 다음 명령을 사용하여 PIP 패키지를 최신 버전으로 업그레이드합니다.

pip3 install --upgrade pip

다음으로 다음 명령을 사용하여 PIP 버전을 확인합니다.

pip --version

샘플 출력:

pip 21.2.4 from /usr/local/lib/python3.9/dist-packages/pip (python 3.9)

다음으로 다음 명령을 사용하여 가상 환경 패키지를 설치합니다.

pip3 install virtualenv

다음으로 Django 프로젝트용 디렉터리를 만들고 Django 가상 환경을 만듭니다.

mkdir ~/djangoapp
cd ~/djangoapp
virtualenv djangoenv

다음으로 아래 명령을 사용하여 Django 가상 환경을 활성화합니다.

source djangoenv/bin/activate

다음으로 다음 명령을 사용하여 Django, Gunicorn 및 기타 패키지를 설치합니다.

pip install django gunicorn psycopg2-binary

이 시점에서 Django는 Python 가상 환경에 설치됩니다. 이제 다음 단계로 진행할 수 있습니다.

Django 설치 및 구성

Django는 프로젝트를 생성하기 위한 django-admin.py 스크립트를 제공합니다. 다음 명령을 실행하여 Django 프로젝트를 생성할 수 있습니다.

django-admin.py startproject djangoapp ~/djangoapp

다음으로 settings.py를 편집하고 데이터베이스 설정을 정의해야 합니다.

nano ~/djangoapp/djangoapp/settings.py

도메인 이름으로 다음 줄을 변경합니다.

ALLOWED_HOSTS = ['django.example.com', 'localhost']

기본 데이터베이스 백엔드의 주석을 제거하고 PostgreSQL 데이터베이스 설정을 추가합니다.

#DATABASES = {
#    'default': {
#        'ENGINE': 'django.db.backends.sqlite3',
#        'NAME': BASE_DIR / 'db.sqlite3',
#    }
#}

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'django',
        'USER': 'django',
        'PASSWORD': 'password',
        'HOST': 'localhost',
        'PORT': '',

    }
}

파일 끝에 다음 줄을 추가합니다.

STATIC_URL = '/static/'
import os
STATIC_ROOT = os.path.join(BASE_DIR, 'static/')

파일을 저장하고 닫은 다음 초기 데이터베이스 스키마를 PostgreSQL 데이터베이스로 마이그레이션합니다.

./manage.py makemigrations
./manage.py migrate

샘플 출력L:

  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

그런 다음 다음 명령을 사용하여 Django의 수퍼유저 계정을 만듭니다.

./manage.py createsuperuser

아래와 같이 관리자 사용자 이름과 비밀번호를 설정합니다.

Username (leave blank to use 'root'): dadmin
Email address: 
Password: 
Password (again): 
Superuser created successfully.

다음으로 모든 정적 콘텐츠를 디렉터리로 수집합니다.

./manage.py collectstatic

Django 개발 서버 실행

이 시점에서 Django가 설치되고 구성됩니다. 이제 다음 명령을 사용하여 Django 개발 서버를 시작할 수 있습니다.

./manage.py runserver 0.0.0.0:8000

모든 것이 정상이면 다음과 같은 결과가 표시됩니다.

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

System check identified no issues (0 silenced).
August 27, 2021 - 10:02:05
Django version 3.2.6, using settings 'djangoapp.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

이제 웹 브라우저를 열고 URL http://django.example.com:8000/admin/을 사용하여 Django 프로젝트에 액세스합니다. Django 로그인 페이지로 리디렉션됩니다.

관리자 사용자 이름, 암호를 제공하고 로그인을 클릭합니다. 다음 페이지에 Django 대시보드가 표시되어야 합니다.

이제 터미널로 돌아가서 CTRL + C를 눌러 Django 개발 서버를 중지합니다.

Gunicorn으로 Django 확인

다음으로 Gunicorn이 Django를 지원할 수 있는지 여부도 테스트해야 합니다. 다음 명령으로 Gunicorn 서버를 사용하여 Django를 시작할 수 있습니다.

gunicorn --bind 0.0.0.0:8000 djangoapp.wsgi

모든 것이 정상이면 다음과 같은 결과가 표시됩니다.

[2021-08-27 10:04:22 +0000] [47383] [INFO] Starting gunicorn 20.1.0
[2021-08-27 10:04:22 +0000] [47383] [INFO] Listening at: http://0.0.0.0:8000 (47383)
[2021-08-27 10:04:22 +0000] [47383] [INFO] Using worker: sync
[2021-08-27 10:04:22 +0000] [47384] [INFO] Booting worker with pid: 47384

CTRL + C를 눌러 Gunicorn 서버를 중지합니다.

다음으로 다음 명령을 사용하여 Python 가상 환경에서 비활성화합니다.

deactivate

Gunicorn용 Systemd 서비스 파일 생성

다음으로 Django 애플리케이션 서버를 시작하고 중지하려면 Gunicorn에 대한 systemd 서비스 파일을 생성해야 합니다.

다음 명령을 사용하여 Gunicorn을 만들 수 있습니다.

nano /etc/systemd/system/gunicorn.socket

다음 줄을 추가합니다.

[Unit]
Description=gunicorn socket

[Socket]
ListenStream=/run/gunicorn.sock

[Install]
WantedBy=sockets.target

파일을 저장하고 닫은 다음 Gunicorn에 대한 서비스 파일을 만듭니다.

nano /etc/systemd/system/gunicorn.service

Django 프로젝트 경로와 일치하는 다음 행을 추가하십시오.

[Unit]
Description=gunicorn daemon
Requires=gunicorn.socket
After=network.target
[Service]
User=root
Group=www-data
WorkingDirectory=/root/djangoapp
ExecStart=/root/djangoapp/djangoenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunicorn.sock          djangoapp.wsgi:application

[Install]
WantedBy=multi-user.target

파일을 저장하고 닫은 다음 Django 프로젝트 디렉터리에 대한 적절한 권한을 설정합니다.

chown -R www-data:root ~/djangoapp

다음으로 다음 명령을 사용하여 systemd 데몬을 다시 로드합니다.

systemctl daemon-reload

다음으로 Gunicorn 서비스를 시작하고 시스템 재부팅 시 시작되도록 활성화합니다.

systemctl start gunicorn.socket
systemctl enable gunicorn.socket

다음으로 아래 명령을 사용하여 Gunicorn의 상태를 확인합니다.

systemctl status gunicorn.socket

다음 출력이 표시되어야 합니다.

? gunicorn.socket - gunicorn socket
     Loaded: loaded (/etc/systemd/system/gunicorn.socket; disabled; vendor preset: enabled)
     Active: active (listening) since Fri 2021-08-27 10:05:46 UTC; 6s ago
   Triggers: ? gunicorn.service
     Listen: /run/gunicorn.sock (Stream)
     CGroup: /system.slice/gunicorn.socket

Aug 27 10:05:46 debian11 systemd[1]: Listening on gunicorn socket.

Nginx를 Django의 리버스 프록시로 구성

다음으로 Django를 제공하기 위해 Nginx를 리버스 프록시로 구성해야 합니다.

이렇게 하려면 Nginx 구성 파일을 만듭니다.

nano /etc/nginx/conf.d/django.conf

다음 줄을 추가합니다.

server {
     listen 80;
     server_name django.example.com;
    location = /favicon.ico { access_log off; log_not_found off; }


    location /static/ {
         root /root/djangoapp;
     }

    location / {
         include proxy_params;
         proxy_pass http://unix:/run/gunicorn.sock;
     }
}

파일을 저장하고 닫은 다음 구성 오류가 있는지 Nginx를 확인합니다.

nginx -t

Output:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

마지막으로 Nginx 서비스를 다시 시작하여 변경 사항을 적용합니다.

systemctl restart nginx

Nginx의 상태를 확인하려면 다음을 실행합니다.

systemctl status nginx

샘플 출력:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2021-08-27 10:06:59 UTC; 6s ago
       Docs: man:nginx(8)
    Process: 47494 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 47495 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 47496 (nginx)
      Tasks: 2 (limit: 2341)
     Memory: 2.5M
        CPU: 49ms
     CGroup: /system.slice/nginx.service
             ??47496 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??47497 nginx: worker process

Aug 27 10:06:59 debian11 systemd[1]: Starting A high performance web server and a reverse proxy server...
Aug 27 10:06:59 debian11 systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Aug 27 10:06:59 debian11 systemd[1]: Started A high performance web server and a reverse proxy server.

이제 URL http://django.example.com/admin을 사용하여 Django 애플리케이션에 액세스할 수 있습니다. URL http://django.example.com/을 사용하여 Django 애플리케이션에 액세스할 수도 있습니다.

결론

축하합니다! Gunicorn 및 Nginx를 리버스 프록시로 사용하여 Django 애플리케이션을 성공적으로 설치했습니다. 이제 Django 프레임워크를 사용하여 Python 애플리케이션 배포를 시작할 수 있습니다.