Utveckla Azure Functions med hjälp av Visual Studio Code

Med [Azure Functions för Visual Studio Code] kan du lokalt utveckla funktioner och distribuera dem till Azure. Om den här upplevelsen är din första med Azure Functions kan du lära dig mer i En introduktion till Azure Functions.

Tillägget Azure Functions ger följande fördelar:

• Redigera, skapa och kör funktioner på din lokala utvecklingsdator.
• Publicera ditt Azure Functions-projekt direkt till Azure.
• Skriv dina funktioner på olika språk samtidigt som du drar nytta av fördelarna med Visual Studio Code.

Tillägget kan användas med följande språk, som stöds av den Azure Functions som börjar med version 2.x:

• C#-kompilerad
• C#-skript^*
• JavaScript
• Java
• PowerShell
• Python

^*Kräver att du anger C#-skript som standardprojektspråk.

I den här artikeln är exempel för närvarande endast tillgängliga för javaScript-funktioner (Node.js) och C#-klassbibliotek.

Den här artikeln innehåller information om hur du använder Azure Functions för att utveckla funktioner och publicera dem till Azure. Innan du läser den här artikeln bör du skapa din första funktion med hjälp av Visual Studio Code.

Förutsättningar

Innan du installerar och kör [Azure Functions-tillägget][Azure Functions för Visual Studio Code]måste du uppfylla följande krav:

• Visual Studio Code installerat på någon av plattformarna som stöds.

• En aktiv Azure-prenumeration.

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

Andra resurser som du behöver, till exempel ett Azure Storage-konto, skapas i din prenumeration när du publicerar med hjälp av Visual Studio Code.

Köra lokala krav

Dessa krav krävs bara för att köra och felsöka dina funktioner lokalt. De behöver inte skapa eller publicera projekt till Azure Functions.

Installera Azure Functions-tillägget

Du kan använda tillägget Azure Functions för att skapa och testa funktioner och distribuera dem till Azure.

1. Öppna tillägg och Sök efter Azure Functions i Visual Studio Code eller Välj den här länken i Visual Studio Code: vscode:extension/ms-azuretools.vscode-azurefunctions .

2. Välj Installera för att installera tillägget för Visual Studio Code:

   

3. Efter installationen väljer du Azure-ikonen i aktivitets fältet. Ett Azure Functions-område bör visas i sidofältet.

   

Skapa ett Azure Functions-projekt

Med Functions-tillägget kan du skapa ett funktionsappsprojekt tillsammans med din första funktion. Följande steg visar hur du skapar en HTTP-utlöst funktion i ett nytt Functions-projekt. HTTP-utlösare är den enklaste mallen för funktionsutlösare att demonstrera.

1. Från Azure: Funktioner väljer du ikonen Skapa funktion:

   

2. Välj mappen för funktionsappsprojektet och välj sedan ett språk för funktionsprojektet.

3. Välj mallen HTTP-utlösarfunktion, eller så kan du välja Hoppa över för tillfället för att skapa ett projekt utan en funktion. Du kan alltid lägga till en funktion i projektet senare.

   

4. Skriv HttpExample som funktionsnamn och välj Retur. Välj sedan Funktionsauktorisering. Den här auktoriseringsnivån kräver att du anger en funktionsnyckel när du anropar funktionsslutpunkten.

   

   En funktion skapas på det valda språket och i mallen för en HTTP-utlöst funktion.

   

Genererade projektfiler

Projektmallen skapar ett projekt på det språk du valt och installerar nödvändiga beroenden. Det nya projektet har följande filer för alla språk:

• host.jspå: Låter dig konfigurera Functions-värden. De här inställningarna gäller när du kör funktioner lokalt och när du kör dem i Azure. Mer information finns i host.jspå referensen.

• local.settings.jspå: Underhåller de inställningar som används när du kör funktioner lokalt. De här inställningarna används bara när du kör funktioner lokalt. Mer information finns i Filen Med lokala inställningar.

  Viktigt

  Eftersom filen local.settings.jskan innehålla hemligheter måste du undanta den från din projektkällkontroll.

Beroende på vilket språk du använder skapas de här andra filerna:

Nu kan du lägga till indata- och utdatabindningar i funktionen. Du kan också lägga till en ny funktion i projektet.

Installera bindningstillägg

Förutom HTTP- och timerutlösare implementeras bindningar i tilläggspaket. Du måste installera tilläggspaketen för de utlösare och bindningar som behöver dem. Processen för att installera bindningstillägg beror på projektets språk.

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage --version 3.0.4

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    }
}

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    }
}

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    }
}

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    }
}

Lägga till en funktion i projektet

Du kan lägga till en ny funktion i ett befintligt projekt med hjälp av någon av de fördefinierade functions-utlösarmallarna. Om du vill lägga till en ny funktionsutlösare väljer du F1 för att öppna kommandopaletten och söker sedan efter och kör kommandot Azure Functions: Skapa funktion. Följ anvisningarna för att välja utlösartyp och definiera de attribut som krävs för utlösaren. Om utlösaren kräver en åtkomstnyckel eller anslutningssträng för att ansluta till en tjänst kan du förbereda den innan du skapar funktionsutlösaren.

Resultatet av den här åtgärden beror på projektets språk:

Ansluta till tjänster

Du kan ansluta din funktion till andra Azure-tjänster genom att lägga till indata- och utdatabindningar. Bindningar ansluter din funktion till andra tjänster utan att du behöver skriva anslutningskoden. Processen för att lägga till bindningar beror på projektets språk. Mer information om bindningar finns i Azure Functions utlösare och bindningar.

Följande exempel ansluter till en lagringskö med namnet , där anslutningssträngen för lagringskontot anges i programinställningen outqueue MyStorageConnection i local.settings.jspå.

[Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg,

// Add a message to the output collection.
msg.Add(string.Format("Name passed to the function: {0}", name));

@QueueOutput(name = "msg", queueName = "outqueue", 
connection = "AzureWebJobsStorage") OutputBinding<String> msg,

// Write the name to the message queue. 
msg.setValue(name);

{
    "type": "queue",
    "direction": "out",
    "name": "msg",
    "queueName": "outqueue",
    "connection": "MyStorageConnection"
}

// Add a message to the Storage queue,
// which is the name passed to the function.
context.bindings.msg = (req.query.name || req.body.name);

{
    "type": "queue",
    "direction": "out",
    "name": "msg",
    "queueName": "outqueue",
    "connection": "MyStorageConnection"
}

$outputMsg = $name
Push-OutputBinding -name msg -Value $outputMsg

{
    "type": "queue",
    "direction": "out",
    "name": "msg",
    "queueName": "outqueue",
    "connection": "MyStorageConnection"
}

def main(req: func.HttpRequest, msg: func.Out[func.QueueMessage]) -> str:

msg.set(name)

Logga in på Azure

Innan du kan publicera appen måste du logga in på Azure.

1. Om du inte redan är inloggad väljer du Azure-ikonen i aktivitets fältet och väljer sedan Logga in på Azure i avsnittet Azure: Functions . Om du inte redan har en, kan du skapa ett kostnads fritt Azure-konto. Studenter kan skapa ett kostnads fritt Azure-konto för studenter.

   

   Om du redan är inloggad går du till nästa avsnitt.

2. När du uppmanas till webbläsaren väljer du ditt Azure-konto och loggar in med dina autentiseringsuppgifter för Azure-kontot.

3. När du har loggat in kan du stänga det nya webbläsarfönstret. De prenumerationer som tillhör ditt Azure-konto visas i sido fältet.

Publicera till Azure

Visual Studio Med kod kan du publicera Functions-projektet direkt till Azure. Samtidigt skapar du en funktionsapp och relaterade resurser i Azure-prenumerationen. Funktionsappen är ett körningssammanhang för dina funktioner. Projektet paketeras och distribueras till den nya funktionsappen i Azure-prenumerationen.

När du publicerar från Visual Studio Code till en ny funktionsapp i Azure kan du välja antingen en sökväg för att skapa en snabbfunktionsapp med hjälp av standardvärden eller en avancerad sökväg, där du får mer kontroll över de fjärrresurser som skapats.

När du publicerar från Visual Studio Code kan du dra nytta av zip-distributionstekniken.

Snabbfunktionsapp – skapa

När du väljer + Skapa ny funktionsapp i Azure... genererar tillägget automatiskt värden för de Azure-resurser som krävs av funktionsappen. Dessa värden baseras på funktionsappens namn som du väljer. Ett exempel på hur du använder standardvärden för att publicera projektet till en ny funktionsapp i Azure finns i snabbstartsartikeln för Visual Studio Code.

Om du vill ange explicita namn för de skapade resurserna måste du välja den avancerade sökvägen för att skapa.

Publicera ett projekt till en ny funktionsapp i Azure med hjälp av avancerade alternativ

Följande steg publicerar projektet till en ny funktionsapp som skapats med avancerade alternativ för att skapa:

1. I kommandopaletten anger du Azure Functions: Distribuera till funktionsappen.

2. Om du inte är inloggad uppmanas du att logga in på Azure. Du kan också skapa ett kostnadsfritt Azure-konto. När du har loggat in från webbläsaren går du tillbaka till Visual Studio Code.

3. Om du har flera prenumerationer väljer du en prenumeration för funktionsappen och sedan + Skapa ny funktionsapp i Azure... Avancerat. Med det här alternativet Avancerat får du mer kontroll över de resurser som du skapar i Azure.

4. Ange följande information genom att följa anvisningarna:

   Prompt	Värde	Beskrivning
   Välj funktionsapp i Azure	Skapa ny funktionsapp i Azure	I nästa uppmaning skriver du ett globalt unikt namn som identifierar den nya funktionsappen och väljer sedan Retur. Giltiga tecken i ett namn på en funktionsapp är a-z, 0-9 och -.
   Välj ett operativsystem	Windows	Funktionsappen körs på Windows.
   Välj en värdplan	Förbrukningsplan	En värd för en serverlös förbrukningsplan används.
   Välj en körningsapp för den nya appen	Ditt projektspråk	Körningen måste matcha projektet som du publicerar.
   Välj en resursgrupp för nya resurser	Skapa ny resursgrupp	I nästa fråga skriver du ett resursgruppsnamn, till myResourceGroup exempel , och väljer sedan Retur. Du kan också välja en befintlig resursgrupp.
   Välj ett lagringskonto	Skapa ett nytt lagringskonto	Vid nästa uppmaning anger du ett globalt unikt namn för det nya lagringskontot som används av funktionsappen och väljer sedan Retur. Storage måste vara mellan 3 och 24 tecken långa och får bara innehålla siffror och gemener. Du kan också välja ett befintligt konto.
   Välj en plats för nya resurser	region	Välj en plats i en region nära dig eller nära andra tjänster som dina funktioner har åtkomst till.

   Ett meddelande visas när funktionsappen har skapats och distributionspaketet har tillämpats. Välj Visa utdata i det här meddelandet för att visa skapande- och distributionsresultat, inklusive de Azure-resurser som du skapade.

Hämta URL:en för en HTTP-utlöst funktion i Azure

Om du vill anropa en HTTP-utlöst funktion från en klient behöver du url:en för funktionen när den distribueras till funktionsappen. Den här URL:en innehåller alla nödvändiga funktionsnycklar. Du kan använda tillägget för att hämta dessa URL:er för dina distribuerade funktioner. Om du bara vill köra fjärrfunktionen i Azure använder du funktionen Kör nu i tillägget.

1. Välj F1 för att öppna kommandopaletten och sök sedan efter och kör kommandot Azure Functions: Kopiera funktions-URL.

2. Följ anvisningarna för att välja din funktionsapp i Azure och sedan den specifika HTTP-utlösare som du vill anropa.

Funktions-URL:en kopieras till Urklipp, tillsammans med alla nödvändiga nycklar som skickas av code frågeparametern. Använd ett HTTP-verktyg för att skicka POST-begäranden eller en webbläsare för GET-begäranden till fjärrfunktionen.

När du hämtar URL:en för funktioner i Azure använder tillägget ditt Azure-konto för att automatiskt hämta de nycklar som behövs för att starta funktionen. Läs mer om åtkomstnycklar för funktioner. För att starta icke-HTTP-utlösta funktioner måste du använda administratörsnyckeln.

Publicera om projektfiler

När du ställer in kontinuerlig distributionuppdateras funktionsappen i Azure när du uppdaterar källfilerna på den anslutna källplatsen. Vi rekommenderar kontinuerlig distribution, men du kan även publicera om dina projektfiluppdateringar från Visual Studio Code.

1. I Visual Studio Code väljer du F1 för att öppna kommando paletten. I paletten kommando söker du efter och väljer Azure Functions: distribuera till Function-appen.

2. Om du inte är inloggad uppmanas du att Logga in på Azure. När du har loggat in från webbläsaren går du tillbaka till Visual Studio Code. Om du har flera prenumerationer väljer du en prenumeration som innehåller din Function-app.

3. Välj din befintliga Function-app i Azure. När du varnas om att skriva över alla filer i Function-appen väljer du distribuera för att bekräfta varningen och fortsätta.

Projektet har återskapats, paketerats om och laddats upp till Azure. Det befintliga projektet ersätts av det nya paketet och Function-appen startas om.

Kör funktioner

Med Azure Functions kan du köra enskilda funktioner, antingen i projektet på din lokala utvecklingsdator eller i din Azure-prenumeration.

För HTTP-utlösarfunktioner anropar tillägget HTTP-slutpunkten. För andra typer av utlösare anropas administratörs-API:er för att starta funktionen. Meddelandetexten i begäran som skickas till funktionen beror på typen av utlösare. När en utlösare kräver testdata uppmanas du att ange data i ett specifikt JSON-format.

Köra funktioner i Azure

Köra en funktion i Azure från Visual Studio Code.

1. På kommandopaletten anger du Azure Functions: Execute function now (Kör funktion nu) och väljer din Azure-prenumeration.

2. Välj din funktionsapp i Azure i listan. Om du inte ser funktionsappen kontrollerar du att du är inloggad på rätt prenumeration.

3. Välj den funktion som du vill köra i listan och skriv meddelandetexten i begäran i Ange begärandetexten. Tryck på Retur för att skicka det här begärandemeddelandet till din funktion. Standardtexten i Enter-begärandetexten ska ange formatet för brödtexten. Om funktionsappen inte har några funktioner visas ett meddelandefel med det här felet.

4. När funktionen körs i Azure och returnerar ett svar utlöses ett meddelande i Visual Studio Code.

Du kan också köra funktionen från området Azure: Functions genom att högerklicka (Ctrl-klicka på Mac) på den funktion som du vill köra från funktionsappen i din Azure-prenumeration och välja Kör funktion nu....

När du kör funktioner i Azure använder tillägget ditt Azure-konto för att automatiskt hämta de nycklar som behövs för att starta funktionen. Läs mer om åtkomstnycklar för funktioner. För att starta icke-HTTP-utlösta funktioner måste du använda administratörsnyckeln.

Köra funktioner lokalt

Den lokala körningen är samma körning som är värd för funktionsappen i Azure. Lokala inställningar läses från local.settings.jspå filen. Om du vill köra Functions-projektet lokalt måste du uppfylla ytterligare krav.

Konfigurera projektet att köras lokalt

Functions-körningen använder ett Azure Storage internt för alla utlösartyper förutom HTTP och webhooks. Därför måste du ange nyckeln Values.AzureWebJobsStorage till en giltig Azure Storage-kontoanslutningssträng.

Det här avsnittet använder Azure Storage för Visual Studio Code med Azure Storage Explorer för att ansluta till och hämta lagringsanslutningssträngen.

Så här anger du anslutningssträngen för lagringskontot:

1. I Visual Studio du Cloud Explorer, expanderar Storage Konto ditt Storage konto och väljer egenskaper och kopierar värdet > för Primär anslutningssträng.

2. I projektet öppnar du filen local.settings.jsoch anger värdet för nyckeln AzureWebJobsStorage till den anslutningssträng som du kopierade.

3. Upprepa föregående steg för att lägga till unika nycklar i matrisen Värden för alla andra anslutningar som krävs av dina funktioner.

Mer information finns i Filen med lokala inställningar.

Felsöka funktioner lokalt

Om du vill felsöka dina funktioner väljer du F5. Om du inte redan har hämtat Core Toolsuppmanas du att göra det. När Core Tools har installerats och körs visas utdata i Terminal. Det här är samma sak som att func host start köra Core Tools-kommandot från Terminal, men med extra bygguppgifter och ett anslutet felsökningsverktyg.

När projektet körs kan du använda funktionen Kör funktion nu... i tillägget för att utlösa dina funktioner på samma sätt som när projektet distribueras till Azure. När projektet körs i felsökningsläge kommer brytpunkter till i Visual Studio Code som förväntat.

1. På kommandopaletten anger du Azure Functions: Execute function now (Kör funktion nu) och väljer Local project ( Lokalt projekt).

2. Välj den funktion som du vill köra i projektet och skriv meddelandetexten i begäran i Ange begärandetexten. Tryck på Retur för att skicka det här begärandemeddelandet till din funktion. Standardtexten i Enter-begärandetexten ska ange formatet för brödtexten. Om funktionsappen inte har några funktioner visas ett meddelandefel med det här felet.

3. När funktionen körs lokalt och när svaret har tagits emot utlöses ett meddelande i Visual Studio Code. Information om funktionskörningen visas i terminalpanelen.

Att köra funktioner lokalt kräver inte att nycklar används.

Lokala inställningar

När du kör i en funktionsapp i Azure lagras de inställningar som krävs av dina funktioner på ett säkert sätt i appinställningarna. Under lokal utveckling läggs de här inställningarna i stället till Values i objektet i local.settings.jspå filen. I local.settings.jspå filen lagras även inställningar som används av lokala utvecklingsverktyg.

Eftersom local.settings.jspå kan innehålla hemligheter, till exempel anslutningssträngar, bör du aldrig lagra den på en fjärrlagringsplats. Mer information om lokala inställningar finns i Filen Med lokala inställningar.

Som standard migreras inte de här inställningarna automatiskt när projektet publiceras till Azure. När publiceringen är klar kan du välja att publicera inställningar från local.settings.jstill funktionsappen i Azure. Mer information finns i Publicera programinställningar.

Värden i ConnectionStrings publiceras aldrig.

Funktionsprogrammets inställningsvärden kan också läsas i koden som miljövariabler. Mer information finns i avsnitten miljövariabler i dessa språkspecifika referensartiklar:

• Förkompilerad C#
• C#-skript (.csx)
• Java
• JavaScript
• PowerShell
• Python

Programinställningar i Azure

Inställningarna i filen local.settings.jsi projektet ska vara samma som programinställningarna i funktionsappen i Azure. Alla inställningar som du lägger local.settings.jspå måste du också lägga till i funktionsappen i Azure. De här inställningarna laddas inte upp automatiskt när du publicerar projektet. På samma sätt måste alla inställningar som du skapar i funktionsappen i portalen laddas ned till ditt lokala projekt.

Publicera programinställningar

Det enklaste sättet att publicera de inställningar som krävs i din funktionsapp i Azure är att använda länken Upload inställningar som visas när du har publicerat projektet:

Du kan också publicera inställningar med hjälp av Azure Functions: Upload lokala inställningen i kommandopaletten. Du kan lägga till enskilda inställningar i programinställningarna i Azure med hjälp av kommandot Azure Functions: Lägg till ny inställning.

Om den lokala filen krypteras dekrypteras den, publiceras och krypteras igen. Om det finns inställningar som har motstridiga värden på de två platserna uppmanas du att välja hur du vill fortsätta.

Visa befintliga appinställningar i området Azure: Funktioner genom att expandera din prenumeration, din funktionsapp och Application Inställningar.

Ladda ned inställningar från Azure

Om du har skapat programinställningar i Azure kan du ladda ned dem till din local.settings.json-fil med hjälp av kommandot Azure Functions: Download Remote Inställningar .

Precis som vid uppladdning dekrypteras, uppdateras och krypteras den igen om den lokala filen är krypterad. Om det finns inställningar som har motstridiga värden på de två platserna uppmanas du att välja hur du vill fortsätta.

Övervakningsfunktioner

När du kör funktioner lokaltströmmas loggdata till terminalkonsolen. Du kan också hämta loggdata när functions-projektet körs i en funktionsapp i Azure. Du kan antingen ansluta till strömmande loggar i Azure för att se loggdata nästan i realtid, eller så kan du aktivera Application Insights för en mer fullständig förståelse av hur funktionsappen beter sig.

Direktuppspelningsloggar

När du utvecklar ett program är det ofta användbart att se loggningsinformation i nära realtid. Du kan visa en dataström med loggfiler som genereras av dina funktioner. Dessa utdata är ett exempel på strömningsloggar för en begäran till en HTTP-utlöst funktion:

Mer information finns i Strömmande loggar.

Så här aktiverar du strömmande loggar för din Function-app i Azure:

1. Välj F1 för att öppna kommando-paletten och Sök sedan efter och kör kommandot Azure Functions: starta strömmande loggar.

2. Välj din Function-app i Azure och välj sedan Ja för att aktivera program loggning för Function-appen.

3. Utlös dina funktioner i Azure. Observera att loggdata visas i fönstret utdata i Visual Studio Code.

4. Kom ihåg att köra kommandot Azure Functions när du är klar : stoppa strömmande loggar för att inaktivera loggning för Function-appen.

Application Insights

Vi rekommenderar att du övervakar körningen av dina funktioner genom att integrera funktionsappen med Application Insights. När du skapar en funktionsapp i Azure Portal sker den här integreringen som standard. När du skapar funktionsappen under Visual Studio publicering måste du integrera Application Insights själv. Mer information finns i Aktivera Application Insights-integrering.

Mer information om övervakning med application Insights finns i Övervaka Azure Functions.

#C-skriptprojekt

Som standard skapas alla C#-projekt som C#-kompilerade klassbiblioteksprojekt. Om du föredrar att arbeta med C#-skriptprojekt i stället måste du välja C#-skript som standardspråk i Azure Functions för tillägg:

1. Välj > Filinställningar > Inställningar.

2. Gå till User Inställningar > Extensions > Azure Functions.

3. Välj C#Script från Azure Function: Project Language.

När du har slutfört de här stegen innehåller anrop till de underliggande Core Tools alternativet som genererar och publicerar --csx C#-skriptfiler (.csx). När du har angett det här standardspråket kommer alla projekt som du skapar som standard att ha C#-skriptprojekt. Du uppmanas inte att välja ett projektspråk när en standardinställning har angetts. Om du vill skapa projekt på andra språk måste du ändra den här inställningen eller ta bort den från settings.jspå filen. När du har tagit bort den här inställningen uppmanas du återigen att välja språk när du skapar ett projekt.

Referens för kommandopalett

Tillägget Azure Functions ger ett användbart grafiskt gränssnitt i området för att interagera med dina funktionsappar i Azure. Samma funktioner är också tillgängliga som kommandon i kommandopaletten (F1). De Azure Functions kommandona är tillgängliga:

Nästa steg

Mer information om Azure Functions Core Tools finns i Arbeta med Azure Functions Core Tools.

Mer information om hur du utvecklar funktioner som .NET-klassbibliotek finns i Azure Functions C#-utvecklarreferens. Den här artikeln innehåller också länkar till exempel på hur du använder attribut för att deklarera olika typer av bindningar som stöds av Azure Functions.