クイック スタート: azd テンプレートを使用して Python Web アプリを作成して Azure にデプロイする

  • [アーティクル]

このクイック スタートでは、Python Web およびデータベース ソリューションを作成して Azure にデプロイする最も簡単で最速の方法について説明します。 このクイック スタートの手順に従うことで、次の操作を行います。

  • 構築する azd Python Web フレームワーク、Azure データベース プラットフォーム、Azure Web ホスティング プラットフォームに基づいてテンプレートを選択します。
  • CLI コマンドを使用してテンプレートを azd 実行し、サンプル Web アプリとデータベースを作成し、必要な Azure リソースを作成して構成した後、サンプル Web アプリを Azure にデプロイします。
  • ローカル コンピューターで Web アプリを編集し、コマンドを azd 使用して再デプロイします。
  • コマンドをazd使用して Azure リソースをクリーンします。

このチュートリアルを完了するには、15 分未満かかります。 完了したら、カスタム コードを使用して新しいプロジェクトの変更を開始できます。

Python Web アプリ開発用のこれらの azd テンプレートの詳細については、以下を参照してください。

前提条件

Azure サブスクリプション - 無料アカウントを作成します

ローカル コンピューターに次のものがインストールされている必要があります。

テンプレートを選択する

構築する azd Python Web フレームワーク、Azure Web ホスティング プラットフォーム、Azure データベース プラットフォームに基づいてテンプレートを選択します。

  1. 次の表のテンプレートの一覧から、テンプレート名 (最初の列) を選択します。 テンプレート名は、次のセクションの azd init 手順で使用します。

    Template Web Framework データベース ホスティング プラットフォーム GitHub リポジトリ
    azure-django-postgres-flexible-aca Django PostgreSQL フレキシブル サーバー Azure Container Apps リポジトリ
    azure-django-postgres-flexible-appservice Django PostgreSQL フレキシブル サーバー Azure App Service リポジトリ
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL アダプター) Azure Container Apps リポジトリ
    azure-django-cosmos-postgres-appservice Django Cosmos DB (PostgreSQL アダプター) Azure App Service リポジトリ
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL アドオン Azure Container Apps リポジトリ

GitHub リポジトリ (最後の列) は、参照目的でのみ提供されます。 テンプレートに変更を加える場合にのみ、リポジトリを直接複製する必要があります。 それ以外の場合は、このクイックスタートの手順に従って CLI を azd 使用して、通常のワークフローでテンプレートを操作します。

テンプレートの実行

テンプレートの azd 実行は、言語とフレームワーク全体で同じです。 また、すべてのテンプレートに同じ基本的な手順が適用されます。 手順は次のとおりです。

  1. ターミナルで、通常はローカル Git リポジトリを格納するローカル コンピューター上のフォルダーに移動し、azdtest という名前の新しいフォルダーを作成します。 次に、コマンドを使用してそのディレクトリに cd 移動します。

    mkdir azdtest
cd azdtest

    このクイック スタートでは、Visual Studio Code のターミナルを使用しないでください。

  2. ローカル開発環境を設定するには、ターミナルで次のコマンドを入力し、プロンプトに応答します。

    azd init --template <template name>

    たとえば、azure-django-postgres-aca など、前の手順で選択したテーブルのテンプレートのいずれかに置き換えます<template name>。

    環境名の入力を求められたら、azdtest またはその他の名前を使用します。 環境名は、Azure リソース グループとリソースに名前を付けるときに使用されます。 最適な結果を得るには、短い名前、小文字の後者、特殊文字を使用しません。

  3. Azure アカウントに対して認証 azd するには、ターミナルで次のコマンドを入力し、プロンプトに従います。

    azd auth login

    「アカウントを選択する」または Azure アカウントにログインするように求められたら、指示に従います。 認証が正常に完了すると、Web ページに次のメッセージが表示されます。 アプリケーションに戻ることができます。 このブラウザー タブを閉じてください。"

    タブを閉じると、シェルに次のメッセージが表示されます。

    Logged in to Azure.

  4. 次の手順を実行する前に、Docker Desktop がバックグラウンドで開いて実行されていることを確認します。

  5. 必要な Azure リソースを作成するには、ターミナルで次のコマンドを入力し、プロンプトに応答します。

    azd up

    重要

    正常に完了すると azd up 、サンプル Web アプリがパブリック インターネットで利用できるようになり、作成されたすべてのリソースに対して Azure サブスクリプションの料金が発生し始めます。 テンプレートの作成者は意図的に安価なレベルを azd 選択しましたが、Free レベルでは可用性が制限されることが多いため、必ずしも Free レベルを選択したわけではありません。

    指示に従って、支払いに使用する Azure サブスクリプションを選択し、使用する Azure の場所を選択します。 地理的に近いリージョンを選択します。

    複数の Azure サービスを azd up プロビジョニングしてデプロイするため、実行には数分かかる場合があります。 進行状況が表示されたら、エラーを監視します。 エラーが表示された場合は、次を試して問題を解決してください。

    • 最初から azd-quickstart フォルダーとクイック スタート手順を削除します。
    • メッセージが表示されたら、環境に合わせて簡単な名前を選択します。 小文字とダッシュのみを使用します。 数字、大文字、または特殊文字はありません。
    • 別の場所を選択します。

    それでも問題が解決する場合は、このドキュメントの 下部にある「トラブルシューティング 」セクションを参照してください。

    重要

    サンプル Web アプリの操作が完了したら、作成されたすべてのサービスazd upを削除するために使用azd downします。

  6. 正常に完了すると azd up 、次の出力が表示されます。

    Screenshot of successful output from the azd command line interface with a callout around the endpoint URL to view the working Relecloud application deployed in Azure.

    単語 - Endpoint: の後の最初の URL をコピーし、Web ブラウザーの場所バーに貼り付けて、Azure で実行中のサンプル Web アプリ プロジェクトを確認します。

  7. Web ブラウザーで新しいタブを開き、前の手順の 2 番目の URL をコピーして、場所バーに貼り付けます。 Azure portal には、サンプル Web アプリ プロジェクトをホストするためにデプロイされた新しいリソース グループ内のすべてのサービスが表示されます。

編集と再デプロイ

次の手順では、Web アプリに小さな変更を加えてから、再デプロイします。

  1. Visual Studio Code を開き、先ほど作成した azdtest フォルダーを開きます。

  2. このテンプレートは、必要に応じて Dev Containers を使用するように構成されます。 Visual Studio Code に Dev Container の通知が表示されたら、[コンテナーで再度開く] ボタンを選択します。

  3. Visual Studio Code の エクスプローラー ビューを使用して src/templates フォルダーに移動し、index.html ファイルを開きます。 次のコード行を検索します。

    <h1 id="pagte-title">Welcome to ReleCloud</h1>

    H1 内のテキストを変更します。

    <h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>

    変更を保存します。

  4. 変更を加えてアプリを再デプロイするには、ターミナルで次のコマンドを実行します。

    azd deploy

    Dev Containers を使用していて、コンテナーのシェルにリモートで接続されているため、Visual Studio Code のターミナル ウィンドウを使用してコマンドを実行 azd しないでください。

  5. コマンドが完了したら、Web ブラウザーを更新して更新プログラムを表示します。 使用されている Web ホスティング プラットフォームによっては、変更が表示されるまでに数分かかる場合があります。

    これで、テンプレート内のファイルを編集および削除する準備ができました。 詳細については、「テンプレートで何を編集または削除できるか」を参照してください 。

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

  1. コマンドを実行して、テンプレートによって作成されたリソースを azd down クリーンアップします。

    azd down

    このコマンドを azd down 実行すると、Azure リソースと GitHub Actions ワークフローが削除されます。 メッセージが表示されたら、リソース グループに関連付けられているすべてのリソースを削除することに同意します。

    azdtest フォルダーを削除したり、プロジェクトのファイルを変更して独自のアプリケーションの基礎として使用したりすることもできます。

トラブルシューティング

エラーが発生した azd up場合は、次の手順を試してください。

  • 実行 azd down して、作成された可能性があるリソースを削除します。 または、Azure portal で作成されたリソース グループを削除することもできます。
  • ローカル コンピューター上の azdtest フォルダーを削除します。
  • Azure portal で Key Vault を検索します。 [削除されたコンテナーの管理] を選択し、サブスクリプションを選択し、azdtest という名前または環境に名前を付けたものを含むすべてのキー コンテナーを選択して、[消去] を選択します。
  • このクイック スタートの手順をもう一度やり直してください。 今回は、プロンプトが表示されたら、環境の単純な名前を選択します。 短い名前、小文字、数字、大文字、特殊文字を使用しないようにしてください。
  • クイック スタートの手順を再試行するときは、別の場所を選択します。

考えられる問題と解決策のより包括的な一覧については、FAQ を参照してください。

関連コンテンツ