Skip to content

Files

Latest commit

DavidCBerry13DavidCBerry13
(bulk) Update DevLang Metadata - Azure functions
Dec 29, 2021
ac31058 · Dec 29, 2021

History

History
106 lines (76 loc) · 5.79 KB

functions-create-maven-kotlin-intellij.md

File metadata and controls

106 lines (76 loc) · 5.79 KB
title description author ms.service ms.topic ms.date ms.author ms.devlang ms.custom
Create a Kotlin function in Azure Functions using IntelliJ
Learn how to use IntelliJ to create a simple HTTP-triggered Kotlin function, which you then publish to run in a serverless environment in Azure.
dglover
azure-functions
quickstart
03/25/2020
dglover
kotlin
mode-other

Create your first Kotlin function in Azure using IntelliJ

This article shows you how to create an HTTP-triggered Java function in an IntelliJ IDEA project, run and debug the project in the integrated development environment (IDE), and finally deploy the function project to a function app in Azure.

[!INCLUDE quickstarts-free-trial-note]

Set up your development environment

To create and publish Kotlin functions to Azure using IntelliJ, install the following software:

Important

The JAVA_HOME environment variable must be set to the install location of the JDK to complete the steps in this article.

Create a function project

  1. In IntelliJ IDEA, select Create New Project.
  2. In the New Project window, select Maven from the left pane.
  3. Select the Create from archetype check box, and then select Add Archetype for the azure-functions-kotlin-archetype.
  4. In the Add Archetype window, complete the fields as follows:
    • GroupId: com.microsoft.azure
    • ArtifactId: azure-functions-kotlin-archetype
    • Version: Use the latest version from the central repository Create a Maven project from archetype in IntelliJ IDEA
  5. Select OK, and then select Next.
  6. Enter your details for current project, and select Finish.

Maven creates the project files in a new folder with the same name as the ArtifactId value. The project's generated code is a simple HTTP-triggered function that echoes the body of the triggering HTTP request.

Run project locally in the IDE

Note

To run and debug the project locally, make sure you've installed Azure Functions Core Tools, version 2.

  1. Import changes manually or enable auto import.

  2. Open the Maven Projects toolbar.

  3. Expand Lifecycle, and then open package. The solution is built and packaged in a newly created target directory.

  4. Expand Plugins > azure-functions and open azure-functions:run to start the Azure Functions local runtime.
    Maven toolbar for Azure Functions

  5. Close the run dialog box when you're done testing your function. Only one function host can be active and running locally at a time.

Debug the project in IntelliJ

  1. To start the function host in debug mode, add -DenableDebug as the argument when you run your function. You can either change the configuration in maven goals or run the following command in a terminal window:

    mvn azure-functions:run -DenableDebug

    This command causes the function host to open a debug port at 5005.

  2. On the Run menu, select Edit Configurations.

  3. Select (+) to add a Remote.

  4. Complete the Name and Settings fields, and then select OK to save the configuration.

  5. After setup, select Debug < Remote Configuration Name > or press Shift+F9 on your keyboard to start debugging.

    Debug project in IntelliJ

  6. When you're finished, stop the debugger and the running process. Only one function host can be active and running locally at a time.

Deploy the project to Azure

  1. Before you can deploy your project to a function app in Azure, you must log in by using the Azure CLI.

    az login

  2. Deploy your code into a new function app by using the azure-functions:deploy Maven target. You can also select the azure-functions:deploy option in the Maven Projects window.

    mvn azure-functions:deploy

  3. Find the URL for your HTTP trigger function in the Azure CLI output after the function app has been successfully deployed.

    [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] ------------------------------------------------------------------------

Next steps

Now that you have deployed your first Kotlin function app to Azure, review the Azure Functions Java developer guide for more information on developing Java and Kotlin functions.

  • Add additional function apps with different triggers to your project by using the azure-functions:add Maven target.