Erstellen Ihrer ersten Kotlin-Funktion in Azure mit IntelliJ

2024-01-07

In diesem Artikel wird veranschaulicht, wie Sie eine durch HTTP ausgelöste Java-Funktion in einem IntelliJ IDEA-Projekt erstellen, das Projekt in der integrierten Entwicklungsumgebung (IDE) ausführen und debuggen und das Funktionsprojekt dann in einer Funktions-App in Azure bereitstellen.

Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Einrichten der Entwicklungsumgebung

Installieren Sie die folgende Software, um Kotlin-Funktionen mit IntelliJ in Azure zu erstellen und zu veröffentlichen:

Java Developer Kit (JDK), Version 8
Apache Maven, Version 3.0 oder höher
IntelliJ IDEA, Community- oder Ultimate-Version mit Maven
Azure-Befehlszeilenschnittstelle
Version 2.x der Azure Functions Core Tools. Sie stellen eine lokale Entwicklungsumgebung zum Schreiben, Ausführen und Debuggen von Azure Functions bereit.

Wichtig

Damit Sie die Schritte in diesem Artikel ausführen können, muss die Umgebungsvariable JAVA_HOME auf den Installationsspeicherort des JDK festgelegt sein.

Erstellen eines Funktionsprojekts

Wählen Sie in IntelliJ IDEA Neues Projekt erstellen aus.
Wählen Sie im Fenster Neues Projekt im linken Bereich Maven aus.
Aktivieren Sie das Kontrollkästchen Create from archetype (Aus Archetyp erstellen), und wählen Sie dann für azure-functions-kotlin-archetype die Option Add Archetype (Archetyp hinzufügen) aus.
Füllen Sie im Fenster Add Archetype (Archetyp hinzufügen) die Felder wie folgt aus:
- GroupId: com.microsoft.azure
- ArtifactId: azure-functions-kotlin-archetype
- Version: Verwenden Sie die neueste Version aus dem zentralen Repository (Erstellen eines Maven-Projekts aus einem Archetyp in IntelliJ IDEA)
Wählen Sie OK und anschließend Weiter aus.
Geben Sie Ihre Details für das aktuelle Projekt ein, und wählen Sie Fertig stellen aus.

Maven erstellt die Projektdateien in einem neuen Ordner mit dem Wert von ArtifactId als Name. Bei dem generierten Code des Projekts handelt es sich um eine einfache durch HTTP ausgelöste Funktion, die den Hauptteil der über HTTP ausgelösten Anforderung wiederholt.

Lokales Ausführen des Projekts in der IDE

Hinweis

Um das Projekt lokal ausführen und debuggen zu können, sollten Sie sicherstellen, dass Version 2 der Azure Functions Core Tools installiert ist.

Importieren Sie Änderungen manuell, oder aktivieren Sie den automatischen Import.
Öffnen Sie die Symbolleiste Maven-Projekte.
Erweitern Sie Lifecycle (Lebenszyklus), und öffnen Sie dann Paket. Die Lösung wird erstellt und in einem neu erstellten Zielverzeichnis verpackt.
Erweitern Sie Plug-Ins>azure-functions, und öffnen Sie azure-functions:run, um die Azure Functions-Runtime lokal zu starten.
Schließen Sie das Dialogfeld „Ausführen“, wenn Sie den Test der Funktion beendet haben. Es kann nicht mehr als ein Funktionshost gleichzeitig aktiv sein und lokal ausgeführt werden.

Debuggen des Projekts in IntelliJ

Um den Funktionshost im Debugmodus zu starten, fügen Sie -DenableDebug als Argument hinzu, wenn Sie Ihre Funktion ausführen. Sie können entweder die Konfiguration in maven goals ändern oder den folgenden Befehl in einem Terminalfenster ausführen:
```
mvn azure-functions:run -DenableDebug
```
Dieser Befehl bewirkt, dass der Funktionshost einen Debugport an 5005 öffnet.
Wählen Sie im Menü Run (Ausführen) Edit Configurations (Konfigurationen bearbeiten) aus.
Wählen Sie das Pluszeichen + aus, um einen Remote hinzuzufügen.
Füllen Sie die Felder Name und Einstellungen aus, und wählen Sie dann OK aus, um die Konfiguration zu speichern.
Wählen Sie nach dem Setup Debuggen <Name der Remotekonfiguration> aus, oder drücken Sie auf der Tastatur UMSCHALT+F9, um mit dem Debuggen zu beginnen.
Wenn Sie das Debuggen abgeschlossen haben, beenden Sie den Debugger und den laufenden Prozess. Es kann nicht mehr als ein Funktionshost gleichzeitig aktiv sein und lokal ausgeführt werden.

Bereitstellen des Projekts in Azure

Bevor Sie Ihr Projekt in einer Funktions-App in Azure bereitstellen können, müssen Sie sich über die Azure CLI anmelden.
```
az login
```
Stellen Sie Ihren Code mit azure-functions:deploy als Maven-Ziel in einer neuen Funktions-App bereit. Sie können auch die Option azure-functions:deploy im Maven Projects-Fenster aktivieren.
```
mvn azure-functions:deploy
```

Suchen Sie nach der URL für Ihre HTTP-Triggerfunktion in der Azure CLI-Ausgabe nach der erfolgreichen Bereitstellung der Funktions-App.

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

Nächste Schritte

Nachdem Sie Ihre erste Kotlin-Funktions-App in Azure bereitgestellt haben, können Sie sich im Java-Entwicklerhandbuch für Azure Functions mit weiteren Informationen zur Entwicklung von Java- und Kotlin-Funktionen vertraut machen.

Fügen Sie mit azure-functions:add als Maven-Ziel Ihrem Projekt zusätzliche Funktionen mit verschiedenen Triggern hinzu.

Freigeben über