Freigeben über


Erstellen einer Funktion in Azure, die durch Blob Storage ausgelöst wird

Erfahren Sie, wie Sie eine Funktion erstellen, die ausgelöst wird, wenn Dateien in einen Blob Storage-Container hochgeladen oder aktualisiert werden.

Hinweis

Die Bearbeitung im Portal wird nur für JavaScript-, PowerShell- und C#-Skriptfunktionen unterstützt. Die Bearbeitung von Python im Portal wird nur unterstützt, wenn sie im Rahmen des Verbrauchsplans ausgeführt wird. Um eine C#-Skript-App zu erstellen, die die Bearbeitung im Portal unterstützt, müssen Sie eine Runtimeversion auswählen, die das In-Process-Modell unterstützt.

Entwickeln Sie Ihre Funktionen nach Möglichkeit lokal.

Weitere Informationen zu den Einschränkungen beim Bearbeiten von Funktionscode im Azure-Portal finden Sie unter Entwicklungseinschränkungen im Azure-Portal.

Voraussetzungen

  • Ein Azure-Abonnement. Sollten Sie kein Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Erstellen einer Azure Function-App

  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. Wählen Sie unter Hostingoption auswählen die Optionen Verbrauch>Auswählen aus, um Ihre App im Standardplan Verbrauch zu erstellen. Bei dieser serverlosen Hostingoption bezahlen Sie nur für 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. 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 -.
    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-, TypeScript- und C#-Skripts verfügbar.
    Um eine C#-Skript-App zu erstellen, die die Bearbeitung im Portal unterstützt, müssen Sie eine Runtimeversion auswählen, die das In-Process-Modell unterstützt.
    C#-Klassenbibliotheksfunktionen und Java-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.
  5. Übernehmen Sie auf den übrigen Registerkarten die Standardoptionen – einschließlich der standardmäßigen Erstellung eines neuen Speicherkontos auf der Registerkarte Speicher und einer neuen Application Insight-Instanz auf der Registerkarte Überwachung. Sie können auch ein bereits vorhandenes Speicherkonto oder eine bereits vorhandene Application Insights-Instanz verwenden.

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

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

  8. 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

Sie haben Ihre neue Funktions-App erfolgreich erstellt. Erstellen Sie als Nächstes eine Funktion in der neuen Funktions-App.

Erstellen einer Funktion, die durch Azure Blob Storage ausgelöst wird

  1. Wählen Sie in Ihrer Funktions-App Übersicht und dann unter Funktionen die Option + Erstellen aus.

  2. Wählen Sie unter Vorlage auswählen die Vorlage Blobtrigger und dann Weiter aus.

  3. Konfigurieren Sie unter Vorlagendetails den neuen Trigger mit den Einstellungen aus der folgenden Tabelle, und wählen Sie anschließend Erstellen aus:

    Einstellung Vorgeschlagener Wert Beschreibung
    Auftragstyp An App anfügen Diese Einstellung wird nur für Python v2-Apps angezeigt.
    Neue Funktion Eindeutig in Ihrer Funktions-App Der Name dieser durch Blobs ausgelösten Funktion.
    Pfad samples-workitems/{name} Der Speicherort in Blob Storage, der überwacht wird. Der Dateiname des Blobs wird in der Bindung als Parameter name übergeben.
    Speicherkontoverbindung AzureWebJobsStorage Sie können die Speicherkontoverbindung verwenden, die bereits von Ihrer Funktions-App verwendet wird, oder eine neue erstellen.

    Azure erstellt die durch Blob Storage ausgelöste Funktion basierend auf den bereitgestellten Werten. Erstellen Sie nun den samples-workitems-Container.

Erstellen des Containers

  1. Kehren Sie zur Seite Übersicht Ihrer Funktions-App zurück, wählen Sie Ihre Ressourcengruppe aus, suchen Sie das Speicherkonto in Ihrer Ressourcengruppe, und wählen Sie es aus.

  2. Wählen Sie auf der Seite des Speicherkontos Datenspeicher>Container>+ Container aus.

  3. Geben Sie im Feld Name den Namen samples-workitems ein, und wählen Sie dann Erstellen aus, um den Container zu erstellen.

  4. Wählen Sie den neuen Container samples-workitems aus, und testen Sie die Funktion durch Hochladen einer Datei in den Container.

Testen der Funktion

  1. Kehren Sie in einem neuen Browserfenster zur Seite Ihrer Funktions-App zurück, und wählen Sie Protokolldatenstrom aus. Hier wird die Echtzeitprotokollierung für Ihre App anzeigt.

  2. Wählen Sie auf der Seite des Containers samples-workitems die Option Hochladen>Nach Dateien suchen aus, navigieren Sie zu einer Datei auf Ihrem lokalen Computer (z. B. einer Bilddatei), und wählen Sie diese aus.

  3. Klicken Sie auf Öffnen und dann auf Hochladen.

  4. Kehren Sie zu den Funktions-App-Protokollen zurück, und überprüfen Sie, ob das Blob gelesen wurde.

    Hinweis

    Wenn Ihre Funktions-App im Standardverbrauchsplan ausgeführt wird, kann es zwischen dem Hinzufügen oder Aktualisieren des Blobs und dem Auslösen der Funktion zu einer Verzögerung von mehreren Minuten kommen. Wenn Sie in Ihren ausgelösten Blob-Funktionen geringe Latenz benötigen, ziehen Sie über eine der folgenden anderen Blobtriggeroptionen in Betracht.

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 eine Funktion erstellt, die ausgeführt wird, wenn ein Blob in Blob Storage hinzugefügt oder aktualisiert wird. Weitere Informationen zu Blob Storage-Triggern finden Sie unter Azure Functions – Blob Storage-Bindungen.

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