Quarkus REST、Undertow、または Reactive Routes を使用した Azure Functions

このガイドを完成させるには、以下が必要です:

このガイドでは、Quarkus REST エンドポイントを Azure Functions にデプロイできる maven プロジェクトの実行について説明します。 その例として Jakarta REST が示されていますが、これは簡単に任意の HTTPフレームワークに置き換えることができます。

ここ にある Quarkus オンラインアプリケーションジェネレーターから、サンプルコードを生成できます。

この例は、Quarkus CLIで生成することもできます:

gradleプロジェクトを生成したい場合は、 --gradle スイッチを追加します。

Azureにログインしないとデプロイできません。

Quarkus 開発モードは、アプリケーションを HTTP エンドポイントとして実行するだけで使用できます。開発モードでは、 Azure Functions ローカルランタイムとの特別なやり取りはありません。

生成されたプロジェクトの pom.xml または build.gradle ビルドファイルを開くと、 このプロジェクトは他の Quarkus プロジェクトと同様であることがわかります。 quarkus-azure-functions-http エクステンションは、 Quarkus と Azure Functions のインテグレーションポイントです。

quarkus-azure-functions-http エクステンションの現在の実装では、azure-functions-maven-plugin や Gradle の同等の プラグインが不要になりました。ローカル開発や Azure Functions のパッケージングおよびデプロイメントは、 すべて Quarkus によって行われます。

ビルド設定はすべて application.properties 内にあります。唯一必要な設定スイッチ は quarkus.azure-functions.app-name です。

Azure Functions の`host.json`デプロイメント記述子は自動的に 生成されますが、オーバーライドする必要がある場合は、プロジェクトの root ディレクトリーで宣言し、 準備ができたらビルドを再実行します。

Azure Functionのデフォルトのルートプレフィックスは、/api です。Jakarta REST、Servlet、Reactive Routes、Funqy HTTP のすべてのエンドポイントでは、これを明示的に考慮する必要があります。生成されたプロジェクトでは、application.properties 内の quarkus.http.root-path のスイッチによって処理されます。

Azureにログインしないとデプロイできません。

Quarkusの開発モードは、現在Azure Functionsでは動作しません。

ローカルの Azure Functions 環境でこのサンプルを試したい場合は、次のコマンドを 使用できます。

または

Gradle はプロセス管理に少しクセがあるため、--no-daemon スイッチが必要です。そうしないと、 control-c でプロセスが正常に破棄されず、ポートが開いたままになることがあります。

なお、これを実行するためには、 Azure Functions Core Tools が インストールされている必要があります！

例題にアクセスするためのURLは次のようになります:

http://localhost:8081/api/hello

@QuarkusIntegrationTest の機能を使用して統合テストを実装できます。これらの統合テストが実行されると、 統合テストの間、ローカルの Azure Functions 環境がスピンアップされます。

Mavenの場合:

maven で実行する統合テストが *IT.java ファイルパターンを使用しているようにし、通常のビルドでテストが 実行されないようにします。

Gradleの場合:

Gradle で実行する統合テストが src/integrationTest/java 内にあることを確認してください。src/test に存在する統合テスト は通常のビルドで実行され、失敗します。

quarkus-azure-functions-http エクステンションは Azure へのデプロイ作業をすべて処理します。デフォルトでは、 Quarkus はバックグラウンドで Azure CLI を使用して認証し、Azure へのデプロイを行います。 アカウントに複数のサブスクリプションが関連付けられている場合、使用するサブスクリプションを指定するために、 application.properties ファイルに quarkus.azure-functions.subscription-id プロパティーを設定する必要があります。 その他の認証メカニズムやデプロイオプションについては、こちら から設定プロパティーを参照してください。

デプロイを実行するには、プロジェクトをビルドした後、次のコマンドを実行してください:

または

デプロイメントが成功すると、Quarkus はサンプル関数のエンドポイント URL をコンソールに出力します。 Gradle の場合、この出力を表示するには --info スイッチを使用する必要があります。

例えば

サービスにアクセスするための URL は次のようになります。

https://{appName}.azurewebsites.net/api/hello