在 Azure 中使用 IntelliJ 创建第一个 Kotlin 函数

项目
07/10/2024

本文介绍如何在 IntelliJ IDEA 项目中创建 HTTP 触发的 Java 函数，在集成开发环境 (IDE) 中运行和调试项目，最后将函数项目部署到 Azure 中的函数应用。

如果没有 Azure 订阅，可在开始前创建一个试用帐户。

设置开发环境

若要使用 IntelliJ 创建 Kotlin 函数并将其发布到 Azure，请安装以下软件：

Java 开发人员工具包 (JDK) 版本 8
Apache Maven 3.0 或更高版本
带有 Maven 的 IntelliJ IDEA 社区版或旗舰版
Azure CLI
Azure Functions Core Tools 版本 2.x。该工具为编写、运行和调试 Azure Functions 提供了本地开发环境。

重要

JAVA_HOME 环境变量必须设置为 JDK 的安装位置，以完成本文中的步骤。

创建函数项目

在 IntelliJ IDEA 中选择“新建项目” 。
在“新建项目”窗口中选择左窗格中的“Maven” 。
选中“从原型创建”复选框，然后针对 azure-functions-kotlin-archetype 选择“添加原型” 。
在“添加 Archetype”窗口中按以下说明填写各个字段：
- GroupId：com.microsoft.azure
- ArtifactId：azure-functions-kotlin-archetype
- 版本：使用中央存储库中的最新版本
选择“确定” ，然后选择“下一步” 。
输入当前项目的详细信息，并选择“完成” 。

Maven 在新文件夹中创建项目文件，文件名称与 ArtifactId 值相同。项目中生成的代码是一个简单的回显触发 HTTP 请求正文的 HTTP 触发函数。

在 IDE 中本地运行项目

注意

若要在本地运行和调试项目，请确保安装 Azure Functions Core Tools 版本 2。

手动导入更改或启用自动导入。
打开“Maven 项目”工具栏。
展开“生命周期”然后打开“包” 。该解决方案是在新创建的目标目录中生成和打包的。
展开“插件”>“azure-functions”，并打开“azure-functions:run”以启动 Azure Functions 本地运行时。
完成函数测试后关闭运行对话框。一次只能有一个函数主机处于活动状态并在本地运行。

在 IntelliJ 中调试项目

若要在调试模式下启动函数主机，请在运行函数时添加 -DenableDebug 作为参数。可以更改 Maven 目标中的配置或在终端窗口中运行以下命令：
```
mvn azure-functions:run -DenableDebug
```
此命令会让函数主机打开调试端口 5005。
请在“运行”菜单中选择“编辑配置” 。
选择“(+)”添加“远程” 。
填写“名称”和“设置”字段，然后选择“确定”以保存配置。
在设置后，选择“Debug <Remote Configuration Name>”（调试 <远程配置名称>）或在键盘上按 Shift+F9 以启动调试。
完成后，请停止调试器和正在运行的进程。一次只能有一个函数主机处于活动状态并在本地运行。

将项目部署到 Azure

必须先使用 Azure CLI 登录，然后才能将项目部署到 Azure 中的函数应用。
```
az login
```
使用 azure-functions:deploy Maven 目标将代码部署到新的函数应用。也可以在“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.chinacloudsites.cn
[INFO] ------------------------------------------------------------------------

后续步骤

将第一个 Kotlin 函数应用部署到 Azure 后，接下来请查看 Azure Functions Java 开发人员指南，详细了解如何开发 Java 和 Kotlin 函数。

使用 azure-functions:add Maven 目标将具有不同触发器的其他函数应用添加到你的项目。

通过