Skapa en funktion som utlöses av Azure Queue Storage

Läs hur du skapar en funktion som utlöses när meddelanden skickas till en Azure Storage-kö.

Kommentar

Redigering i portalen stöds endast för JavaScript-, PowerShell- och C#-skriptfunktioner. Python-redigering i portalen stöds endast när den körs i förbrukningsplanen. När det är möjligt bör du utveckla dina funktioner lokalt.

Mer information om begränsningarna för redigering av funktionskod i Azure-portalen finns i Utvecklingsbegränsningar i Azure-portalen.

Förutsättningar

Skapa en Azure Functions-app

  1. I menyn i Azure-portalen eller på sidan Start väljer du Skapa en resurs.

  2. På sidan Nytt väljer du Beräkningsfunktionsapp>.

  3. Under Välj ett värdalternativ väljer du Förbrukning>Välj för att skapa din app i standardförbrukningsplanen. I det här serverlösa värdalternativet betalar du bara för den tid som dina funktioner körs. Premium-planen erbjuder även dynamisk skalning. När du använder en App Service-plan måste du hantera funktionsappens skalning.

  4. På sidan Grundläggande använder du inställningarna för funktionsappen enligt beskrivningen i följande tabell:

    Inställning Föreslaget värde beskrivning
    Abonnemang Din prenumeration Prenumerationen där du skapar din nya funktionsapp.
    Resursgrupp myResourceGroup Namn på den nya resursgrupp där du skapar funktionsappen. Du bör skapa en ny resursgrupp eftersom det finns kända begränsningar när du skapar nya funktionsappar i en befintlig resursgrupp.
    Funktionsappens namn Globalt unikt namn Namn som identifierar din nya funktionsapp. Giltiga tecken är a-z (skiftlägesokänsligt), 0-9 och -.
    Körningsstack Önskat språk Välj en körning som stöder det funktionsprogrammeringsspråk som du föredrar. Redigering i portalen är endast tillgängligt för JavaScript-, PowerShell-, Python-, TypeScript- och C#-skript. C#-klassbibliotek och Java-funktioner måste utvecklas lokalt.
    Version: Versionsnummer Välj den version av din installerade körning.
    Region Önskad region Välj en region som är nära dig eller nära andra tjänster som dina funktioner kan komma åt.
    Operativsystem Windows Ett operativsystem är förvalt baserat på val av körningsstack, men du kan ändra inställningen om det behövs. Redigering i portalen stöds endast i Windows.
  5. Acceptera standardalternativen på de återstående flikarna, inklusive standardbeteendet för att skapa ett nytt lagringskonto på fliken Lagring och en ny Application Insight-instans på fliken Övervakning . Du kan också välja att använda ett befintligt lagringskonto eller En Application Insights-instans.

  6. Välj Granska + skapa för att granska appkonfigurationen du valde och välj sedan Skapa för att etablera och distribuera funktionsappen.

  7. Välj ikonen Meddelanden i det övre högra hörnet i portalen och håll utkik efter meddelandet Distributionen lyckades.

  8. Välj Gå till resurs för att se den nya funktionsappen. Du kan också välja Fäst på instrumentpanelen. Med fästning blir det enklare att återgå till den här funktionsappresursen från instrumentpanelen.

    Skärmbild av distributionsmeddelande.

Funktionsappen har skapats..

Därefter skapar du en funktion i den nya funktionsappen.

Skapa en funktion som utlöses av en kö

  1. I funktionsappen väljer du Översikt och sedan + Skapa under Funktioner.

  2. Under Välj en mall rullar du nedåt och väljer utlösarmallen Azure Queue Storage.

  3. I Mallinformation konfigurerar du den nya utlösaren med de inställningar som anges i den här tabellen och väljer sedan Skapa:

    Inställning Föreslaget värde Description
    Namn Ett unikt namn i funktionsappen Namnge funktionen som utlöses av kön.
    Könamn myqueue-items Namnet på den kö som ska anslutas till i ditt Storage-konto.
    Lagringskontoanslutning AzureWebJobsStorage Du kan antingen använda den lagringskontoanslutning som redan används i funktionsappen eller skapa en ny.

    Azure skapar funktionen Queue Storage som utlöses baserat på de angivna värdena

Därefter ansluter du till ditt Azure-lagringskonto och skapar lagringskön myqueue-items .

Skapa kön

  1. I funktionen går du till sidan Översikt och väljer din resursgrupp.

    Välj resursgruppen i Azure-portalen.

  2. Leta upp och välj resursgruppens lagringskonto.

    Få åtkomst till lagringskontot.

  3. Välj Köer och välj sedan + Kö.

    Lägg till en kö till ditt lagringskonto i Azure-portalen.

  4. I fältet Namn skriver du myqueue-itemsoch väljer sedan Skapa.

    Namnge kölagringscontainern.

Nu när du har en lagringskö kan du testa funktionen genom att lägga till ett meddelande i kön.

Testa funktionen

  1. Gå till Azure Portal igen, bläddra till din funktion, expandera Loggar längst ned på sidan och se till att loggströmningen inte är pausad.

    Expandera loggen i Azure-portalen.

  2. I ett separat webbläsarfönster går du till resursgruppen i Azure-portalen och väljer lagringskontot.

  3. Välj Köer och välj sedan containern myqueue-items .

    Gå till din myqueue-items-kö i Azure-portalen.

  4. Välj Lägg till meddelande och skriv "Hello World!" i Meddelandetext. Välj OK.

    Skärmbild som visar knappen Lägg till meddelande markerad och fältet Meddelandetext markerat.

  5. Vänta några sekunder och gå sedan tillbaka till dina funktionsloggar och kontrollera att det nya meddelandet har lästs från kön.

    Visa meddelande i loggarna.

  6. I lagringskön väljer du Uppdatera och kontrollerar att meddelandet har bearbetats och inte längre finns i kön.

Rensa resurser

De andra snabbstarterna i den här samlingen bygger på den här snabbstarten. Om du planerar att arbeta med efterföljande snabbstarter, självstudier eller med någon av de tjänster som du har skapat i den här snabbstarten ska du inte rensa resurserna.

Resurser i Azure avser funktionsappar, funktioner, lagringskonton och så vidare. De är grupperade i resursgrupper och du kan ta bort allt i en grupp genom att ta bort gruppen.

Du har skapat resurser för att slutföra de här snabbstarterna. Du kan debiteras för dessa resurser, beroende på kontostatus och tjänstpriser. Om du inte behöver resurserna längre så visar vi hur du tar bort dem här:

  1. Gå till sidan Resursgrupp i Azure Portal.

    Om du vill komma till den sidan från funktionsappsidan väljer du fliken Översikt och väljer sedan länken under Resursgrupp.

    Skärmbild som visar hur du väljer den resursgrupp som ska tas bort från funktionsappsidan.

    För att komma till den sidan från instrumentpanelen väljer du Resursgrupper och sedan den resursgrupp som du använde för den här artikeln.

  2. På sidan Resursgrupp granskar du listan över inkluderade resurser och kontrollerar att det är de som du vill ta bort.

  3. Välj Ta bort resursgrupp och följ anvisningarna.

    Borttagningen kan ta några minuter. När du är färdig visas ett meddelande i några sekunder. Du kan även välja klockikonen högst upp på sidan för att se meddelandet.

Nästa steg

Du har skapat en funktion som körs när ett meddelande läggs till i en lagringskö. Mer information om Queue Storage-utlösare finns i Azure Functions Storage queue bindings (Azure Functions-lagringsköbindningar).

Nu när du har skapat din första funktion ska vi lägga till en utdatabindning till funktionen som skriver ett meddelande till en annan kö.