Hetzner と Dokku を使用して低予算で Django をデプロイする方法-Python チュートリアル-php.cn

Django アプリケーションのデプロイは、特に適切なインフラストラクチャを選択する場合に困難になることがあります。

Hetzner と Dokku を組み合わせることで、展開プロセスを容易にする強力で柔軟なソリューションが提供されます。

Docker 上に構築されたサービスとしてのプラットフォーム (PaaS) である Dokku を使用すると、アプリケーションを簡単にデプロイ、管理、拡張できます。

このガイドでは、Dokku を使用して Django アプリケーションを Hetzner にデプロイする方法を説明します。

ヘッツナーとドックとは何ですか？

Hetzner は、専用サーバー、クラウドホスティング、仮想プライベートサーバー (VPS)、コロケーションサービスなど、さまざまな Web ホスティングサービスを提供するドイツの会社です。

高性能インフラストラクチャを手頃な価格で提供することで知られており、開発者、企業、テクノロジー愛好家の間で人気があります。

Hetzner のデータセンターは主にドイツとフィンランド (ただし、米国と現在はシンガポールにも) にあり、強力なセキュリティ、信頼性、拡張性の高いソリューションを提供しています。

費用対効果の高いクラウドホスティングオプションが特に好まれており、ヨーロッパのホスティング市場における強力な競争相手となっています。

ドック

Dokku は、Web アプリケーションのデプロイと管理を簡単にするオープンソースツールです。

Docker を使用し、Heraku と同様に、Git を使用してアプリをデプロイできます。 Dokku は多くのプログラミング言語やフレームワークで動作し、データベースや SSL 証明書などを処理できます。

軽量でサーバー上でのセットアップが簡単なため、より制御性と柔軟性を備えた Heroku のようなセルフホスト型ソリューションを必要とする開発者にとって人気の選択肢となっています。

同じ古い Python コードを書くのに飽きていませんか?プログラミングスキルを次のレベルに引き上げたいですか?もう探す必要はありません。この本は、初心者と経験豊富な Python 開発者にとって同様に究極のリソースです。

「Python のマジックメソッド - init と str を超えた」を入手

マジックメソッドは単なる構文糖ではなく、コードの機能とパフォーマンスを大幅に向上させる強力なツールです。この本では、これらのツールを正しく使用し、Python の可能性を最大限に引き出す方法を学びます。

前提条件

展開プロセスを開始する前に、以下のものがあることを確認してください:

Django アプリケーション: Django アプリケーションをデプロイする準備ができている必要があります。これには、requirements.txt ファイルと Procfile が含まれている必要があります。
Hetzner Cloud アカウント: お持ちでない場合は、Hetzner でサインアップできます。
GitHub アカウント: アプリケーションをデプロイできるようにします。
コマンドラインの基本的な知識: ターミナルの使用に慣れている必要があります。

ステップ 1 - Hetzner で VPS を作成する

まず、Hetzner Cloud に VPS (仮想プライベートサーバー) を作成します。アカウントをお持ちでない場合は、ここからサインアップできます。

クラウドコンソールにアクセスしたら:

新しいプロジェクトを作成します。Hetzner Dokku と名付けます。プロジェクトを入力し、サーバーを追加します。
場所として、ヘルシンキ (EU-central) を選択しましょう。
イメージとして、Ubuntu 22.04 を選択しましょう (執筆時点では、Dokku は 24.04 をサポートしていません)
タイプとして、共有 CPU、x86 および CX22 (2vCPUS、4GB RAM、40GB SSD) を選択します。
ネットワークについては、IPv4 と IPv6 の両方をオンのままにします。
SSH キーの場合は、SSH キーを追加する必要があります。お持ちでない場合は、ssh-keygen を使用して生成できます。
その他のオプションは、今のところ省略しても問題ありません。必要に応じて、後でファイアウォールをアクティブにすることができます。
最後に名前を付けます。この場合は dokku-server とします。

次に、[今すぐ作成して購入] をクリックします。数秒後、VPS が起動して実行され、指定された IP アドレスで SSH でアクセスできるようになります:

ssh root@<ip_address>

ログイン後にコピー

ステップ 2 - Dokku をインストールする

VPS が設定され実行されているので、Dokku をインストールできます。その前に、次のようにして VPS を更新することをお勧めします。

apt update && apt upgrade -y

ログイン後にコピー

必要に応じて、VPS を再起動します。

Dokku のインストール

Dokku をインストールできるようになりました:

wget -NP . https://dokku.com/install/v0.34.8/bootstrap.sh
sudo DOKKU_TAG=v0.34.8 bash bootstrap.sh

ログイン後にコピー

この記事の執筆時点での最新バージョンは v0.34.8 でした。最新バージョンについては、Dokku Web サイトを確認してください。

デプロイメントプロセスをサポートするいくつかの Docker イメージをプルする必要があるため、これには数分かかる場合があります。

すべてのパッケージがアクティブで実行されていることを確認するために、インストール後にサーバーを再起動する必要があります。

SSH キーと仮想ホストの設定をセットアップする

アプリケーションにアクセスするには、ドメイン名を取得することをお勧めします。ただし、https://slip.io/ でサブドメインをサポートする IP アドレスを使用することもできます。

まず、SSH キーを Dokku SSH 管理者キーにコピーする必要があります。

cat ~/.ssh/authorized_keys | dokku ssh-keys:add admin

ログイン後にコピー

次に、ドメインまたは IP アドレスを設定できます:

dokku domains:set-global <ip_address>.sslip.io

ログイン後にコピー

In this case, it defines the IP address, but with support for sub-domains with sslip.io.

Step 3 - Creating the application in Dokku

With Dokku installed and configured, you can now create the application in Dokku that will receive your Django application:

dokku apps:create django-app

ログイン後にコピー

This command creates an app called django-app.

Django requires a database and normally there is two choices, either a SQLite or Postgres database.

On Dokku, databases are part of the plugin packages and need to be installed separately:

dokku plugin:install https://github.com/dokku/dokku-postgres.git

ログイン後にコピー

This command will install Postgres by downloading the supporting Docker images.

To actually create a database that you can use with the recently created application, you can use the command:

dokku postgres:create django-app-db

ログイン後にコピー

Once the the database is created, you will need to link it to the Dokku application:

dokku postgres:link django-app-db django-app

ログイン後にコピー

Linked the database to the application means that the database URL is added to the environment variables of the application definitions in Dokku.

You can check that with the command:

dokku config:show django-app

ログイン後にコピー

Which should give a similar response to this:

=====> django-app env vars
DATABASE_URL:  postgres://postgres:bca0d7f59caf98c78a74d58457111a1e@dokku-postgres-django-app-db:5432/django_app_db

ログイン後にコピー

Step 4 - Creating the Django application

With Dokku installed, configured and an application created, you are now ready to create the actual Django application.

There are several guides on the Internet on how to create a Django application from scratch, so the focus on this article is on deploying the application to Django.

For this tutorial, I created a Django application in PyCharm using the default settings called DjangoAppDokku.

To be able to deploy the application to Dokku, there is some preparation steps that are necessary.

Let's start with making sure there is a requirements file with the command:

pip freeze > requirements.txt

ログイン後にコピー

Then you can install some necessary packages to prepare for the Dokku deploying:

pip install python-decouple dj-database-url gunicorn whitenoise psycopg2-binary

ログイン後にコピー

This installs three useful packages:

python-decouple for managing configuration settings.
dj-database-url for simplifying database configuration in Django.
gunicorn for serving Python web applications in production.
whitenoise to manage access to static files.
psycopg2-binary to allow access to Postgres databases.

Now you can create the environment variable file on a file called .env:

DATABASE_URL=sqlite:///db.sqlite3

ログイン後にコピー

This configures (for local use) a database URL using SQLite. When the application is deployed to Django it will use the URL defined in Dokku, as we have seen before.

For that to be possible, you need to make some changes in the settings.py file:

import dj_database_url
import os
from decouple import config
from django.conf.global_settings import DATABASES

...

ALLOWED_HOSTS = ['*']

...

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    "whitenoise.middleware.WhiteNoiseMiddleware",
    ... all others middleware ...
]

...

DATABASES['default'] = dj_database_url.parse(config('DATABASE_URL'), conn_max_age=600)

...

STATIC_URL = 'static/'
STATIC_ROOT = BASE_DIR / "static"
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, 'staticfiles'),
)
STATICFILES_STORAGE = 'whitenoise.storage.CompressedStaticFilesStorage'

ログイン後にコピー

This code snippet configures various settings for a Django application:

Database Configuration: Uses dj_database_url and decouple to parse the database URL from environment variables.
Allowed Hosts: Allows the application to be served from any host (useful for development), but should not be used in Production.
Middleware: Includes Django's security middleware and WhiteNoise middleware for serving static files.
Static Files: Configures the URL, root directory, additional directories, and storage backend for static files using WhiteNoise.

For Dokku to know how to run the Django application and how to migrate the database, yo will need to create a Procfile:

web: gunicorn DjangoAppDokku.wsgi

release: python manage.py migrate

ログイン後にコピー

The Procfile defines two important processes for your Django application, which Dokku will execute:

web: gunicorn DjangoAppDokku.wsgi: Starts the Gunicorn web server to handle incoming HTTP requests using the WSGI application defined in DjangoAppDokku.wsgi.
release: python manage.py migrate: Runs Django's database migrations as part of the release process, ensuring that the database schema is up-to-date with the latest code changes.

The last set is to make sure that the requirements file is up to date:

pip freeze > requirements.txt

ログイン後にコピー

Step 5 - Deploying the Django application to Dokku

With the Django application and the Dokku application prepared, you can now deploy the application to Dokku.

First you will need create a new repository on GitHub then you can add the Django application to it.

So, on your Django project directory, open a terminal and execute these commands:

echo "# DjangoAppDokku" >> README.md
git init
git add .
git commit -m "First Commit"
git branch -M main
git remote add origin [Your GitHub repository URL]
git push -u origin main

ログイン後にコピー

Now you add a new git remote for the Dokku server:

git remote add dokku dokku@<your_server_ip>:<your_dokku_app_name>

ログイン後にコピー

And finally deploy the application with:

git push dokku

ログイン後にコピー

This will produce an output similar to this:

Enumerating objects: 23, done.
Counting objects: 100% (23/23), done.
Delta compression using up to 8 threads
Compressing objects: 100% (21/21), done.
Writing objects: 100% (23/23), 5.48 KiB | 160.00 KiB/s, done.
Total 23 (delta 8), reused 0 (delta 0), pack-reused 0
-----> Cleaning up...
-----> Building django-app from herokuish
-----> Adding BUILD_ENV to build environment...
       BUILD_ENV added successfully
-----> Python app detected
-----> No Python version was specified. Using the buildpack default: python-3.12.5
       To use a different version, see: https://devcenter.heroku.com/articles/python-runtimes
-----> Requirements file has been changed, clearing cached dependencies
-----> Installing python-3.12.5
-----> Installing pip 24.0, setuptools 70.3.0 and wheel 0.43.0
-----> Installing SQLite3
-----> Installing requirements with pip
       Collecting asgiref==3.8.1 (from -r requirements.txt (line 1))
       Downloading asgiref-3.8.1-py3-none-any.whl.metadata (9.3 kB)
       Collecting dj-database-url==2.2.0 (from -r requirements.txt (line 2))
       Downloading dj_database_url-2.2.0-py3-none-any.whl.metadata (12 kB)
       Collecting Django==5.1 (from -r requirements.txt (line 3))
       Downloading Django-5.1-py3-none-any.whl.metadata (4.2 kB)
       Collecting psycopg2-binary==2.9.9 (from -r requirements.txt (line 4))
       Downloading psycopg2_binary-2.9.9-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.4 kB)
       Collecting python-decouple==3.8 (from -r requirements.txt (line 5))
       Downloading python_decouple-3.8-py3-none-any.whl.metadata (14 kB)
       Collecting sqlparse==0.5.1 (from -r requirements.txt (line 6))
       Downloading sqlparse-0.5.1-py3-none-any.whl.metadata (3.9 kB)
       Collecting typing_extensions==4.12.2 (from -r requirements.txt (line 7))
       Downloading typing_extensions-4.12.2-py3-none-any.whl.metadata (3.0 kB)
       Collecting tzdata==2024.1 (from -r requirements.txt (line 8))
       Downloading tzdata-2024.1-py2.py3-none-any.whl.metadata (1.4 kB)
       Collecting whitenoise==6.7.0 (from -r requirements.txt (line 9))
       Downloading whitenoise-6.7.0-py3-none-any.whl.metadata (3.7 kB)
       Downloading asgiref-3.8.1-py3-none-any.whl (23 kB)
       Downloading dj_database_url-2.2.0-py3-none-any.whl (7.8 kB)
       Downloading Django-5.1-py3-none-any.whl (8.2 MB)
       Downloading psycopg2_binary-2.9.9-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.0 MB)
       Downloading python_decouple-3.8-py3-none-any.whl (9.9 kB)
       Downloading sqlparse-0.5.1-py3-none-any.whl (44 kB)
       Downloading typing_extensions-4.12.2-py3-none-any.whl (37 kB)
       Downloading tzdata-2024.1-py2.py3-none-any.whl (345 kB)
       Downloading whitenoise-6.7.0-py3-none-any.whl (19 kB)
       Installing collected packages: python-decouple, whitenoise, tzdata, typing_extensions, sqlparse, psycopg2-binary, asgiref, Django, dj-database-url
       Successfully installed Django-5.1 asgiref-3.8.1 dj-database-url-2.2.0 psycopg2-binary-2.9.9 python-decouple-3.8 sqlparse-0.5.1 typing_extensions-4.12.2 tzdata-2024.1 whitenoise-6.7.0
-----> $ python manage.py collectstatic --noinput
       System check identified some issues:
       WARNINGS:
       ?: (staticfiles.W004) The directory '/tmp/build/staticfiles' in the STATICFILES_DIRS setting does not exist.
       127 static files copied to '/tmp/build/static'.

-----> Discovering process types
       Procfile declares types -> release, web
-----> Releasing django-app...
-----> Checking for predeploy task
       No predeploy task found, skipping
-----> Checking for release task
       Executing release task from Procfile in ephemeral container: python manage.py migrate
=====> Start of django-app release task (ae9dc2b83) output
remote:  !     System check identified some issues:
remote:  !     WARNINGS:
remote:  !     ?: (staticfiles.W004) The directory '/app/staticfiles' in the STATICFILES_DIRS setting does not exist.
       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
=====> End of django-app release task (ae9dc2b83) output
-----> Checking for first deploy postdeploy task
       No first deploy postdeploy task found, skipping
=====> Processing deployment checks
remote:  !     No healthchecks found in app.json for web process type
       No web healthchecks found in app.json. Simple container checks will be performed.
       For more efficient zero downtime deployments, add healthchecks to your app.json. See https://dokku.com/docs/deployment/zero-downtime-deploys/ for examples
-----> Deploying django-app via the docker-local scheduler...
-----> Deploying web (count=1)
       Attempting pre-flight checks (web.1)
-----> Executing 2 healthchecks
       Running healthcheck name='default' type='uptime' uptime=10
       Running healthcheck name='port listening check' attempts=3 port=8000 retries=2 timeout=5 type='listening' wait=5
       Healthcheck succeeded name='port listening check'
       Healthcheck succeeded name='default'
       All checks successful (web.1)
=====> Start of django-app container output (8d55f0f3b481 web.1)
       Python buildpack: Couldn't determine available memory. Skipping automatic configuration of WEB_CONCURRENCY.
       [2024-08-29 08:32:56 +0000] [14] [INFO] Starting gunicorn 23.0.0
       [2024-08-29 08:32:56 +0000] [14] [INFO] Listening at: http://0.0.0.0:8000 (14)
       [2024-08-29 08:32:56 +0000] [14] [INFO] Using worker: sync
       [2024-08-29 08:32:56 +0000] [153] [INFO] Booting worker with pid: 153
=====> End of django-app container output (8d55f0f3b481 web.1)
=====> Triggering early nginx proxy rebuild
-----> Ensuring network configuration is in sync for django-app
-----> Configuring django-app.<ip_address>.sslip.io...(using built-in template)
-----> Creating http nginx.conf
       Reloading nginx
-----> Running post-deploy
-----> Ensuring network configuration is in sync for django-app
-----> Configuring django-app.<ip_address>.sslip.io...(using built-in template)
-----> Creating http nginx.conf
       Reloading nginx

-----> Checking for postdeploy task
       No postdeploy task found, skipping
=====> Application deployed:
       http://django-app.<ip_address>.sslip.io

To <ip_address>:django-app
 * [new branch]      master -> master

ログイン後にコピー

Dokku has performed the following actions to deploy the application: