在 Azure 中使用 IntelliJ 创建第一个 Kotlin 函数
本文介绍如何在 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 目标将具有不同触发器的其他函数应用添加到你的项目。