Erstellen Ihrer ersten Funktion im Azure-Portal

  • Artikel

Mit Azure Functions können Sie Ihren Code in einer serverlosen Umgebung ausführen, ohne vorher einen virtuellen Computer zu erstellen oder eine Webanwendung zu veröffentlichen. In diesem Artikel erfahren Sie, wie Sie Azure Functions verwenden können, um eine HTTP-Triggerfunktion „Hello World“ im Azure-Portal zu erstellen.

Hinweis

Die Bearbeitung im Portal wird nur für JavaScript-, PowerShell-, Python und C#-Skriptfunktionen unterstützt. Die Bearbeitung von Python im Portal wird nur unterstützt, wenn sie im Verbrauchsplan ausgeführt und das Python v1-Programmiermodell verwendet wird.
Die Bearbeitung im Portal wird derzeit nur für Funktionen unterstützt, die im Portal erstellt oder zuletzt geändert wurden. Wenn Sie den Code außerhalb des Portals in einer Funktions-App bereitstellen, können Sie die Codes für diese Funktions-App im Portal nicht mehr bearbeiten. In diesem Fall verwenden Sie einfach die lokale Entwicklung weiter. Für kompilierte C#-Funktionen, Java-Funktionen und andere Python-Funktionen können Sie die Funktions-App im Portal erstellen. Sie müssen das Funktionscodeprojekt jedoch auch lokal erstellen und es dann in Azure veröffentlichen.

Es wird empfohlen, Ihre Funktionen lokal zu entwickeln und in einer Funktions-App in Azure zu veröffentlichen.
Die folgenden Links bieten Informationen zum Einstieg mit der von Ihnen bevorzugten lokalen Entwicklungsumgebung und Sprache:

Visual Studio Code Terminal/Eingabeaufforderung Visual Studio
• Erste Schritte mit C#
• Erste Schritte mit Java
• Erste Schritte mit JavaScript
• Erste Schritte mit PowerShell
• Erste Schritte mit Python		 • Erste Schritte mit C#
• Erste Schritte mit Java
• Erste Schritte mit JavaScript
• Erste Schritte mit PowerShell
• Erste Schritte mit Python		 Erste Schritte mit C#

Details zur Sprachunterstützung

Die folgende Tabelle zeigt, welche von Functions unterstützten Sprachen unter Linux oder Windows ausgeführt werden können. Außerdem wird angegeben, ob Ihre Sprache die Bearbeitung im Azure-Portal unterstützt. Die Sprache basiert auf der Option Laufzeitstapel, die Sie beim Erstellen Ihrer Funktions-App im Azure-Portal auswählen. Diese entspricht der Option --worker-runtime bei Verwendung des Befehls func init in den Azure Functions Core Tools.

Sprache Laufzeitstapel Linux Windows Bearbeitung im Portal
C# (In-Process-Modell) .NET ✓ ✓
C# (isoliertes Workermodell) .NET ✓ ✓2
C#-Skript .NET ✓ ✓ ✓
JavaScript Node.js ✓ ✓ ✓
Python1 Python ✓ ✓
Java Java ✓ ✓
PowerShell PowerShell Core ✓ ✓ ✓
TypeScript Node.js ✓ ✓
Go/Rust/other Benutzerdefinierte Handler ✓ ✓

1 Für die portalinterne Bearbeitung muss Ihre Funktion in einer Datei namens „function.json“ definiert werden. Da das Python v2-Programmiermodell Python-Code-Decorators anstelle von function.json verwendet, um Funktionen zu definieren, wird nur das Python v1-Programmiermodell für die portalinterne Entwicklung unterstützt.

2 Die Vorschauversion für .NET 8 für das isolierte Workermodell unterstützt derzeit nur Linux. Alle anderen Versionen von .NET werden unter Windows unterstützt.

Weitere Informationen zur Betriebssystem- und Sprachunterstützung finden Sie unter Unterstützung für Betriebssystem/Runtime.

Wenn die Bearbeitung im Portal nicht verfügbar ist, müssen Sie stattdessen Ihre Funktionen lokal entwickeln.

Voraussetzungen

Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.

Anmelden bei Azure

Melden Sie sich mit Ihrem Azure-Konto beim Azure-Portal an.

Erstellen einer Funktionen-App

Sie müssen über eine Funktionen-App verfügen, die die Ausführung Ihrer Funktionen in Azure hostet. Sie können mit einer Funktions-App Funktionen zu logischen Einheiten gruppieren. Dies erleichtert die Verwaltung, Bereitstellung, Skalierung und Freigabe von Ressourcen.

  1. Klicken Sie im Menü des Azure-Portals oder auf der Startseite auf Ressource erstellen.

  2. Wählen Sie auf der Seite Neu die Option Compute>Funktions-App aus.

  3. Verwenden Sie auf der Seite Grundlagen die Funktions-App-Einstellungen, die in der folgenden Tabelle angegeben sind:

    Einstellung Vorgeschlagener Wert Beschreibung
    Abonnement Ihr Abonnement Das Abonnement, unter dem Sie Ihre neue Funktions-App erstellen.
    Ressourcengruppe myResourceGroup Der Name der neuen Ressourcengruppe, in der Sie Ihre Funktions-App erstellen. Sie sollten eine neue Ressourcengruppe erstellen, da beim Erstellen neuer Funktions-Apps in einer vorhandenen Ressourcengruppe bekannte Einschränkungen gelten.
    Name der Funktions-App Global eindeutiger Name Der Name, der Ihre neue Funktionen-App bezeichnet Gültige Zeichen sind a-z (Groß-/Kleinschreibung nicht beachtet), 0-9 und -.
    Möchten Sie Code oder ein Containerimage bereitstellen? Code Option zum Veröffentlichen von Codedateien oder eines Docker-Containers.
    Laufzeitstapel Bevorzugte Sprache Wählen Sie eine Runtime aus, die Ihre bevorzugte Programmiersprache für Funktionen unterstützt. Die Bearbeitung im Portal ist nur für JavaScript-, PowerShell-, Python v1-, TypeScript- und C#-Skripts verfügbar. C#-Klassenbibliotheks-, Java- und Python v2-Funktionen müssen lokal entwickelt werden.
    Version Versionsnummer Wählen Sie die Version der installierten Runtime aus.
    Region Bevorzugte Region Wählen Sie eine Region in Ihrer Nähe oder in der Nähe anderer Dienste aus, auf die Ihre Funktionen zugreifen können.
    Betriebssystem Windows Ein Betriebssystem ist für Sie basierend auf Ihrer Runtimestapelauswahl vorab ausgewählt, aber Sie können die Einstellung ggf. ändern. Die portalinterne Bearbeitung wird nur unter Windows unterstützt. Die Containerveröffentlichung wird nur unter Linux unterstützt.
    Hostingoptionen und -pläne Verbrauch (serverlos) Der Hostingplan, der definiert, wie Ihre Ressourcen der Funktionen-App zugewiesen werden Im Standard-Verbrauchstarif werden Ressourcen so dynamisch hinzugefügt, wie dies für Ihre Funktionen erforderlich ist. Beim serverlosen Hosting bezahlen Sie nur die Zeit, in der Ihre Funktionen ausgeführt werden. Der Premium-Plan bietet auch eine dynamische Skalierung. Bei der Ausführung in einem App Service-Plan müssen Sie die Skalierung Ihrer Funktions-App verwalten.

  4. Übernehmen Sie die Standardoptionen zum Erstellen eines neuen Speicherkontos auf der Registerkarte Speicher und einer neuen Application Insight-Instanz auf der Registerkarte Überwachung. Sie können auch ein vorhandenes Speicherkonto oder eine vorhandene Application Insights-Instanz verwenden.

  5. Klicken Sie auf Überprüfen + erstellen, um die ausgewählte App-Konfiguration zu überprüfen, und dann auf Erstellen, um die Funktions-App bereitzustellen.

  6. Wählen Sie oben rechts im Portal das Benachrichtigungssymbol aus, und achten Sie auf die Meldung Bereitstellung erfolgreich.

  7. Wählen Sie Zu Ressource wechseln, um Ihre neue Funktionen-App anzuzeigen. Sie können auch die Option An Dashboard anheften auswählen. Wenn Sie die Funktions-App anheften, können Sie einfacher über das Dashboard auf sie zugreifen.

    Screenshot: Bereitstellungsbenachrichtigung

Erstellen Sie als Nächstes eine Funktion in der neuen Funktions-App.

Erstellen einer HTTP-Triggerfunktion

  1. Wählen Sie im linken Menü des Fensters Funktions-App die Option Funktionen und dann im oberen Menü Erstellen aus.

  2. Übernehmen Sie im Fenster Funktion erstellen für die Eigenschaft Entwicklungsumgebung die Option Im Portal entwickeln, und wählen Sie die Vorlage HTTP-Trigger aus.

    Screenshot: HTTP-Triggerfunktion

  3. Wählen Sie unter Vorlagendetails für Neue Funktion die Option HttpExample aus, wählen Sie aus der Dropdownliste Autorisierungsebene die Option Anonym aus, und wählen Sie dann Erstellen aus.

    Azure erstellt die HTTP-Triggerfunktion. Nun können Sie die neue Funktion ausführen, indem Sie eine HTTP-Anforderung senden.

Testen der Funktion

Tipp

Die Option Programmieren und testen im Portal funktioniert auch für Funktionen, die schreibgeschützt sind und im Portal nicht bearbeitet werden können.

  1. Wählen Sie in Ihrer neuen HTTP-Triggerfunktion im Menü auf der linken Seite Programmieren + testen und dann im obersten Menü Funktions-URL abrufen aus.

    Screenshot: Fenster „Funktions-URL abrufen“

  2. Wählen Sie im Dialogfeld Funktions-URL abrufen im Dropdownmenü die Option Standard und anschließend das Symbol In Zwischenablage kopieren aus.

    Screenshot: Fenster „Funktions-URL kopieren“ im Azure-Portal

  3. Fügen Sie die URL der Funktion in die Adressleiste Ihres Browsers ein. Fügen Sie den Wert der Abfragezeichenfolge ?name=<your_name> am Ende der URL hinzu, und drücken Sie die EINGABETASTE, um die Anforderung auszuführen. Im Browser muss eine Antwortmeldung angezeigt werden, die den Wert Ihrer Abfragezeichenfolge zurückgibt.

    Wenn die Anforderungs-URL einen Zugriffsschlüssel (?code=...) enthielt, bedeutet dies, dass Sie beim Erstellen der Funktion die Zugriffsebene Funktion anstelle der Zugriffsebene Anonym ausgewählt haben. In diesem Fall müssen Sie stattdessen &name=<your_name> anfügen.

  4. Wenn Ihre Funktion ausgeführt wird, werden Nachverfolgungsinformationen in die Protokolle geschrieben. Um die Nachverfolgungsausgabe anzuzeigen, kehren Sie zur Seite Code + testen im Portal zurück, und erweitern Sie den Pfeil Protokolle am unteren Rand der Seite. Rufen Sie Ihre Funktion erneut auf, um die in die Protokolle geschriebene Ablaufverfolgungsausgabe anzuzeigen.

    Screenshot: Protokollanzeige für Funktionen im Azure-Portal

Bereinigen von Ressourcen

Andere Schnellstarts in dieser Sammlung bauen auf diesem Schnellstart auf. Überspringen Sie die Bereinigung der Ressourcen, falls Sie mit nachfolgenden Schnellstartanleitungen, Tutorials oder einem der Dienste, die Sie im Rahmen dieser Schnellstartanleitung erstellt haben, weiterarbeiten möchten.

Ressourcen bezieht sich bei Azure auf Funktions-Apps, Funktionen, Speicherkonten und Ähnliches. Sie werden in Ressourcengruppen zusammengefasst, und sämtliche Inhalte einer Gruppe können durch das Löschen der Gruppe gelöscht werden.

Im Rahmen dieser Schnellstarts haben Sie Ressourcen erstellt. Für diese Ressourcen fallen je nach Kontostatus und Dienstpreisen ggf. Kosten an. Nicht mehr benötigte Ressourcen können wie folgt gelöscht werden:

  1. Navigieren Sie im Azure-Portal zur Seite Ressourcengruppe.

    Von der Seite „Funktions-App“ aus gelangen Sie zu dieser Seite, indem Sie die Registerkarte Übersicht und anschließend unter Ressourcengruppe den Link auswählen.

    Screenshot: Auswahl der zu löschenden Ressourcengruppe von der Funktions-App-Seite

    Vom Dashboard aus gelangen Sie zu dieser Seite, indem Sie Ressourcengruppen und anschließend die Ressourcengruppe auswählen, die Sie für diesen Artikel verwendet haben.

  2. Prüfen Sie auf der Seite Ressourcengruppe die Liste mit den enthaltenen Ressourcen, und vergewissern Sie sich, dass es sich dabei um die Ressourcen handelt, die Sie löschen möchten.

  3. Wählen Sie Ressourcengruppe löschen aus, und folgen Sie den Anweisungen.

    Der Löschvorgang kann einige Minuten in Anspruch nehmen. Nach Abschluss des Vorgangs wird kurz eine Benachrichtigung angezeigt. Sie können auch am oberen Seitenrand auf das Glockensymbol klicken, um die Benachrichtigung anzuzeigen.

Nächste Schritte

Sie haben Ihre erste Funktion erstellt. Fügen Sie ihr nun eine Ausgabebindung hinzu, die eine Meldung in eine Storage-Warteschlange schreibt.

Hinzufügen von Meldungen in eine Azure Storage-Warteschlange mithilfe von Functions