IntelliJ を使用して Azure で初めての Kotlin 関数を作成する

2024-01-07

この記事では、IntelliJ IDEA プロジェクトで HTTP によってトリガーされる Java 関数を作成して、統合開発環境 (IDE) でこのプロジェクトを実行およびデバッグし、最後にこの関数プロジェクトを Azure の関数アプリにデプロイする方法について説明します。

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

開発環境を設定する

IntelliJ を使用して Kotlin 関数を作成し、Azure に発行するには、次のソフトウェアをインストールします。

Java Developer Kit (JDK) バージョン 8
Apache Maven バージョン 3.0 以降
IntelliJ IDEA、コミュニティまたは Maven が付属した Ultimate バージョン
Azure CLI
Azure Functions Core Tools のバージョン 2.x。ここには、Azure Functions を記述、実行、デバッグするためのローカル開発環境が提供されます。

重要

この記事の手順を行うには、JAVA_HOME 環境変数を JDK のインストール場所に設定する必要があります。

関数プロジェクトを作成する

IntelliJ IDEA で、 [新しいプロジェクトの作成] を選択します。
[新しいプロジェクト] ウィンドウの左ウィンドウで [Maven] を選択します。
[Create from archetype](アーキタイプからの作成) チェックボックスをオンにして、 [Add Archetype](アーキタイプの追加) で [azure-functions-kotlin-archetype] を選択します。
[Add Archetype](アーキタイプの追加) ウィンドウで、次のように各フィールドに入力します。
- GroupId: com.microsoft.azure
- ArtifactId: azure-functions-kotlin-archetype
- Version: 中央リポジトリの最新バージョンを使用します
[OK] を選択し、 [次へ] を選択します。
現在のプロジェクトの詳細を入力し、 [完了] を選択します。

Maven は、ArtifactId 値と同じ名前で新しいフォルダーにプロジェクトファイルを作成します。生成されるプロジェクトのコードは、トリガーする HTTP 要求の本文をエコーする、HTTP によってトリガーされる単純な関数です。

IDE でプロジェクトをローカルに実行する

注

プロジェクトをローカルで実行およびデバッグするには、Azure Functions Core Tools、バージョン 2 がインストールされていることを確認してください。

変更を手動でインポートするか、自動インポートを有効にします。
[Maven Projects] (Maven プロジェクト) ツールバーを開きます。
[Lifecycle] を展開し、 [package] を開きます。ソリューションが、新しく作成されたターゲットディレクトリに構築されパッケージ化されます。
[Plugins]>[azure-functions] を展開し、 [azure-functions:run] を開いて Azure Functions ローカルランタイムを開始します。
関数のテストが終了したら、実行ダイアログボックスを閉じます。アクティブにして同時にローカルで実行できる関数ホストは 1 つだけです。

IntelliJ でプロジェクトをデバッグする

デバッグモードで関数ホストを開始するには、関数の実行時に -DenableDebug を引数として追加します。 maven goals で構成を変更することも、ターミナルウィンドウで次のコマンドを実行することもできます。
```
mvn azure-functions:run -DenableDebug
```
このコマンドにより、関数ホストがデバッグポートを 5005 で開きます。
[実行] メニューで [構成の編集] を選択します。
(+) を選択して、 [リモート] を追加します。
[名前] および [設定] フィールドに入力し、 [OK] を選択して構成を保存します。
セットアップ後、[Debug < Remote Configuration Name >](<リモート構成名> のデバッグ) を選択するか、キーボードで Shift + F9 キーを押してデバッグを開始します。
完了したら、デバッガーと実行中のプロセスを停止します。アクティブにして同時にローカルで実行できる関数ホストは 1 つだけです。

Azure にプロジェクトをデプロイする

プロジェクトを Azure の関数アプリにデプロイする前に、Azure CLI を使用してログインする必要があります。
```
az login
```
azure-functions:deploy Maven ターゲットを使用して、新しい関数アプリにコードをデプロイします。 [Maven Projects]\(Maven プロジェクト) ウィンドウで azure-functions:deploy オプションを選択することもできます。
```
mvn azure-functions:deploy
```

関数アプリが正常にデプロイされると、Azure CLI 出力に HTTP トリガー関数の URL が表示されます。

[INFO] Successfully deployed Function App with package.
[INFO] Deleting deployment package from Azure Storage...
[INFO] Successfully deleted deployment package fabrikam-function-20170920120101928.20170920143621915.zip
[INFO] Successfully deployed Function App at https://fabrikam-function-20170920120101928.azurewebsites.net
[INFO] ------------------------------------------------------------------------

次のステップ

これで、最初の Kotlin 関数アプリを Azure にデプロイできました。Java と Kotlin の関数の開発については、「Azure Functions の Java 開発者向けガイド」をご確認ください。

azure-functions:add Maven ターゲットを使って、異なるトリガーの新しい関数アプリをプロジェクトに追加します。