チュートリアル: App Service と Azure Database for PostgreSQL - フレキシブル サーバーを使用して Django アプリをデプロイする

  • [アーティクル]

適用対象: Azure Database for PostgreSQL - フレキシブル サーバー

このチュートリアルでは、仮想ネットワークの App Services と Azure Database for PostgreSQL - フレキシブル サーバーを使用して、Azure に Django アプリケーションをデプロイする方法について説明します。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

この記事では、Azure CLI バージョン 2.0 以降をローカルで実行している必要があります。 インストールされているバージョンを確認するには、az --version コマンドを実行します。 インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。

az login コマンドを使用して、アカウントにログインする必要があります。 対応するサブスクリプション名のコマンド出力で id プロパティを確認します。

az login

複数のサブスクリプションをお持ちの場合は、リソースが課金の対象となる適切なサブスクリプションを選択してください。 az account set コマンドを使用して、アカウントの特定のサブスクリプション ID を選択します。 サブスクリプション ID プレースホルダーへのサブスクリプションを、az login 出力のサブスクリプション ID プロパティに置き換えます。

az account set --subscription <subscription id>

サンプル アプリをクローンまたはダウンロードする

サンプル リポジトリをクローンします。

git clone https://github.com/Azure-Samples/djangoapp

次に、そのフォルダーに移動します。

cd djangoapp

djangoapp サンプルには、データ ドリブンの Django 投票アプリが含まれます。これを、Django ドキュメントの「はじめての Django アプリ作成」に従って取得します。 参考までに、完成したアプリをここに記載しています。

このサンプルは、App Service のような運用環境で実行するために変更もされています。

  • 運用環境の設定は、azuresite/production.py ファイルにあります。 開発の詳細は azuresite/settings.py にあります。
  • DJANGO_ENV 環境変数を "production" に設定した場合に、アプリで運用環境の設定が使用されます。 この環境変数は、PostgreSQL データベース構成に使用する他のものと共に、チュートリアルの後半で作成します。

これらの変更は、任意の運用環境で実行するために Django を構成する場合に固有であり、App Service に固有ではありません。 詳細については、Django デプロイ チェックリストに関するページを参照してください。

新しい仮想ネットワークに PostgreSQL フレキシブル サーバーを作成する

次のコマンドを使用して、仮想ネットワーク (VNET) にプライベート フレキシブル サーバーとデータベースを作成します。

# Create Flexible server in a VNET

az postgres flexible-server create --resource-group myresourcegroup --location westus2

このコマンドによって次の操作が実行されます。これには数分かかる場合があります。

  • リソース グループがまだ存在していない場合は作成します。
  • サーバー名が指定されていない場合は、それが生成されます。
  • 新しい postgreSQL サーバー用の新しい仮想ネットワークが作成されます。 Web アプリを同じ仮想ネットワークに追加する必要があるため、サーバー用に作成された仮想ネットワーク名とサブネット名をメモしておいてください。
  • サーバーの管理者のユーザー名とパスワードが指定されていない場合は、それらが作成されます。 次の手順で使用するため、ユーザー名とパスワードをメモしておいてください。
  • 開発のために使用できるデータベース postgres を作成します。 psql を実行してデータベースに接続し、別のデータベースを作成できます。

注意

指定されていない場合に生成されるパスワードをメモしておいてください。 パスワードを忘れた場合は、az postgres flexible-server update コマンドを使用してパスワードをリセットする必要があります。

Azure App Service にコードをデプロイする

このセクションでは App Service アプリでアプリ ホストを作成し、このアプリを Postgres データベースに接続して、そのホストにコードをデプロイします。

仮想ネットワークに App Service Web アプリを作成する

ターミナルで、現在の場所がアプリ コードを含むリポジトリのルート (djangoapp) であることを確認します。

az webapp up コマンドを使用して App Service アプリ (ホスト プロセス) を作成します。

# Create a web app

az webapp up --resource-group myresourcegroup --location westus2 --plan DjangoPostgres-tutorial-plan --sku B1 --name <app-name>

# Enable VNET integration for web app.

# Replace <vnet-name> and <subnet-name> with the virtual network and subnet name that the flexible server is using.

az webapp vnet-integration add -g myresourcegroup -n  mywebapp --vnet <vnet-name> --subnet <subnet-name>

# Configure database information as environment variables

# Use the postgres server name , database name , username , password for the database created in the previous steps

az webapp config appsettings set --settings DJANGO_ENV="production" DBHOST="<postgres-server-name>.postgres.database.azure.com" DBNAME="postgres" DBUSER="<username>" DBPASS="<password>"
  • --location 引数には、前のセクションでデータベースに使用したのと同じ場所を使用します。
  • <app-name> を Azure 全体で一意の名前に置き換えます (サーバー エンドポイントは https://\<app-name>.azurewebsites.net)。 app-name> に使用できる文字は A-Z、0-9、 - です。 会社名とアプリ識別子を組み合わせて使用すると、適切なパターンになります。
  • Basic 価格レベル (B1) で App Service プランDjangoPostgres-tutorial-plan を作成します (存在しない場合)。 --plan と --sku は省略可能ですが、
  • App Service アプリが存在しない場合は作成します。
  • アプリの既定のログがまだ有効になっていない場合は、有効にします。
  • ビルド オートメーションを有効にし、ZIP デプロイを使用してリポジトリをアップロードします。
  • az webapp vnet-integration コマンドによって、Web アプリが postgres サーバーと同じ仮想ネットワークに追加されます。
  • アプリ コードでは、多くの環境変数でデータベース情報を検索することを想定しています。 App Service で環境変数を設定するには、az webapp config appsettings set コマンドを使用して "アプリ設定" を作成します。

ヒント

多くの Azure CLI コマンドでは、リソース グループの名前や App Service プランなどの一般的なパラメーターが、ファイル .azure/config にキャッシュされます。このため、後のコマンドで同じパラメーターをすべて指定する必要はありません。 たとえば、変更を加えた後でアプリを再デプロイするには、パラメーターを指定せずに az webapp up を再実行するだけです。

Django データベースの移行を実行する

Django データベースの移行によって、Azure データベース上の PostgreSQL のスキーマが、コードに記述されているスキーマと一致していることが確認されます。

  1. ブラウザーで https://<app-name>.scm.azurewebsites.net/webssh/host に移動して SSH セッションを開き、Azure アカウントの資格情報 (データベース サーバーの資格情報ではなく) を使用してサインインします。

  2. SSH セッションで次のコマンドを実行します (Ctrl+Shift+V キーを使用してコマンドを貼り付けることができます)。

    cd site/wwwroot

# Activate default virtual environment in App Service container
source /antenv/bin/activate
# Install packages
pip install -r requirements.txt
# Run database migrations
python manage.py migrate
# Create the super user (follow prompts)
python manage.py createsuperuser

  3. createsuperuser コマンドを使用すると、スーパーユーザーの資格情報の入力を求められます。 このチュートリアルの目的では、既定のユーザー名である root を使用し、Enter キーを押してメール アドレスを空白のままにして、パスワードを「postgres1」と入力します。

アプリで投票の質問を作成する

  1. ブラウザーで、URL http://<app-name>.azurewebsites.net を開きます。 データベース内に特定の投票がまだないため、アプリには "No polls are available" (投票は利用できません) というメッセージが表示されます。

  2. http://<app-name>.azurewebsites.net/admin に移動します。前のセクションのスーパーユーザー資格情報 (root と postgres1) を使用してサインインします。 [Polls](投票) で、 [Questions](質問) の横の [Add](追加) を選択し、いくつかの選択肢がある投票の質問を作成します。

  3. もう一度 http://<app-name>.azurewebsites.net/ に移動し、質問がユーザーに表示されるようになったことを確認します。 質問に自由に回答してデータベースにデータを生成します。

おめでとうございます。 アクティブな Postgres データベースを使用して、Azure App Service for Linux で Python Django Web アプリが実行されています。

Note

App Service では、各サブフォルダー内で wsgi.py ファイル ( によって既定で作成されます) を探すことにより、Django プロジェクトが検出されます。 App Service でそのファイルが見つかると、Django Web アプリが読み込まれます。 詳細については、組み込みの Python イメージの構成に関するページを参照してください。

コードの変更を加えて再デプロイする

このセクションでは、アプリに対してローカルでの変更を行い、App Service にコードを再デプロイします。 このプロセスで、進行中の作業をサポートする Python 仮想環境を設定します。

アプリをローカルで実行する

ターミナル ウィンドウで次のコマンドを実行します。 スーパーユーザーを作成するときは、必ずプロンプトに従ってください。

# Configure the Python virtual environment

python3 -m venv venv
source venv/bin/activate

# Install packages

pip install -r requirements.txt
# Run Django migrations

python manage.py migrate
# Create Django superuser (follow prompts)

python manage.py createsuperuser
# Run the dev server

python manage.py runserver

Web アプリが完全に読み込まれると、Django 開発サーバーによって、次のメッセージにローカル アプリの URL が表示されます: "Starting development server at http://127.0.0.1:8000/. Quit the server with CTRL-BREAK" (http://127.0.0.1:8000/ で開発サーバーを起動しています。CTRL-BREAK キーを押してサーバーを終了します)。

Django 開発サーバーの出力例

次の手順に従って、アプリをローカルでテストします。

  1. ブラウザーで http://localhost:8000 にアクセスすると、"No polls are available" (投票は利用できません) というメッセージが表示されます。

  2. http://localhost:8000/admin に移動し、先ほど作成した管理者ユーザーを使用してサインインします。 [Polls](投票) で、 [Questions](質問) の横の [Add](追加) をもう一度選択し、いくつかの選択肢がある投票の質問を作成します。

  3. http://localhost:8000 に再び移動し、アプリをテストするために質問に回答します。

  4. Ctrl+C キーを押して Django サーバーを停止します。

ローカルで実行している場合、アプリではローカルの Sqlite3 データベースを使用しており、運用データベースに干渉することはありません。 必要に応じて、ローカルの PostgreSQL データベースを使用して、運用環境をより正確にシミュレートすることもできます。

アプリの更新

polls/models.py で、choice_text で始まる行を見つけ、max_length パラメーターを 100 に変更します。

# Find this lie of code and set max_length to 100 instead of 200

choice_text = models.CharField(max_length=100)

データ モデルを変更したので、新しい Django の移行を作成し、データベースを移行します。

python manage.py makemigrations
python manage.py migrate

python manage.py runserver を使用して開発サーバーを再度実行し、http://localhost:8000/admin でアプリをテストします。

CtrlC キーを使用して Django Web サーバーを再度停止します。

Azure にコードを再デプロイする

リポジトリのルートで次のコマンドを実行します。

az webapp up

このコマンドでは、 .azure/config ファイルにキャッシュされたパラメーターを使用します。 アプリが既に存在することが App Service によって検出されるので、コードの再デプロイだけが行われます。

Azure で移行を再実行する

データ モデルに変更を加えたので、App Service へのデータベースの移行を再実行する必要があります。

ブラウザーで https://<app-name>.scm.azurewebsites.net/webssh/host にアクセスしてもう一度 SSH セッションを開きます。 次のコマンドを実行します。

cd site/wwwroot

# Activate default virtual environment in App Service container

source /antenv/bin/activate
# Run database migrations

python manage.py migrate

運用環境でアプリを確認する

http://<app-name>.azurewebsites.net に移動し、運用環境でアプリを再度テストします (データベース フィールドの長さを変更しただけなので、質問の作成時に長い回答を入力しようとした場合にのみ、この変更が明らかになります)。

ヒント

django-storages を使用して、静的資産とメディア資産を Azure ストレージに格納できます。 静的ファイルを gzip 処理するために Azure CDN を使用できます。

Azure portal でアプリを管理する

Azure portal でアプリ名を探し、結果内のアプリを選択します。

Azure portal で Python Django アプリに移動する

既定では、アプリの [Overview](概要) ページがポータルに表示されます。これにより、全般的なパフォーマンス ビューが提供されます。 ここでは、参照、停止、再開、削除といった基本的な管理タスクを実行することもできます。 ページの左側にあるタブは、開くことができるさまざまな構成ページを示しています。

Azure portal の [概要] ページで Python Django アプリを管理する

リソースをクリーンアップする

アプリを残しておく場合、または次のチュートリアルに進む場合は、「次のステップ」に進んでください。 それ以外の場合は、継続して料金が発生しないように、このチュートリアルで作成したリソース グループを削除できます。

az group delete -g myresourcegroup

このコマンドでは、 .azure/config ファイルにキャッシュされたリソース グループ名が使用されます。 リソース グループを削除することによって、その中に含まれるすべてのリソースの割り当て解除と削除も行われます。

次のステップ

カスタム DNS 名をアプリにマップする方法を確認する:

チュートリアル:カスタム DNS 名をアプリにマップする

App Service で Python アプリが実行される方法を確認する:

Python アプリの構成