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

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

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

设置开发环境

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

重要

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

创建函数项目

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

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

在 IDE 中本地运行项目

注意

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

  1. 手动导入更改或启用自动导入

  2. 打开“Maven 项目”工具栏 。

  3. 展开“生命周期”然后打开“包” 。 该解决方案是在新创建的目标目录中生成和打包的。

  4. 展开“插件”>“azure-functions”,并打开“azure-functions:run”以启动 Azure Functions 本地运行时 。
    Azure Functions 的 Maven 工具栏

  5. 完成函数测试后关闭运行对话框。 一次只能有一个函数主机处于活动状态并在本地运行。

在 IntelliJ 中调试项目

  1. 若要在调试模式下启动函数主机,请在运行函数时添加 -DenableDebug 作为参数。 可以更改 Maven 目标中的配置或在终端窗口中运行以下命令:

    mvn azure-functions:run -DenableDebug
    

    此命令会让函数主机打开调试端口 5005。

  2. 请在“运行”菜单中选择“编辑配置” 。

  3. 选择“(+)”添加“远程” 。

  4. 填写“名称”和“设置”字段,然后选择“确定”以保存配置 。

  5. 在设置后,选择“Debug <Remote Configuration Name>”(调试 <远程配置名称>)或在键盘上按 Shift+F9 以启动调试。

    在 IntelliJ 中调试项目

  6. 完成后,请停止调试器和正在运行的进程。 一次只能有一个函数主机处于活动状态并在本地运行。

将项目部署到 Azure

  1. 必须先使用 Azure CLI 登录,然后才能将项目部署到 Azure 中的函数应用。

    az login
    
  2. 使用 azure-functions:deploy Maven 目标将代码部署到新的函数应用。 也可以在“Maven 项目”窗口中选择“azure-functions:deploy”选项 。

    mvn azure-functions:deploy
    
  3. 成功部署函数应用后,在 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 目标将具有不同触发器的其他函数应用添加到你的项目。