Übung – Erstellen einer HTTP-Trigger-Funktion

  • 7 Minuten

Dieses geführte Projekt besteht aus den folgenden Übungen:

  • Erstellen der Funktions-App
  • Bereitstellen einer HTTP-Trigger-Funktion
  • Testendpunkt und Überprüfungsprotokolle

In dieser Übung verwenden Sie Cloud Shell, um ein Funktionsprojekt mit einem HTTP-Trigger zu erstellen und es in Ihrer Funktions-App bereitzustellen. Dadurch erhalten Sie einen Live-HTTP-Endpunkt, den jeder über einen Browser aufrufen kann.

Diese Übung umfasst die folgenden Aufgaben:

  • Cloud Shell öffnen
  • Erstellen des Funktionsprojekts
  • Bereitstellen der Funktion in Azure

Ergebnis: Ein aufrufbarer HTTP-Endpunkt, der in Ihrer Funktions-App mit Cloud Shell bereitgestellt wird.

Aufgabe 1: Öffnen der Cloud Shell

Starten Sie Azure Cloud Shell, damit Sie die Befehlszeile verwenden können, um eine Funktion zu erstellen und bereitzustellen.

  1. Wählen Sie im Azure-Portal das Cloud Shell-Symbol in der oberen Symbolleiste aus (sie sieht wie eine Eingabeaufforderung >_) aus.
  2. Wenn Sie aufgefordert werden, Bash oder PowerShell auszuwählen, wählen Sie Bash aus. Wenn Cloud Shell ohne Aufforderung geöffnet wird, sehen Sie in der oberen linken Ecke des Cloud Shell-Bereichs nach. Wenn eine Schaltfläche "Zu Bash wechseln " angezeigt wird, wählen Sie sie aus. Wenn " Zu PowerShell wechseln" angezeigt wird, befinden Sie sich bereits in Bash. Es kann eine Minute dauern, bis Cloud Shell initialisiert wird.
  3. Wenn Sie aufgefordert werden, Speicher zu erstellen, wählen Sie "Speicher erstellen" aus, und warten Sie, bis Cloud Shell initialisiert wird.
  4. Bestätigen Sie, dass unten im Portal eine Bash-Eingabeaufforderung angezeigt wird.

Hinweis

Überprüfungsschritt: Vergewissern Sie sich, dass das Cloud Shell-Terminal geöffnet ist, und zeigt eine $ Eingabeaufforderung an.

Vorgang 2: Erstellen des Funktionsprojekts

Verwenden Sie die Azure Functions Core Tools in Cloud Shell, um ein Gerüst für ein neues Funktionsprojekt mit einem HTTP-Trigger zu erstellen.

  1. Führen Sie an der Cloud Shell-Eingabeaufforderung den folgenden Befehl aus, um einen neuen Funktionsprojektordner zu erstellen und darin zu wechseln:

    mkdir func-gp-endpoint && cd func-gp-endpoint

  2. Führen Sie den folgenden Befehl aus, um ein neues Functions-Projekt mithilfe der Node.js Laufzeit zu initialisieren. Dies kann eine Minute dauern, bis die erforderlichen Pakete installiert werden.

    func init --worker-runtime node --language javascript --model V4

  3. Führen Sie den folgenden Befehl aus, um eine HTTP-ausgelöste Funktion namens "GetStatus" hinzuzufügen:

    func new --name GetStatus --template "HTTP trigger" --authlevel anonymous

    Hinweis

    Das --authlevel anonymous Kennzeichen bedeutet, dass jede Person mit der URL diese Funktion aufrufen kann, ohne einen Schlüssel bereitzustellen oder sich anzumelden. Dies ist nützlich für Tests, sollte jedoch nicht für Produktionsendpunkte verwendet werden, die vertrauliche Daten behandeln.

  4. Bestätigen Sie, dass die Ausgabe zeigt, dass die Funktion durch einen Lauf erstellt wurde:

    ls src/functions/

    Es sollte eine Datei mit dem Namen GetStatus.jsangezeigt werden.

Hinweis

Überprüfungsschritt: Bestätigen Sie , dassGetStatus.js im src/functions/ Verzeichnis angezeigt wird.

Aufgabe 3: Bereitstellen der Funktion in Azure

Veröffentlichen Sie das Funktionsprojekt in der Funktions-App, die Sie in der vorherigen Übung erstellt haben.

  1. Führen Sie den folgenden Befehl aus, um ihren Funktions-App-Namen nachzuschlagen und in einer Variablen zu speichern:

    FUNC_APP_NAME=$(az functionapp list --resource-group rg-gp-functions-endpoint --query "[0].name" -o tsv)
echo $FUNC_APP_NAME

    Vergewissern Sie sich, dass die Ausgabe den Funktions-App-Namen anzeigt, den Sie in der vorherigen Übung erstellt haben.

  2. Führen Sie den folgenden Befehl aus, um das Funktionsprojekt in Ihrer Funktions-App zu veröffentlichen:

    func azure functionapp publish $FUNC_APP_NAME

  3. Warten Sie, bis die Bereitstellung abgeschlossen ist. Die Ausgabe zeigt die öffentliche URL der Funktion an, die wie folgt aussieht:

    Functions in <your-function-app-name>:
    GetStatus - [httpTrigger]
        Invoke url: https://<your-function-app-name>.azurewebsites.net/api/getstatus

  4. Kopieren Sie die Aufruf-URL aus der Ausgabe. Sie verwenden diese URL in der nächsten Übung, um die Funktion zu testen.

Hinweis

Überprüfungsschritt: Bestätigen Sie, dass die Bereitstellungsausgabe die GetStatus-Funktion mit einer Invoke-URL anzeigt.