チュートリアル:Azure App Service on Linux と Azure Cosmos DB を使用して Java Spring Boot Web アプリを構築する
このチュートリアルでは、Azure の MongoDB データベース (実際には、MongoDB API を使用した Cosmos DB データベース) に接続する安全な Spring Boot アプリケーションを Azure App Service で構築、構成、デプロイする方法について説明します。 完了すると、Azure App Service on Linux で実行される Java SE アプリケーションが完成します。
このチュートリアルでは、次の作業を行う方法について説明します。
- MongoDB API を使用して、Azure App Service と Azure Cosmos DB 用に既定でセキュリティで保護されたアーキテクチャを作成する。
- マネージド ID と Key Vault 参照を使用して接続シークレットをセキュリティで保護する。
- GitHub リポジトリから App Service に Spring Boot サンプル アプリをデプロイする。
- アプリケーション コード内で App Service アプリ設定にアクセスする。
- アプリケーション コードを更新して再デプロイする。
- App Service から診断ログをストリーム配信する。
- Azure portal でアプリを管理する。
- Azure Developer CLI を使用して、同じアーキテクチャをプロビジョニングし、デプロイする。
- GitHub Codespaces と GitHub Copilot を使用して開発ワークフローを最適化する。
前提条件
- アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントがない場合は、無料で作成できます。
- GitHub アカウント。 1 つ無料で取得することもできます。
- Spring Framework 開発に関する Java の知識。
- (オプション) GitHub Copilot を試す場合は、GitHub Copilot アカウント。 30 日間の無料試用版が提供されています。
- アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントがない場合は、無料で作成できます。
- Azure Developer CLI がインストールされていること。 Azure Developer CLI が既にインストールされているため、Azure Cloud Shell の手順に従うことができます。
- Spring Framework 開発に関する Java の知識。
- (オプション) GitHub Copilot を試す場合は、GitHub Copilot アカウント。 30 日間の無料試用版が提供されています。
最後までスキップする
このチュートリアルでは、サンプル アプリをすばやくデプロイし、それが Azure で動作していることを確認できます。 単に Azure Cloud Shell で次のコマンドを実行し、プロンプトに従うだけです。
mkdir msdocs-spring-boot-mongodb-sample-app
cd msdocs-spring-boot-mongodb-sample-app
azd init --template msdocs-spring-boot-mongodb-sample-app
azd up
1.サンプルを実行する
最初に、開始点としてサンプルのデータ駆動型アプリを設定します。 便宜のために、サンプル リポジトリには開発コンテナー構成が含まれています。 開発コンテナーには、MongoDB データベース、キャッシュ、サンプル アプリケーションに必要なすべての環境変数など、アプリケーションの開発に必要なものがすべて含まれています。 開発コンテナーは、GitHub codespace で実行できます。つまり、Web ブラウザーを使用して任意のコンピューターでサンプルを実行できます。
手順 1: 新しいブラウザー ウィンドウ内で次を実行します。
- GitHub アカウントにサインインします。
- https://github.com/Azure-Samples/msdocs-spring-boot-mongodb-sample-app/fork に移動します。
- [メイン ブランチのみをコピーする] をオフにします。 すべてのブランチが必要です。
- [Create fork] (フォークの作成) を選択します。
手順 2: GitHub フォークで、次の操作を行います。
- スターター ブランチの [メイン]>[starter-no-infra] を選択します。 このブランチにはサンプル プロジェクトだけが含まれており、Azure 関連のファイルや構成はありません。
- [コード]>[starter-no-infra に codespace を作成する] を選択します。 codespace の設定には数分かかります。
手順 3: codespace ターミナルで次のことを行います。
mvn package spring-boot:run
を実行します。- ''
Your application running on port 8080 is available.
'' という通知が表示されたら、[ブラウザーで開く] を選択します。 新しいブラウザー タブにサンプル アプリケーションが表示されるはずです。Jetty サーバーを停止するには、「Ctrl
+C
」と入力します。
ヒント
このリポジトリについて GitHub Copilot に質問できます。 次に例を示します。
- @workspace このプロジェクトは何を行いますか?
- @workspace このアプリはどのようにデータベースに接続しますか?
- @workspace .devcontainer フォルダーは何を行いますか?
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
2.App Service と Cosmos DB を作成する
まず、Azure リソースを作成します。 このチュートリアルで使用する手順では、App Service と Azure Cosmos DB を含む、既定でセキュリティ保護されたリソースのセットを作成します。 作成プロセスでは、次のように指定します。
- 名前: Web アプリの名前。 これは、アプリの DNS 名の一部として
https://<app-name>-<hash>.<region>.azurewebsites.net
の形式で使用されます。 - 世界でアプリを物理的に実行するためのリージョン。 これは、アプリの DNS 名の一部としても使用されます。
- アプリのランタイム スタック。 ここで、アプリに使う Java のバージョンを選びます。
- アプリのホスティング プラン。 これは、アプリの一連の機能と容量のスケーリングを含む価格レベルです。
- アプリのリソース グループ。 リソース グループを使うと、アプリケーションに必要なすべての Azure リソースを (論理コンテナーに) グループ化できます。
Azure portal にサインインし、以下の手順に従って Azure App Service リソースを作成します。
手順 1: Azure portal 内で次を実行します。
- Azure portal の上部にある検索バーに「Web app database」と入力します。
- [Marketplace] の見出しの下にある [Web アプリとデータベース] というラベルの付いた項目を選びます。 作成ウィザードに直接移動することもできます。
手順 2:[Web アプリとデータベースの作成] ページ内で、このフォームに次のように入力します。
- "リソース グループ": [新規作成] を選択し、msdocs-spring-cosmosdb-tutorial という名前を使用します。
- [リージョン]: 近くの任意の Azure リージョン。
- "名前": msdocs-spring-cosmosdb-XYZ。ここで、XYZ は任意のランダムな 3 文字です。 この名前は Azure 全体で一意である必要があります。
- "ランタイム スタック": Java 21。
- Java Web サーバー スタック: Java SE (埋め込み Web サーバー)。
- "エンジン": MongoDB 用 Cosmos DB API。 Cosmos DB は、Azure 上のサービスとしてのフル マネージドの NoSQL、リレーショナル、ベクトル データベースです。
- [ホスティング プラン]: [Basic]。 準備ができたら、運用価格レベルにスケールアップできます。
- [Review + create](レビュー + 作成) を選択します。
- 検証が完了した後、 [作成] を選択します。
手順 3: このデプロイは完了するまでに数分かかります。 デプロイが完了したら、[リソースに移動] ボタンを選択します。 App Service アプリに直接移動しますが、次のリソースが作成されます。
- [リソース グループ]: 作成されたすべてのリソースのコンテナー。
- [App Service プラン]: App Service のコンピューティング リソースを定義します。 Basic レベルの Linux プランが作成されます。
- [App Service]: アプリを表し、App Service プランで実行されます。
- [仮想ネットワーク]: App Service アプリと統合され、バックエンド ネットワーク トラフィックを分離します。
- Azure Cosmos DB: プライベート エンドポイントの背後からのみアクセスできます。 データベース アカウントにデータベースが作成されます。
- プライベート エンドポイント: 仮想ネットワーク内のデータベース サーバーと Redis キャッシュのアクセス エンドポイント。
- [プライベート DNS ゾーン]: 仮想ネットワーク内のデータベース サーバーと Redis キャッシュの DNS 解決を可能にします。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
3.セキュリティで保護された接続のシークレット
作成ウィザードにより、接続文字列がアプリ設定として既に自動的に生成されています。 ただし、セキュリティのベスト プラクティスは、App Service からシークレットを完全に排除することです。 シークレットをキー コンテナーに移動し、サービス コネクタを利用してアプリ設定を Key Vault 参照に変更します。
手順 1: [App Service] ページ内で、次を実行します。
- 左側のメニューで、[設定] > [環境変数] を選択します。
- AZURE_COSMOS_CONNECTIONSTRING の横にある [値を表示] を選択します。 この接続文字列を使用すると、プライベート エンドポイントの背後でセキュリティ保護された Cosmos DB データベースに接続できます。 ただし、シークレットは App Service アプリに直接保存されますが、これは最適ではありません。 これを変更します。
手順 2: シークレットを安全に管理するためのキー コンテナーを作成します。
- 上部の検索バーに「キー コンテナー」と入力し、[Marketplace]>[Key Vault] を選択します。
- [リソース グループ] で、[msdocs-spring-cosmosdb-tutorial] を選択します。
- [キー コンテナー名] に、文字と数字のみで構成される名前を入力します。
- リージョンで、リソース グループとしてサンプルの場所を設定します。
ステップ 3:
- [ネットワーク] タブを選択します。
- [パブリック アクセスを有効にする] の選択を解除します。
- [プライベート エンドポイントを作成する] を選択します。
- [リソース グループ] で、[msdocs-spring-cosmosdb-tutorial] を選択します。
- [キー コンテナー名] に、文字と数字のみで構成される名前を入力します。
- リージョンで、リソース グループとしてサンプルの場所を設定します。
- ダイアログの [場所] で、App Service アプリと同じ場所を選択します。
- [リソース グループ] で、[msdocs-spring-cosmosdb-tutorial] を選択します。
- [名前] に「msdocs-spring-cosmosdb-XYZVaultEndpoint」と入力します。
- [仮想ネットワーク] で、[msdocs-spring-cosmosdb-XYZVnet] を選択します。
- [サブネット] で、msdocs-spring-cosmosdb-XYZSubnet を選択します。
- [OK] を選択します。
- [Review + create](確認と作成) を選択し、次に [作成] を選択します。 キー コンテナーのデプロイが完了するまで待ちます。 "デプロイが完了しました" と表示されます。
手順 4:
- 上部の検索バーに「msdocs-spring-cosmosdb」と入力し、次に msdocs-spring-cosmosdb-XYZ という App Service リソースを選択します。
- [App Service] ページの左側にあるメニューで、[設定] > [サービス コネクタ] を選択します。 既にコネクタが存在しますが、これはアプリ作成ウィザードによって作成されたものです。
- コネクタの横にあるチェックボックスをオンにし、[編集] を選択します。
- [基本] タブで、[クライアントの種類] を [SpringBoot] に設定します。 このオプションでは、Spring Boot 固有の環境変数が作成されます。
- 認証 タブを選択します。
- [シークレットを Key Vault に保存する] を選択します。
- [Key Vault 接続] で、[新規作成] を選択します。 [接続の作成] ダイアログが編集ダイアログの上に開きます。
手順 5: Key Vault 接続の [接続の作成] ダイアログ、次の操作を行います。
- [Key Vault] で、前に作成したキー コンテナーを選択します。
- [確認および作成] を選択します。 [システム割り当てマネージド ID] が [選択済み] に設定されていることがわかります。
- 検証が完了したら、[作成] を選択します。
手順 6: defaultConnector の編集ダイアログに戻ります。
- [認証] タブで、キー コンテナー コネクタが作成されるまで待ちます。 完了すると、Key Vault 接続ドロップダウンで自動的に選択されます。
- [次へ: ネットワーク] を選択します。
- [ターゲット サービスへのアクセスを有効にするようにファイアウォール規則を構成する] を選択します。 "ターゲット サービスにプライベート エンドポイントがありません" というメッセージが表示された場合は、無視します。 アプリ作成ウィザードでは、プライベート エンドポイントを使用して Cosmos DB データベースが既にセキュリティで保護されています。
- [保存] を選択します。 "更新に成功しました" という通知が表示されるまで待ちます。
手順 7: 変更を確認するには:
- 左側のメニューから、もう一度 [環境変数] を選択します。
- アプリ設定 spring.data.mongodb.uri が存在することを確認します。 既定のコネクタによって生成され、Spring Boot アプリケーションは既にその変数を使用しています。
- アプリ設定の横にある [値を表示] を選択します。 値は
@Microsoft.KeyVault(...)
になります。これは、シークレットがキー コンテナーで管理されるようになったため、これがキー コンテナー参照であることを意味します。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
4.サンプル コードをデプロイする
この手順では、GitHub Actions を使用して GitHub のデプロイを構成します。 これは、App Service にデプロイする多くの方法の 1 つにすぎませんが、デプロイ プロセスで継続的インテグレーションを実現する優れた方法でもあります。 既定では、GitHub リポジトリに git push
があるたびにビルドとデプロイのアクションが起動されます。
手順 1: 左側のメニューで、[デプロイ]>[デプロイ センター] を選択します。
手順 2: [デプロイ センター] ページで次のことを行います。
- [ソース] で、[GitHub] を選びます。 既定では、ビルド プロバイダーとして GitHub Actions が選ばれます。
- GitHub アカウントにサインインし、プロンプトに従って Azure を承認します。
- [組織] で、自分のアカウントを選びます。
- [リポジトリ] で、[msdocs-spring-boot-mongodb-sample-app] を選択します。
- [ブランチ] で、[starter-no-infra] を選択します。 これは、Azure 関連のファイルや構成を含まない、サンプル アプリで作業したのと同じブランチです。
- [認証の種類] で、[ユーザー割り当て ID] を選択します。
- 上部のメニューから、[保存] を選択します。 App Service は、選んだ GitHub リポジトリの
.github/workflows
ディレクトリに、ワークフロー ファイルをコミットします。 既定では、デプロイ センターでは Microsoft Entra (OIDC 認証) を使用して、認証するワークフローのユーザー割り当て ID を作成します。 代替認証オプションについては、「GitHub Actions を使用した App Service へのデプロイ」を参照してください。
ステップ 3:
- [ログ] タブを選択します。新しいデプロイが既に実行されていますが、状態は "失敗" です。
- [ビルドまたはデプロイ ログ] を選択します。
ブラウザー タブが開き、GitHub にフォークされたリポジトリの [Actions] タブが表示されます。 [Annotations] にはエラー
The string 'java21' is not valid SeVer notation for a Java version
が表示されます。 必要に応じて、ページにある失敗した build ステップを選択すると、詳細情報が表示されます。
手順 4: このエラーは、GitHub ワークフロー中に問題が発生したことを示しています。 これを修正するには、まず最新の変更を codespace にプルします。 サンプル フォークの GitHub codespace に戻り、git pull origin starter-no-infra
を実行します。
これにより、新しくコミットされたワークフロー ファイルが codespace にプルされます。
ステップ 5 (オプション 1: GitHub Copilot を使用する):
- [チャット] ビューを選択し、+ を選択して、新しいチャット セッションを開始します。
- "@workspace GitHub Actions で「文字列 'java21' は Java バージョンの有効なセマンティック バージョニング表記ではありません」というエラーが発生するのはなぜですか" と質問します。Copilot は説明を提供し、修正する必要があるワークフロー ファイルへのリンクも提供することができます。
- エクスプローラーで .github/workflows/starter-no-infra_msdocs-spring-cosmosdb-123.yaml を開き、おすすめの修正を加えます。 GitHub Copilot では毎回同じ応答が返されるわけではありません。応答を絞り込むために、さらなる質問が必要になる場合があります。 ヒントについては、「自分の codespace で GitHub Copilot を使用して何ができますか?」を参照してください。
ステップ 5 (オプション 2: GitHub Copilot を使用しない):
- エクスプローラーで .github/workflows/starter-no-infra_msdocs-spring-cosmosdb-123.yaml を開き、
setup-java@v4
アクションを見つけます。 java-version
の値を'21'
に変更します。
手順 6:
- [ソース管理] 拡張機能を選びます。
- テキスト ボックスに、
Fix error in java-version
のようなコミット メッセージを入力します。 または、 を選択し、GitHub Copilot でコミット メッセージを生成します。 - [コミット] を選択し、[はい] で確定します。
- [変更の同期 1] を選択し、[OK] で確認します。
手順 7: Azure portal 内の [デプロイ センター] ページ内に戻り、次のことを行います。
- [ログ] タブで、[更新] を選択します。 新しいデプロイの実行が、コミットされた変更から既に開始されています。
- デプロイの実行のログ項目で、最新のタイムスタンプを持つ [ビルドまたはデプロイ ログ] エントリを選びます。
手順 8: GitHub リポジトリに移動したら、GitHub アクションが実行されていることを確認します。 ワークフロー ファイルでは、ビルドとデプロイという 2 つの異なるステージを定義します。 GitHub が実行されて、[完了] の状態が表示されるまで待ちます。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
5.アプリの参照
手順 1: [App Service] ページ内で、次を実行します。
- 左側のメニューから [概要] を選びます。
- アプリの URL を選びます。
手順 2: この一覧にいくつかのタスクを追加します。 おめでとうございます。Azure Cosmos DB へのセキュリティで保護された接続を使用して、Web アプリが Azure App Service で実行されています。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
6.診断ログをストリーミングする
Azure App Service では、アプリケーションに関する問題の診断に役立つように、コンソールに出力されたすべてのメッセージが収集されます。 次のスニペットに示すように、このサンプル アプリケーションには、この機能を示す標準の Log4j ログ記録ステートメントが含まれています。
private static Logger logger = LoggerFactory.getLogger(TodoListController.class);
@Autowired
private TodoItemRepository todoItemRepository;
public TodoListController() {
}
/**
* HTTP GET
*/
@GetMapping(path = "/api/todolist/{index}", produces = {MediaType.APPLICATION_JSON_VALUE})
public TodoItem getTodoItem(@PathVariable("index") String index) {
logger.info("GET request access '/api/todolist/{}' path.", index);
return todoItemRepository.findById(index).get();
}
手順 1: [App Service] ページ内で、次を実行します。
- 左側のメニューから、[App Service ログ] を選びます。
- [アプリケーション ログ記録] で [ファイル システム] を選びます。
- 上部のメニューから、[保存] を選択します。
手順 2:左側のメニューから [ログ ストリーム] を選択します。 プラットフォーム ログとコンテナー内のログを含む、アプリのログが表示されます。
Java アプリのログ記録の詳細については、シリーズの「.NET、Node.js、Python、Java アプリケーション用の Azure Monitor OpenTelemetry を有効にする」を参照してください。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
7.リソースをクリーンアップする
完了したら、リソース グループを削除することで、Azure サブスクリプションからすべてのリソースを削除できます。
手順 1: Azure portal の上部にある検索バーで次を行います。
- リソース グループ名を入力します。
- リソース グループを選択します。
手順 2: [リソース グループ] ページ内で、[リソース グループの削除] を選びます。
ステップ 3:
- リソース グループ名を入力して削除を確認します。
- [削除] を選択します。
- もう一度 [削除] を選択して確定します。
2.Azure リソースを作成してサンプル アプリをデプロイする
このステップでは、Azure リソースを作成し、サンプル アプリを App Service on Linux にデプロイします。 このチュートリアルで使用する手順では、App Service と Azure Cosmos DB を含む、既定でセキュリティ保護されたリソースのセットを作成します。
開発コンテナーには、既に Azure Developer CLI (AZD) が含まれています。
リポジトリのルートから、
azd init
を実行します。azd init --template javase-app-service-cosmos-redis-infra
メッセージが表示されたら、次の回答を入力します。
Question Answer The current directory is not empty. (現在のディレクトリが空ではありません。) Would you like to initialize a project here in '<your-directory>'? ('<ディレクトリ>' でプロジェクトを初期化しますか?) Y What would you like to do with these files? (これらのファイルをどうしますか?) Keep my existing files unchanged (既存のファイルを変更しないでそのままにする) Enter a new environment name (新しい環境の名前を入力してください) 一意の名前を入力します。 AZD テンプレートでは、この名前を Azure での Web アプリの DNS 名の一部として使用します ( <app-name>-<hash>.azurewebsites.net
)。 英数字とハイフンを使用できます。azd auth login
コマンドを実行し、プロンプトに従って Azure にサインインします。azd auth login
必要な Azure リソースを作成し、
azd up
コマンドを使用してアプリ コードをデプロイします。 プロンプトに従って、Azure リソースの目的のサブスクリプションと場所を選択します。azd up
azd up
コマンドが完了するまで約 15 分かかります (大部分の時間は Redis キャッシュに費やされます)。 また、アプリケーション コードのコンパイルとデプロイも行われますが、後でコードを変更して App Service で動作するようにします。 実行中、このコマンドは、Azure のデプロイへのリンクを含む、プロビジョニングとデプロイのプロセスに関するメッセージを提供します。 完了すると、コマンドはデプロイ アプリケーションへのリンクも表示します。この AZD テンプレートには、次の Azure リソースを使用して既定でセキュリティ保護されたアーキテクチャを生成するファイル (azure.yaml と infra ディレクトリ) が含まれています。
- [リソース グループ]: 作成されたすべてのリソースのコンテナー。
- [App Service プラン]: App Service のコンピューティング リソースを定義します。 B1 レベルの Linux プランが作成されます。
- [App Service]: アプリを表し、App Service プランで実行されます。
- [仮想ネットワーク]: App Service アプリと統合され、バックエンド ネットワーク トラフィックを分離します。
- MongoDB API を使用した Azure Cosmos DB アカウント: プライベート エンドポイントの背後からのみアクセスできます。 サーバー上にデータベースが自動的に作成されます。
- [Azure Cache for Redis]: 仮想ネットワーク内からのみアクセスできます。
- キー コンテナー: プライベート エンドポイントの背後からのみアクセスできます。 App Service アプリのシークレットを管理するために使用されます。
- プライベート エンドポイント: 仮想ネットワーク内のキー コンテナー、データベース サーバー、Redis キャッシュのアクセス エンドポイント。
- プライベート DNS ゾーン: 仮想ネットワーク内の Cosmos DB データベース、Redis Cache、キー コンテナーの DNS 解決を有効にします。
- [Log Analytics ワークスペース]: アプリでログを配布するためのターゲット コンテナーとして機能します。ここでは、ログにクエリを実行することもできます。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
3.接続文字列を確認する
使用している AZD テンプレートにより、接続変数がアプリ設定として既に自動的に生成されており、それらが便宜のためにターミナルに出力されます。 アプリの設定は、接続のシークレットをコード リポジトリに残さないための 1 つの方法です。
AZD の出力で、アプリ設定
spring.data.mongodb.uri
を見つけます。 設定名のみが表示されます。 これらは、AZD の出力では次のようになります。App Service app has the following app settings: - spring.data.mongodb.uri - spring.data.mongodb.database - spring.redis.host - spring.redis.port - spring.redis.password - spring.redis.database - spring.redis.ssl - spring.cloud.azure.keyvault.secret.credential.managed_identity_enabled - spring.cloud.azure.keyvault.secret.endpoint - azure.keyvault.uri - azure.keyvault.scope
spring.data.mongodb.uri
には、Azure の Cosmos DB データベースへの接続 URI が含まれています。 これは標準の Spring Data 変数であり、アプリケーションが既に src/main/resources/application.properties ファイルで使用しています。エクスプローラーで、src/main/resources/application.properties に移動し、Spring Boot アプリが既に
spring.data.mongodb.uri
変数を使用してデータにアクセスしていることを確認します。利便性のために、AZD テンプレート出力には、アプリのアプリ設定ページへの直接リンクが表示されます。 そのリンクを見つけ、それを新しいブラウザー タブで開きます。
spring.data.mongodb.uri
の値を見ると、@Microsoft.KeyVault(...)
になるはずです。これは、シークレットがキー コンテナーで管理されているため、これがキー コンテナー参照であることを意味します。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
4. アプリの参照
AZD の出力で、アプリの URL を見つけ、ブラウザーでそこに移動します。 URL は、AZD の出力では次のようになります。
Deploying services (azd deploy) (✓) Done: Deploying service web - Endpoint: https://<app-name>-<hash>.azurewebsites.net/
一覧にいくつかのタスクを追加します。
おめでとうございます。Azure Cosmos DB へのセキュリティで保護された接続を使用して、Web アプリが Azure App Service で実行されています。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
5. 診断ログのストリーミング
Azure App Service はコンソール ログをキャプチャできるので、アプリケーションに関する問題の診断に役立ちます。 便宜のために、AZD テンプレートでは、既にローカル ファイル システムへのログ記録が有効になっており、それらのログが Log Analytics ワークスペースに配布されています。
次のスニペットに示すように、このサンプル アプリケーションには、この機能を示す標準の Log4j ログ記録ステートメントが含まれています。
private static Logger logger = LoggerFactory.getLogger(TodoListController.class);
@Autowired
private TodoItemRepository todoItemRepository;
public TodoListController() {
}
/**
* HTTP GET
*/
@GetMapping(path = "/api/todolist/{index}", produces = {MediaType.APPLICATION_JSON_VALUE})
public TodoItem getTodoItem(@PathVariable("index") String index) {
logger.info("GET request access '/api/todolist/{}' path.", index);
return todoItemRepository.findById(index).get();
}
AZD の出力で、App Service ログをストリーミングするためのリンクを見つけ、ブラウザーでそこに移動します。 このリンクは、AZD の出力では次のようになります。
Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream
Java アプリのログ記録の詳細については、シリーズの「.NET、Node.js、Python、Java アプリケーション用の Azure Monitor OpenTelemetry を有効にする」を参照してください。
問題がある場合は、 「トラブルシューティング」セクションを確認してください。
6.リソースをクリーンアップする
現在のデプロイ環境内のすべての Azure リソースを削除するには、azd down
を実行し、プロンプトに従います。
azd down
トラブルシューティング
Azure Cosmos DB のポータル デプロイ ビューに競合状態が表示される
サブスクリプションや選択したリージョンによっては、Azure Cosmos DB のデプロイ状態が Conflict
となり、[操作の詳細] に次のメッセージが表示されることがあります。
Sorry, we are currently experiencing high demand in <region> region, and cannot fulfill your request at this time.
エラーは、選択したリージョンに対するサブスクリプションの制限が原因である可能性が最も高いです。 デプロイのために別のリージョンを選択してみてください。
デプロイされたサンプル アプリにタスク リスト アプリが表示されない
タスク リスト アプリの代わりに Hey, Java developers!
ページが表示される場合は、App Service でまだ、最新のコード デプロイから更新されたコンテナーを読み込んでいる最中である可能性があります。 数分待ってからページを更新してください。
よく寄せられる質問
- この設定にはいくらかかりますか。
- 仮想ネットワークの背後にある Cosmos DB データベースを使用してデータベース移行を実行するにはどうすればよいですか?
- GitHub Actions でのローカル アプリの開発はどのように行いますか。
- ユーザー割り当て ID を作成するためのアクセス許可がありません
この設定にはいくらかかりますか。
作成したリソースの価格は次のとおりです。
- App Service プランは Basic レベルで作成され、スケールアップまたはスケールダウンできます。 「App Service の価格」をご覧ください。
- Azure Cosmos DB アカウントはサーバーレス レベルで作成され、このレベルに関連するわずかなコストが発生します。 「Azure Cosmos DB の価格」をご覧ください。
- Azure Cache for Redis は、最小キャッシュ サイズの Basic レベルで作成されます。 このレベルには少ないコストがかかります。 高い可用性、クラスタリング、およびその他の機能のために、より高いパフォーマンス レベルにスケールアップできます。 「Azure Cache for Redis の価格」を参照してください。
- 仮想ネットワークでは、ピアリングなどの追加機能を構成しない限り、料金は発生しません。 「Azure Virtual Network の価格」を参照してください。
- プライベート DNS ゾーンでは、少額の料金が発生します。 「Azure DNS の価格」を参照してください。
仮想ネットワークの背後にある Cosmos DB データベースを使用してデータベース移行を実行するにはどうすればよいですか?
App Service の Java SE コンテナーには、既に Cosmos DB へのネットワーク接続がありますが、移行ツールや他の MongoDB ツールは含まれていません。 いくつかの選択肢を次に示します。
- Hibernate や Flyway などを使用して、アプリの起動時にデータベース移行を自動的に実行します。
- アプリの SSH セッションで、Flyway CLI などの移行ツールをインストールし、移行スクリプトを実行します。 インストールされたツールは、/home ディレクトリにない限り、アプリの再起動後は保持されないことに注意してください。
- 仮想ネットワークと Azure Cloud Shell を統合し、そこからデータベース移行を実行します。
GitHub Actions でのローカル アプリの開発はどのように行いますか。
App Service から自動生成されたワークフロー ファイルを例として使用すると、git push
ごとに新しいビルドとデプロイの実行が起動されます。 GitHub リポジトリのローカル クローンから、必要な更新を行い、GitHub にプッシュします。 次に例を示します。
git add .
git commit -m "<some-message>"
git push origin main
ユーザー割り当て ID を作成するためのアクセス許可がありません
「デプロイ センターから GitHub Actions デプロイを設定する」を参照してください。
自分のコードスペースで GitHub Copilot を使用して何ができますか?
codespace を作成したときに、既に GitHub Copilot チャット ビューが表示されていることに気付いたかもしれません。 便宜のために、GitHub Copilot チャット拡張機能をコンテナー定義 (.devcontainer/devcontainer.json を参照) に含めています。 ただし、GitHub Copilot アカウント (30 日間の無料試用版を利用できます) が必要です。
GitHub Copilot に話しかけるときのヒントを、いくつか次に示します。
- 1 つのチャット セッションでは、質問と回答は相互に基づいて構築されていくので、質問を調整すると、得られる回答を絞り込むことができます。
- 既定では、GitHub Copilot からリポジトリ内のファイルにはアクセスできません。 ファイルに関する質問を問い合わせるには、まず、エディターでファイルを開きます。
- GitHub Copilot がその回答を準備するときにリポジトリ内のすべてのファイルにアクセスできるようにするには、
@workspace
で質問を開始します。 詳細については、Use the @workspace agentを参照してください。 - チャット セッションでは、GitHub Copilot は変更を提案でき、場合によっては (
@workspace
を使用して) 変更を行う箇所も提案できますが、変更を行うことはできません。 提案された変更を追加してテストするかどうかは、ご自身が決める必要があります。
次のステップ
- Java 開発者向けの Azure
- Spring Boot
- Spring Data for Azure Cosmos DB
- Azure Cosmos DB および -App Service Linux
App Service での Java アプリの実行の詳細については、開発者ガイドを参照してください。
カスタム ドメインと証明書を使用してアプリをセキュリティで保護する方法について説明します。