CentOS 7でDjangoアプリケーションでPostgreSQLを使用する方法

前書き

Djangoは、Pythonアプリケーションをすばやく作成するための柔軟なフレームワークです。 デフォルトでは、Djangoアプリケーションはデータを軽量のSQLiteデータベースファイルに保存するように設定されています。 これはいくつかの負荷の下でうまく機能しますが、より伝統的なDBMSは本番環境のパフォーマンスを改善できます。

このガイドでは、Djangoアプリケーションで使用するためにPostgreSQLをインストールおよび構成する方法を示します。 必要なソフトウェアをインストールし、アプリケーションのデータベース資格情報を作成してから、このバックエンドを使用するために新しいDjangoプロジェクトを開始および構成します。

前提条件

開始するには、root以外のユーザーが設定されたクリーンなCentOS 7サーバーインスタンスが必要です。 非rootユーザーは、 `+ sudo +`特権で設定する必要があります。 https://www.digitalocean.com/community/tutorials/initial-server-setup-with-centos-7 [初期サーバーセットアップガイド]に従って、これを設定する方法を学びます。

続行する準備ができたら、読み進めてください。

CentOSおよびEPELリポジトリからコンポーネントをインストールする

最初のステップは、リポジトリから必要なすべてのピースをインストールすることです。 Pythonコンポーネントをインストールおよび管理するために、Pythonパッケージマネージャーである `+ pip +`をインストールします。 データベースソフトウェアと、それらと対話するために必要な関連ライブラリもインストールします。

必要なソフトウェアのいくつかは、追加のパッケージを含むEPELリポジトリにあります。 以下を結ぶことで、このリポジトリを簡単に有効にできます。

sudo yum install epel-release

EPELを有効にすると、次のように入力して必要なコンポーネントをインストールできます。

sudo yum install python-pip python-devel gcc postgresql-server postgresql-devel postgresql-contrib

PostgreSQLの初期構成を実行する

インストール後、次のように入力してPostgreSQLデータベースを初期化する必要があります。

sudo postgresql-setup initdb

データベースが初期化されたら、次のように入力してPostgreSQLサービスを開始できます。

sudo systemctl start postgresql

データベースを起動したら、実際には、設定済みの構成ファイルの1つの値を調整する必要があります。 エディターと `+ sudo +`コマンドを使用して、今すぐファイルを開きます。

sudo nano /var/lib/pgsql/data/pg_hba.conf

このファイルは、データベースシステムの認証方法の構成を担当します。 現在、システムユーザーがデータベースユーザーと一致する場合にのみ接続を許可するように構成されています。 これはローカルメンテナンスタスクには問題ありませんが、Djangoインスタンスには別のユーザーがパスワードを設定されます。

ファイルの下部にある2つの `+ host `行を変更することでこれを設定できます。 最後の列(認証方法)を「 md5 +」に変更します。 これにより、パスワード認証が許可されます。

. . .

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
host    all             all             127.0.0.1/32
IPv6 local connections:
#host    all             all             ::1/128                 ident
host    all             all             ::1/128

終了したら、ファイルを保存して閉じます。

新しい構成の変更に伴い、サービスを再起動する必要があります。 また、ブート時に自動的に起動するようにPostgreSQLを有効にします。

sudo systemctl restart postgresql
sudo systemctl enable postgresql

データベースとデータベースユーザーを作成する

デフォルトでは、Postgresはローカル接続に「ピア認証」と呼ばれる認証スキームを使用します。 これは、 + pg_hba.conf`ファイルの + local`エントリで編集することができます。 基本的に、これはユーザーのオペレーティングシステムのユーザー名が有効なPostgresユーザー名と一致する場合、そのユーザーはそれ以上認証なしでログインできることを意味します。

Postgresのインストール中に、 + postgres + PostgreSQL管理ユーザーに対応するために、 `+ postgres +`という名前のオペレーティングシステムユーザーが作成されました。 管理タスクを実行するには、このユーザーに変更する必要があります。

sudo su - postgres

これで、 `+ postgres +`ユーザーのシェルセッションになります。 次のように入力して、Postgresセッションにログインします。

psql

最初に、Djangoプロジェクトのデータベースを作成します。 セキュリティ上の理由から、各プロジェクトには独自の独立したデータベースが必要です。 このガイドではデータベースを「++」と呼びますが、よりわかりやすいものを選択することをお勧めします。

CREATE DATABASE ;

すべてのコマンドをセミコロンでSQLプロンプトで終了することを忘れないでください。

次に、データベースに接続して対話するために使用するデータベースユーザーを作成します。 パスワードを強力で安全なものに設定します。

CREATE USER  WITH PASSWORD '';

その後、作成したユーザーの接続パラメーターのいくつかを変更します。 これにより、データベース操作が高速化されるため、接続が確立されるたびに正しい値を照会および設定する必要がなくなります。

デフォルトのエンコーディングをUTF-8に設定していますが、これはDjangoが期待しています。 また、デフォルトのトランザクション分離スキームを「コミット済み読み取り」に設定しています。これは、コミットされていないトランザクションからの読み取りをブロックします。 最後に、タイムゾーンを設定しています。 デフォルトでは、Djangoプロジェクトは `+ UTC`を使用するように設定されます。

ALTER ROLE  SET client_encoding TO 'utf8';
ALTER ROLE  SET default_transaction_isolation TO 'read committed';
ALTER ROLE  SET timezone TO 'UTC';

これで、データベースユーザーに、作成したデータベースへのアクセス権を与えるだけで済みます。

GRANT ALL PRIVILEGES ON DATABASE  TO ;

SQLプロンプトを終了して、postgresユーザーのシェルセッションに戻ります。

\q

`+ postgres`ユーザーシェルセッションを終了して、通常のユーザーのシェルセッションに戻ります。

exit

仮想環境内にDjangoをインストールする

データベースがセットアップされたので、Djangoをインストールできます。 柔軟性を高めるために、Djangoとそのすべての依存関係をPython仮想環境内にインストールします。

次のように入力して、これらの環境を作成できる `+ virtualenv +`パッケージを取得できます。

sudo pip install virtualenv

Djangoプロジェクトを保持するディレクトリを作成します。 その後、ディレクトリに移動します。

mkdir ~/
cd ~/

次のように入力して、DjangoプロジェクトのPython要件を保存する仮想環境を作成できます。

virtualenv

これにより、Pythonと `+ pip `のローカルコピーがプロジェクトディレクトリ内の `+`というディレクトリにインストールされます。

仮想環境内にアプリケーションをインストールする前に、アクティブ化する必要があります。 これを行うには、次のように入力します。

source /bin/activate

プロンプトが変わり、仮想環境内で操作していることが示されます。 この `+()@:〜/ $ +`のようになります。

仮想環境がアクティブになったら、Djangoを `+ pip `でインストールできます。 また、設定したデータベースを使用できるようにする ` psycopg2 +`パッケージもインストールします。

pip install django psycopg2

これで、 `+ myproject +`ディレクトリ内でDjangoプロジェクトを開始できます。 これにより、コード自体を保持するために同じ名前の子ディレクトリが作成され、現在のディレクトリ内に管理スクリプトが作成されます。 これが正しく設定されるように、コマンドの最後にドットを追加してください:

django-admin.py startproject  .

Djangoデータベース設定を構成する

プロジェクトができたので、作成したデータベースを使用するようにプロジェクトを構成する必要があります。

子プロジェクトディレクトリ内にあるメインのDjangoプロジェクト設定ファイルを開きます。

nano ~///settings.py

ファイルの下部に向かって、次のような `+ DATABASES +`セクションが表示されます。

. . .

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

. . .

これは現在、SQLiteをデータベースとして使用するように構成されています。 PostgreSQLデータベースが代わりに使用されるように、これを変更する必要があります。

まず、 + sqlite3 +`バックエンドの代わりに `+ postgresql_psycopg2 +`バックエンドを指すようにエンジンを変更します。 `+ NAME +`には、データベースの名前を使用します(この例では `++)。 ログイン資格情報も追加する必要があります。 接続するためのユーザー名、パスワード、ホストが必要です。 デフォルトが選択されるように、ポートオプションを追加して空白のままにします。

. . .

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

. . .

終了したら、ファイルを保存して閉じます。

データベースを移行してプロジェクトをテストする

Djangoの設定が構成されたので、データ構造をデータベースに移行し、サーバーをテストできます。

まず、データベースに移行を作成して適用することから始めます。 実際のデータはまだないため、これは単に初期データベース構造をセットアップするだけです。

cd ~/
python manage.py makemigrations
python manage.py migrate

データベース構造を作成したら、次のように入力して管理アカウントを作成できます。

python manage.py createsuperuser

ユーザー名の選択、メールアドレスの入力、アカウントのパスワードの選択と確認を求められます。

管理者アカウントを設定したら、Django開発サーバーを起動して、データベースが正しく実行されていることをテストできます。

python manage.py runserver 0.0.0.0:8000

ウェブブラウザで、サーバーのドメイン名またはIPアドレスにアクセスし、その後に「:8000」を入力して、デフォルトのDjangoルートページにアクセスします。

http://:8000

デフォルトのインデックスページが表示されます。

画像:https://assets.digitalocean.com/articles/django_mysql_1404/django_index.png [Django index]

URLの最後に「+ / admin +」を追加すると、管理画面のログイン画面にアクセスできるはずです。

画像:https://assets.digitalocean.com/articles/django_mysql_1404/admin_login.png [Django admin login]

`+ createsuperuser +`コマンドを使用して作成したユーザー名とパスワードを入力します。 次に、管理インターフェイスに移動します。

image:https://assets.digitalocean.com/articles/django_mysql_1404/admin_interface.png [Django admin interface]

調査が終了したら、ターミナルウィンドウでCTRL-Cを押して開発サーバーを停止できます。

管理インターフェイスにアクセスすることで、データベースにユーザーアカウント情報が保存され、適切にアクセスできることを確認しました。

結論

このガイドでは、PostgreSQLをDjangoプロジェクトのバックエンドデータベースとしてインストールおよび設定する方法を示しました。 SQLiteは開発中および本番環境での使用中の負荷を簡単に処理できますが、ほとんどのプロジェクトは、よりフル機能のDBMSを実装することで恩恵を受けます。

Related