Teilen über


Erstellen Ihrer ersten dauerhaften Funktion in C#

Durable Functions ist eine Erweiterung von Azure Functions, mit der Sie zustandsbehaftete Funktionen in einer serverlosen Umgebung schreiben können. Die Erweiterung verwaltet Status, Prüfpunkte und Neustarts für Sie.

Durable Functions unterstützt wie Azure Functions zwei Prozessmodelle für .NET-Klassenbibliotheksfunktionen:

Ausführungsmodell Beschreibung
Isoliertes Workermodell Ihr Funktionscode wird in einem separaten .NET-Workerprozess ausgeführt. Verwenden Sie dazu unterstützte Versionen von .NET und .NET Framework. Weitere Informationen finden Sie unter Entwickeln von isolierten .NET-Workerprozessfunktionen.
In-Process-Modell Ihr Funktionscode wird im gleichen Prozess wie der Functions-Hostprozess ausgeführt. Unterstützt nur LTS-Versionen (Long Term Support) von .NET. Weitere Informationen finden Sie unter Entwickeln von .NET-Klassenbibliotheksfunktionen.

Weitere Informationen zu den beiden Prozessen finden Sie unter Unterschiede zwischen In-Process und isolierten Workerprozess .NET-Azure Functions.

In diesem Artikel erfahren Sie, wie Sie Visual Studio Code verwenden, um eine dauerhafte Funktion vom Typ „hello world“ lokal zu erstellen und zu testen. Mit dieser Funktion werden Aufrufe anderer Funktionen orchestriert und miteinander verkettet. Anschließend können Sie den Funktionscode in Azure veröffentlichen. Diese Tools sind Teil der Azure Functions-Erweiterung für Visual Studio Code.

Screenshot: Visual Studio Code-Fenster mit einer dauerhaften Funktion.

Voraussetzungen

Für dieses Tutorial benötigen Sie Folgendes:

  • Installieren Sie Visual Studio Code.

  • Installieren Sie die folgenden Visual Studio Code-Erweiterungen:

  • Stellen Sie sicher, dass Sie über die neueste Version der Azure Functions Core Tools verfügen.

  • Für Durable Functions ist ein Azure-Speicherkonto erforderlich. Sie benötigen ein Azure-Abonnement.

  • Vergewissern Sie sich, dass bei Ihnen mindestens die Version 3.1 des .NET Core SDK installiert ist.

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

Erstellen Ihres lokalen Projekts

In diesem Abschnitt wird mithilfe von Visual Studio Code ein lokales Azure Functions-Projekt erstellt.

  1. Drücken Sie in Visual Studio Code F1 (oder STRG/BEFEHLSTASTE+UMSCHALT+P), um die Befehlspalette zu öffnen. Suchen Sie in der Befehlspalette den Befehl Azure Functions: Create New Project..., und wählen Sie ihn aus.

    Screenshot: Fenster zum Erstellen eines Funktionsprojekts.

  2. Wählen Sie einen leeren Ordner für Ihr Projekt und anschließend Auswählen aus.

  3. Geben Sie an den Eingabeaufforderungen die folgenden Informationen an:

    Prompt Wert BESCHREIBUNG
    Auswählen einer Sprache für Ihr Funktions-App-Projekt C# Erstellen Sie ein lokales C#-Functions-Projekt.
    „Select a version“ (Wählen Sie eine Version aus.) Azure Functions v4 Diese Option wird nur angezeigt, wenn die Core Tools noch nicht installiert sind. In diesem Fall werden die Core Tools beim erstmaligen Ausführen der App installiert.
    Auswählen einer .NET-Laufzeit .NET 8.0 (isoliert) Erstellt ein Funktionsprojekt, das .NET 8 unterstützt, das in einem isolierten Arbeitsprozess und der Azure Functions-Runtime 4.0 ausgeführt wird. Weitere Informationen finden Sie unter Einstellen von Runtimeversionen von Azure Functions als Ziel.
    Auswählen einer Vorlage für die erste Funktion Ihres Projekts Orchestrator für Durable Functions Erstellen Sie eine Orchestrierung für Durable Functions.
    Auswählen eines dauerhaften Speichertyps Azure Storage Standardspeicheranbieter für Durable Functions Weitere Details finden Sie unter Speicheranbieter für Durable Functions.
    Angeben eines Funktionsnamens HelloOrchestration Name der Orchestrierungsfunktion
    Angeben eines Namespaces Company.Function Der Namespace für die generierte Klasse.
    Auswählen, wie Sie Ihr Projekt öffnen möchten Im aktuellen Fenster Öffnet Visual Studio Code wieder im ausgewählten Ordner.

Von Visual Studio Code werden bei Bedarf die Azure Functions Core Tools installiert. Außerdem wird ein Funktions-App-Projekt in einem Ordner erstellt. Dieses Projekt enthält die Konfigurationsdateien host.json und local.settings.json.

Es gibt auch eine Datei namens HelloOrchestration.cs, die die grundlegenden Bausteine einer Durable Functions-App enthält:

Methode Beschreibung
HelloOrchestration Verwaltet die dauerhafte Orchestrierung In diesem Fall wird die Orchestrierung gestartet, es wird eine Liste erstellt, und das Ergebnis der drei Funktionsaufrufe wird der Liste hinzugefügt. Wenn die drei Funktionsaufrufe abgeschlossen sind, wird die Liste zurückgegeben.
SayHello Einfache Funktion, die „Hello“ zurückgibt Es ist die Funktion mit der Geschäftslogik, die orchestriert wird.
HelloOrchestration_HttpStart Eine per HTTP ausgelöste Funktion, mit der eine Instanz der Orchestrierung gestartet und eine Antwort zur Überprüfung des Status zurückgegeben wird.

Weitere Details zu diesen Funktionen finden Sie unter Typen und Features von Durable Functions.

Konfigurieren des Speichers

Sie können Azurite, einen Emulator für Azure Storage, verwenden, um die Funktion lokal zu testen. Legen Sie dazu AzureWebJobStorage in local.settings.json auf UseDevelopmentStorage=true fest:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
  }
}

Sie können die Azurite-Erweiterung in Visual Studio Code installieren und starten, indem Sie Azurite: Start in der Befehlspalette ausführen.

Es gibt weitere Speicheroptionen, die Sie für Ihre Durable Functions-App verwenden können. Weitere Informationen zu den verschiedenen Speicheroptionen und ihren Nutzen finden Sie unter Durable Functions-Speicheranbieter.

Lokales Testen der Funktion

Mit Azure Functions Core Tools können Sie ein Azure Functions-Projekt lokal ausführen. Sie werden beim ersten Starten einer Funktion in Visual Studio Code zum Installieren dieser Tools aufgefordert.

  1. Legen Sie zum Testen der Funktion einen Breakpoint im Funktionscode der Aktivität SayHello fest, und drücken Sie F5, um das Funktions-App-Projekt zu starten. Die Ausgabe der Core Tools wird im Bereich Terminal angezeigt.

    Hinweis

    Weitere Informationen zum Debuggen finden Sie unter Diagnose in Durable Functions.

    Hinweis

    Wenn ein Fehler „Keine Auftragsfunktionen gefunden“ auftritt, aktualisieren Sie Ihre Installation von Azure Functions Core Tools auf die neueste Version. Ältere Versionen der Core Tools unterstützen das isolierte .NET nicht.

  2. Kopieren Sie im Bereich Terminal den URL-Endpunkt Ihrer über HTTP ausgelösten Funktion.

    Screenshot: Fenster der lokalen Ausgabe von Azure.

  3. Verwenden Sie ein Tool wie Postman oder cURL, und senden Sie eine HTTP-POST-Anforderung an den URL-Endpunkt.

    Die Antwort ist das erste Ergebnis der HTTP-Funktion, das informiert, dass die dauerhafte Orchestrierung erfolgreich gestartet wurde. Es ist noch nicht das Endergebnis der Orchestrierung. Die Antwort enthält einige nützliche URLs.

    An diesem Punkt sollte Ihr Haltepunkt in der Aktivitätsfunktion erreicht werden, da die Orchestrierung begonnen hat. Führen Sie diesen Code schrittweise aus, um eine Antwort auf den Status der Orchestrierung zu erhalten.

  4. Kopieren Sie den URL-Wert für statusQueryGetUri, fügen Sie ihn in die Adressleiste des Browsers ein, und führen Sie anschließend die Anforderung aus. Alternativ können Sie auch weiterhin Postman verwenden, um die GET-Anforderung auszuführen.

    Mit der Anforderung wird für die Orchestrierungsinstanz der Status abgefragt. Sie sollten sehen, dass die Instanz abgeschlossen wurde, und die Ausgaben bzw. Ergebnisse der Durable Function enthält. Er sieht wie folgt aus:

    {
        "name":"HelloCities",
        "instanceId":"7f99f9474a6641438e5c7169b7ecb3f2",
        "runtimeStatus":"Completed",
        "input":null,
        "customStatus":null,
        "output":"Hello, Tokyo! Hello, London! Hello, Seattle!",
        "createdTime":"2023-01-31T18:48:49Z",
        "lastUpdatedTime":"2023-01-31T18:48:56Z"
    }
    

    Hinweis

    Sie können das Wiedergabeverhalten von Durable Functions durch Haltepunkte beobachten. Da es sich hierbei um ein wichtiges Konzept handelt, wird dringend empfohlen, den verknüpften Artikel zu lesen.

  5. Drücken Sie in Visual Studio Code UMSCHALT+F5, um das Debuggen zu beenden.

Nachdem Sie sichergestellt haben, dass die Funktion auf Ihrem lokalen Computer richtig ausgeführt wird, können Sie das Projekt in Azure veröffentlichen.

Anmelden bei Azure

Bevor Sie Azure-Ressourcen erstellen oder Ihre App veröffentlichen können, müssen Sie sich bei Azure anmelden.

  1. Sollten Sie noch nicht angemeldet sein, wählen Sie auf der Aktivitätsleiste das Azure-Symbol aus. Wählen Sie dann im Bereich Ressourcen die Option Bei Azure anmelden... aus.

    Screenshot: das Fenster für die Anmeldung bei Azure in VS Code.

    Wenn Sie bereits angemeldet sind und Ihre vorhandenen Abonnements anzeigen können, fahren Sie mit dem nächsten Abschnitt fort. Wenn Sie noch kein Azure-Konto haben, wählen Sie Azure-Konto erstellen aus. Lernende können Microsoft Azure for Students-Konto erstellen... auswählen.

  2. Wählen Sie im Browser nach entsprechender Aufforderung Ihr Azure-Konto aus, und melden Sie sich mit Ihren Azure-Anmeldeinformationen an. Wenn Sie ein neues Konto erstellen, können Sie sich anmelden, nachdem Ihr Konto erstellt wurde.

  3. Wenn Sie sich erfolgreich angemeldet haben, können Sie das neue Browserfenster schließen. Die Abonnements, die zu Ihrem Azure-Konto gehören, werden auf der Seitenleiste angezeigt.

Erstellen der Funktions-App in Azure

In diesem Abschnitt erstellen Sie eine Funktions-App und zugehörige Ressourcen in Ihrem Azure-Abonnement.

  1. Drücken Sie in Visual Studio Code F1, um die Befehlspalette zu öffnen, und suchen Sie nach dem Befehl Azure Functions: Create Function App in Azure... und führen Sie ihn aus.

  2. Geben Sie nach entsprechender Aufforderung Folgendes ein:

    Prompt Auswahl
    Auswählen des Abonnements Wählen Sie das zu verwendende Abonnement aus. Diese Eingabeaufforderung wird nicht angezeigt, wenn nur ein Abonnement unter Ressourcen sichtbar ist.
    Eingeben eines global eindeutigen Namens für die Funktions-App Geben Sie einen Namen ein, der in einem URL-Pfad gültig ist. Der eingegebene Name wird überprüft, um sicherzustellen, dass er in Azure Functions eindeutig ist.
    Wählen Sie einen Runtimestapel aus Wählen Sie die lokal ausgeführte Sprachversion aus.
    Auswählen eines Standorts für neue Ressourcen Wählen Sie eine Region in Ihrer Nähe aus, um eine bessere Leistung zu erzielen.

    Die Erweiterung zeigt den Status einzelner Ressourcen an, während diese in Azure im Bereich Azure: Aktivitätsprotokoll erstellt werden.

    Protokoll der Azure-Ressourcenerstellung

  3. Nach Abschluss der Erstellung werden in Ihrem Abonnement die folgenden Azure-Ressourcen erstellt. Die Ressourcen werden basierend auf Ihrem Funktions-App-Namen benannt:

    • Eine Ressourcengruppe, bei der es sich um einen logischen Container für verwandte Ressourcen handelt.
    • Ein Azure Storage-Standardkonto, unter dem Status- und andere Informationen zu Ihren Projekten verwaltet werden.
    • Eine Funktions-App, die als Umgebung zum Ausführen Ihres Funktionscodes dient. Mit einer Funktions-App können Sie Funktionen zu logischen Einheiten gruppieren. Dies erleichtert die Verwaltung, Bereitstellung und Freigabe von Ressourcen im selben Hostingplan.
    • Ein App Service-Plan, der den zugrunde liegenden Host für Ihre serverlose Funktions-App definiert.
    • Eine mit der Funktions-App verbundene Application Insights-Instanz, die die Nutzung Ihrer Funktionen in der App nachverfolgt.

    Nach der Erstellung der Funktions-App wird eine Benachrichtigung angezeigt, und das Bereitstellungspaket wird angewendet.

    Tipp

    Standardmäßig werden die von Ihrer Funktions-App benötigten Azure-Ressourcen basierend auf dem von Ihnen angegebenen Namen der Funktions-App erstellt. Darüber hinaus werden sie auch in derselben neuen Ressourcengruppe mit der Funktions-App erstellt. Falls Sie entweder die Namen dieser Ressourcen anpassen oder vorhandene Ressourcen wiederverwenden möchten, müssen Sie das Projekt stattdessen mit den erweiterten Erstellungsoptionen veröffentlichen.

Bereitstellen des Projekts in Azure

Wichtig

Bei der Bereitstellung in einer vorhandenen Funktions-App wird der Inhalt dieser App in Azure immer überschrieben.

  1. Suchen Sie in der Befehlspalette nach dem Befehl Azure Functions: Deploy to Function App... und führen Sie ihn aus.

  2. Wählen Sie die eben erstellte Funktions-App aus. Wenn Sie aufgefordert werden, vorherige Bereitstellungen zu überschreiben, wählen Sie Bereitstellen aus, um Ihren Funktionscode in der neuen Funktions-App-Ressource bereitzustellen.

  3. Wählen Sie nach Abschluss der Bereitstellung Ausgabe anzeigen aus, um die Erstellungs- und Bereitstellungsergebnisse (auch für die von Ihnen erstellten Azure-Ressourcen) anzuzeigen. Wenn Sie die Benachrichtigung übersehen haben, wählen Sie das Glockensymbol in der unteren rechten Ecke aus, um sie erneut anzuzeigen.

    Screenshot: das Fenster „Ausgabe anzeigen“.

Testen der Funktion in Azure

  1. Kopieren Sie die URL des HTTP-Triggers im Bereich Ausgabe. Die URL, über die Ihre durch HTTP ausgelöste Funktion aufgerufen wird, muss das folgende Format aufweisen:

    https://<functionappname>.azurewebsites.net/api/HelloOrchestration_HttpStart

  2. Fügen Sie diese neue URL für die HTTP-Anforderung in die Adresszeile des Browsers ein. Sie müssen die gleiche Statusantwort wie zuvor erhalten, als Sie die veröffentlichte App verwendet haben.

Nächste Schritte

Sie haben Visual Studio Code verwendet, um eine dauerhafte C#-Funktions-App zu erstellen und zu veröffentlichen.

In diesem Artikel werden Sie erfahren, wie Sie Visual Studio 2022 verwenden, um eine dauerhafte Funktion vom Typ „Hallo Welt“ lokal zu erstellen und zu testen, die in einem isolierten Workerprozess ausgeführt wird. Mit dieser Funktion werden Aufrufe anderer Funktionen orchestriert und miteinander verkettet. Anschließend veröffentlichen Sie den Funktionscode in Azure. Diese Tools sind als Teil der Azure-Entwicklungsworkload in Visual Studio 2022 verfügbar.

Screenshot: Visual Studio 2019-Fenster mit einer dauerhaften Funktion.

Voraussetzungen

Für dieses Tutorial benötigen Sie Folgendes:

  • Installieren Sie Visual Studio 2022. Vergewissern Sie sich, dass auch die Workload Azure-Entwicklung installiert ist. Visual Studio 2019 unterstützt ebenfalls die Durable Functions-Entwicklung, die Benutzeroberfläche und die Schritte weichen jedoch von den hier beschriebenen ab.

  • Vergewissern Sie sich, dass der Azurite-Emulator installiert ist und ausgeführt wird.

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

Erstellen eines Funktionen-App-Projekts

Mit der Azure Functions-Vorlage wird ein Projekt erstellt, das in einer Funktions-App in Azure veröffentlicht werden kann. Sie können mit einer Funktions-App Funktionen zu logischen Einheiten gruppieren. Dies erleichtert die Verwaltung, Bereitstellung, Skalierung und Freigabe von Ressourcen.

  1. Wählen Sie in Visual Studio im Menü Datei die Optionen Neu>Projekt.

  2. Suchen Sie im Dialogfeld Neues Projekt erstellen nach functions, und wählen Sie die Vorlage Azure Functions und dann Weiter aus.

    Screenshot des Dialogfelds „Neues Projekt“ in Visual Studio.

  3. Geben Sie einen Projektnamen für Ihr Projekt ein, und wählen Sie OK aus. Der Projektname muss als C#-Namespace gültig sein, verwenden Sie daher keine Unterstriche, Bindestriche oder nicht alphanumerische Zeichen.

  4. Verwenden Sie unter Zusätzliche Informationen die Einstellungen, die in der Tabelle unter der Abbildung angegeben sind.

    Screenshot: Dialogfeld „Neue Azure Functions-Anwendung erstellen“ in Visual Studio.

    Einstellung Vorgeschlagener Wert BESCHREIBUNG
    Functions-Worker .NET 8 isoliert (LTS) Erstellt ein Funktionsprojekt, das .NET 8 unterstützt, das in einem isolierten Arbeitsprozess und der Azure Functions-Runtime 4.0 ausgeführt wird. Weitere Informationen finden Sie unter Einstellen von Runtimeversionen von Azure Functions als Ziel.
    Funktion Orchestrator für Durable Functions Erstellen Sie eine Orchestrierung für Durable Functions.

Hinweis

Wenn .NET 8 im Worker-Dropdownmenü „Functions“ nicht isoliert angezeigt wird, liegt dies möglicherweise daran, dass Sie nicht über die neuesten Azure Functions-Toolsets und -Vorlagen verfügen. Wechseln Sie zu „Tools –> Optionen –> Projekte und Lösungen –> Azure Functions –> Nach Updates suchen“, um die neueste Version herunterzuladen.

  1. Stellen Sie sicher, dass das Kontrollkästchen „Azurite für Runtimespeicherkonto (AzureWebJobStorage) verwenden“ aktiviert ist. Dazu wird der Azurite-Emulator verwendet. Wählen Sie Erstellen aus, um ein Funktionsprojekt mit einer Orchestrierungsvorlage für Durable Functions zu erstellen. Dieses Projekt enthält die grundlegenden Konfigurationsdateien, die zum Ausführen Ihrer Funktionen benötigt werden.

Hinweis

Es gibt weitere Speicheroptionen, die Sie für Ihre Durable Functions-App verwenden können. Weitere Informationen zu den verschiedenen Speicheroptionen und ihren Nutzen finden Sie unter Durable Functions-Speicheranbieter.

In Ihrer Funktions-App wird eine Datei mit dem Namen Function1.cs mit drei Funktionen angezeigt, die die grundlegenden Bausteine von Durable Functions sind:

Methode Beschreibung
RunOrchestrator Verwaltet die dauerhafte Orchestrierung In diesem Fall wird die Orchestrierung gestartet, es wird eine Liste erstellt, und das Ergebnis der drei Funktionsaufrufe wird der Liste hinzugefügt. Wenn die drei Funktionsaufrufe abgeschlossen sind, wird die Liste zurückgegeben.
SayHello Die Funktion gibt „Hello“ zurück. Es ist die Funktion mit der Geschäftslogik, die orchestriert wird.
HttpStart Eine per HTTP ausgelöste Funktion, mit der eine Instanz der Orchestrierung gestartet und eine Antwort zur Überprüfung des Status zurückgegeben wird.

Weitere Details zu diesen Funktionen finden Sie unter Typen und Features von Durable Functions.

Lokales Testen der Funktion

Mit Azure Functions Core-Tools können Sie ein Azure Functions-Projekt auf dem lokalen Entwicklungscomputer ausführen. Sie werden beim ersten Starten einer Funktion in Visual Studio zum Installieren dieser Tools aufgefordert.

  1. Legen Sie zum Testen der Funktion einen Haltepunkt im Code der Aktivitätsfunktion SayHello fest, und drücken Sie F5. Akzeptieren Sie die entsprechende Aufforderung von Visual Studio zum Herunterladen und Installieren der Azure Functions Core (CLI)-Tools. Sie müssen möglicherweise auch eine Firewallausnahme aktivieren, damit die Tools HTTP-Anforderungen verarbeiten können.

Hinweis

Weitere Informationen zum Debuggen finden Sie unter Diagnose in Durable Functions.

  1. Kopieren Sie die URL Ihrer Funktion aus der Azure Functions-Laufzeitausgabe.

    Screenshot der lokalen Azure-Laufzeit.

  2. Fügen Sie die URL der HTTP-Anforderung in die Adresszeile des Browsers ein, und führen Sie die Anforderung aus. Hier ist die Antwort des Browsers auf die von der Funktion zurückgegebene lokale GET-Anforderung abgebildet:

    Screenshot: Browserfenster mit angezeigtem „statusQueryGetUri“.

    Die Antwort ist das erste Ergebnis der HTTP-Funktion, das informiert, dass die dauerhafte Orchestrierung erfolgreich gestartet wurde. Es ist noch nicht das Endergebnis der Orchestrierung. Die Antwort enthält einige nützliche URLs.

    An diesem Punkt sollte Ihr Haltepunkt in der Aktivitätsfunktion erreicht werden, da die Orchestrierung begonnen hat. Führen Sie diesen Code schrittweise aus, um eine Antwort auf den Status der Orchestrierung zu erhalten.

  3. Kopieren Sie den URL-Wert für statusQueryGetUri, fügen Sie ihn in die Adressleiste des Browsers ein, und führen Sie anschließend die Anforderung aus.

    Mit der Anforderung wird für die Orchestrierungsinstanz der Status abgefragt. Sie sollten sehen, dass die Instanz abgeschlossen ist und die Ausgaben Ihrer Aktivitätsaufrufe enthält. Er sieht wie folgt aus:

    {
        "name":"HelloCities",
        "instanceId":"668814ac6ce84a43a9e6757f81dbc0bc",
        "runtimeStatus":"Completed",
        "input":null,
        "customStatus":null,
        "output":"Hello, Tokyo! Hello, London! Hello Seattle!",
        "createdTime":"2023-01-31T16:44:34Z",
        "lastUpdatedTime":"2023-01-31T16:44:37Z"
    }
    

Hinweis

Sie können das Wiedergabeverhalten von Durable Functions durch Haltepunkte beobachten. Da es sich hierbei um ein wichtiges Konzept handelt, wird dringend empfohlen, den verknüpften Artikel zu lesen.

  1. Drücken Sie UMSCHALT+F5, um das Debuggen zu beenden.

Nachdem Sie sichergestellt haben, dass die Funktion auf Ihrem lokalen Computer richtig ausgeführt wird, können Sie das Projekt in Azure veröffentlichen.

Veröffentlichen des Projekts in Azure

Sie müssen in Ihrem Azure-Abonnement über eine Funktions-App verfügen, bevor Sie Ihr Projekt veröffentlichen. Sie können eine Funktions-App direkt in Visual Studio erstellen.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie Veröffentlichen aus. Wählen Sie unter Ziel die Option Azure und dann Weiter aus.

    Screenshot des Fensters „Veröffentlichen“.

  2. Wählen Sie Azure-Funktions-App (Windows) als das Spezifische Ziel aus. Es wird eine Funktions-App erstellt, die unter Windows ausgeführt wird, und wählen Sie dann Weiter aus.

    Screenshot des Fensters „Veröffentlichen“ mit spezifischem Ziel.

  3. Wählen Sie unter Funktionsinstanz die Option Neue Azure-Funktion erstellen aus.

    Screenshot des Erstellens einer neuen Funktions-App-Instanz.

  4. Erstellen Sie eine neue Instanz mit den Werten aus der folgenden Tabelle:

    Einstellung Wert Beschreibung
    Name Global eindeutiger Name Name, der Ihre neue Funktions-App eindeutig identifiziert. Übernehmen Sie diesen Namen, oder geben Sie einen neuen Namen ein. Gültige Zeichen: a-z, 0-9 und -.
    Abonnement Ihr Abonnement Das zu verwendende Azure-Abonnement. Übernehmen Sie dieses Abonnement, oder wählen Sie in der Dropdownliste ein neues Abonnement aus.
    Ressourcengruppe Name Ihrer Ressourcengruppe Die Ressourcengruppe, in der Sie Ihre Funktions-App erstellen möchten. Wählen Sie Neu aus, um eine neue Ressourcengruppe zu erstellen. Sie können ebenfalls eine vorhandene Ressourcengruppe in der Dropdownliste auswählen.
    Plantyp Nutzung Wenn Sie Ihr Projekt in einer Funktions-App veröffentlichen, die in einem Verbrauchsplan ausgeführt wird, bezahlen Sie nur für die Ausführungen Ihrer Funktions-App. Für andere Hostingpläne fallen höhere Kosten an.
    Location Standort des App-Diensts Wählen Sie einen Standort in einer Region in Ihrer Nähe oder in der Nähe anderer Dienste aus, auf die Ihre Funktionen zugreifen.
    Azure Storage Universelles Speicherkonto Für die Functions-Laufzeit ist ein Azure-Speicherkonto erforderlich. Wählen Sie Neu aus, um ein universelles Speicherkonto zu konfigurieren. Sie können auch ein vorhandenes Konto auswählen, das die Anforderungen an das Speicherkonto erfüllt.
    Application Insights Application Insights-Instanz Sie sollten die Application Insights-Integration für Ihre Funktions-App aktivieren. Wählen Sie Neu aus, um eine neue Instanz in einem neuen oder einem vorhandenen Log Analytics-Arbeitsbereich zu erstellen. Sie können ebenfalls eine vorhandene Instanz auswählen.

    Screenshot des Dialogfelds „App Service erstellen“.

  5. Wählen Sie Erstellen aus, um eine Funktions-App und die zugehörigen Ressourcen in Azure zu erstellen. Der Status der Ressourcenerstellung wird links unten im Fenster angezeigt.

  6. Vergewissern Sie sich unter Funktionsinstanz, dass die Option Aus Paketdatei ausführen aktiviert ist. Ihre Funktions-App wird unter Verwendung der ZIP-Bereitstellung mit aktiviertem Modus Run-From-Package bereitgestellt. Zip Deploy ist die empfohlene Bereitstellungsmethode für Ihr Funktionsprojekt, da damit eine bessere Leistung erzielt wird.

    Screenshot von „Abschließen der Profilerstellung“.

  7. Wählen Sie Fertig stellen und anschließend auf der Seite „Veröffentlichen“ die Option Veröffentlichen aus, um das Paket mit Ihren Projektdateien in der neuen Funktions-App in Azure bereitzustellen.

    Nach Abschluss der Bereitstellung wird die Stamm-URL der Funktions-App in Azure auf der Registerkarte Veröffentlichen angezeigt.

  8. Wählen Sie auf der Registerkarte „Veröffentlichen“ im Abschnitt „Hosting“ die Option Im Azure-Portal öffnen aus. Dadurch wird die Azure-Ressource für die neue Funktions-App im Azure-Portal geöffnet.

    Screenshot der Meldung zum erfolgreichen Veröffentlichen.

Testen der Funktion in Azure

  1. Kopieren Sie die Basis-URL der Funktions-App von der Seite „Veröffentlichungsprofil“. Ersetzen Sie den Teil localhost:port der URL, die Sie beim lokalen Testen der Funktion verwendet haben, durch die neue Basis-URL.

    Die URL, über die der HTTP-Trigger der dauerhaften Funktion aufgerufen wird, muss das folgende Format aufweisen:

    https://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>_HttpStart

  2. Fügen Sie diese neue URL für die HTTP-Anforderung in die Adresszeile des Browsers ein. Sie müssen die gleiche Statusantwort wie zuvor erhalten, als Sie die veröffentlichte App verwendet haben.

Nächste Schritte

Sie haben Visual Studio verwendet, um eine C#-Durable Functions-App zu erstellen und zu veröffentlichen.