Rychlé zprovoznění: Vytvoření funkce v Azure s využitím Visual Studio CodeQuickstart: Create a function in Azure using Visual Studio Code

V tomto článku použijete Visual Studio Code k vytvoření funkce založené na knihovně jazyka C#, která reaguje na požadavky HTTP.In this article, you use Visual Studio Code to create a C# class library-based function that responds to HTTP requests. Po místním testování kódu ho nasadíte do prostředí Azure Functions bez serveru.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

V tomto článku použijete Visual Studio Code k vytvoření funkce JavaScriptu, která reaguje na požadavky HTTP.In this article, you use Visual Studio Code to create a JavaScript function that responds to HTTP requests. Po místním testování kódu ho nasadíte do prostředí Azure Functions bez serveru.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

V tomto článku použijete Visual Studio Code k vytvoření funkce TypeScript, která reaguje na požadavky HTTP.In this article, you use Visual Studio Code to create a TypeScript function that responds to HTTP requests. Po místním testování kódu ho nasadíte do prostředí Azure Functions bez serveru.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

V tomto článku použijete Visual Studio Code k vytvoření funkce PowerShellu, která reaguje na požadavky HTTP.In this article, you use Visual Studio Code to create a PowerShell function that responds to HTTP requests. Po místním testování kódu ho nasadíte do prostředí Azure Functions bez serveru.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

V tomto článku použijete Visual Studio Code k vytvoření funkce jazyka Python, která reaguje na požadavky HTTP.In this article, you use Visual Studio Code to create a Python function that responds to HTTP requests. Po místním testování kódu ho nasadíte do prostředí Azure Functions bez serveru.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

V tomto článku použijete Visual Studio Code k vytvoření funkce jazyka Java, která reaguje na požadavky HTTP.In this article, you use Visual Studio Code to create a Java function that responds to HTTP requests. Po místním testování kódu ho nasadíte do prostředí Azure Functions bez serveru.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Po dokončení tohoto rychlého startu dojde v účtu Azure k malým nákladům na několik centů nebo méně.Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.

K dispozici je také verze tohoto článku na bázi CLI .There's also a CLI-based version of this article.

Poznámka

Pokud Visual Studio Code nejste preferovaným vývojářským nástrojem, podívejte se na naše podobné kurzy pro vývojáře v jazyce Java, které využívají Maven, GRADLE a IntelliJ nápad.If Visual Studio Code isn't your prefered development tool, check out our similar tutorials for Java developers using Maven, Gradle and IntelliJ IDEA.

Konfigurace prostředíConfigure your environment

Než začnete, ujistěte se, že máte zavedené následující požadavky:Before you get started, make sure you have the following requirements in place:

  • Node.js, LTS a verze LTS údržby (doporučeno 10.14.1).Node.js, Active LTS and Maintenance LTS versions (10.14.1 recommended). Pomocí node --version příkazu ověřte svou verzi.Use the node --version command to check your version.

Vytvořit místní projektCreate your local project

V této části použijete Visual Studio Code k vytvoření místního projektu Azure Functions ve zvoleném jazyce.In this section, you use Visual Studio Code to create a local Azure Functions project in your chosen language. Později v tomto článku publikujete kód funkce do Azure.Later in this article, you'll publish your function code to Azure.

  1. Zvolte ikonu Azure na řádku aktivity a potom v oblasti Azure: funkce vyberte ikonu vytvořit nový projekt... .Choose the Azure icon in the Activity bar, then in the Azure: Functions area, select the Create new project... icon.

    Zvolit vytvořit nový projekt

  2. Zvolte umístění adresáře pro váš pracovní prostor projektu a zvolte možnost vybrat.Choose a directory location for your project workspace and choose Select.

    Poznámka

    Tyto kroky jsou navržené tak, aby se dokončily mimo pracovní prostor.These steps were designed to be completed outside of a workspace. V tomto případě nevybírejte složku projektu, která je součástí pracovního prostoru.In this case, do not select a project folder that is part of a workspace.

  3. Zadejte následující informace na následujících dotazech:Provide the following information at the prompts:

    • Vyberte jazyk pro projekt funkce: zvolte C# .Select a language for your function project: Choose C#.
    • Vyberte jazyk pro projekt funkce: zvolte JavaScript .Select a language for your function project: Choose JavaScript.
    • Vyberte jazyk pro projekt funkce: zvolte TypeScript .Select a language for your function project: Choose TypeScript.
    • Vyberte jazyk pro projekt funkce: zvolte PowerShell .Select a language for your function project: Choose PowerShell.
    • Vyberte jazyk pro projekt funkce: zvolte Python .Select a language for your function project: Choose Python.

    • Vyberte alias Pythonu pro vytvoření virtuálního prostředí: Zvolte umístění překladače Pythonu.Select a Python alias to create a virtual environment: Choose the location of your Python interpreter. Pokud se umístění nezobrazuje, zadejte úplnou cestu k binárnímu souboru Pythonu.If the location isn't shown, type in the full path to your Python binary.

    • Vyberte jazyk pro projekt funkce: zvolte Java .Select a language for your function project: Choose Java.

    • Vyberte verzi Java: zvolte Java 8 nebo Java 11 (preview) , na kterých se budou spouštět vaše funkce v Azure.Select a version of Java: Choose Java 8 or Java 11 (preview), on which your functions run in Azure. Vyberte verzi jazyka Java, kterou jste ověřili místně.Choose a Java version that you've verified locally.

    • Zadejte ID skupiny: vyberte com.function .Provide a group ID: Choose com.function.

    • Zadejte ID artefaktu: vyberte myFunction .Provide an artifact ID: Choose myFunction.

    • Zadejte verzi: vyberte 1.0-SNAPSHOT .Provide a version: Choose 1.0-SNAPSHOT.

    • Zadejte název balíčku: vyberte com.function .Provide a package name: Choose com.function.

    • Zadejte název aplikace: vyberte myFunction-12345 .Provide an app name: Choose myFunction-12345.

    • Vyberte šablonu pro funkci prvního projektu: zvolte HTTP trigger .Select a template for your project's first function: Choose HTTP trigger.

    • Zadejte název funkce: typ HttpExample .Provide a function name: Type HttpExample.

    • Zadejte obor názvů: typ My.Functions .Provide a namespace: Type My.Functions.
    • Úroveň autorizace: vyberte Anonymous , který umožňuje komukoli zavolat koncový bod funkce.Authorization level: Choose Anonymous, which enables anyone to call your function endpoint. Další informace o úrovni autorizace najdete v tématu autorizační klíče.To learn about authorization level, see Authorization keys.
    • Vyberte, jak se má projekt otevřít: zvolte Add to workspace .Select how you would like to open your project: Choose Add to workspace.
  4. Pomocí těchto informací Visual Studio Code generuje Azure Functions projekt pomocí triggeru protokolu HTTP.Using this information, Visual Studio Code generates an Azure Functions project with an HTTP trigger. Můžete zobrazit soubory místních projektů v Průzkumníkovi.You can view the local project files in the Explorer. Další informace o souborech, které jsou vytvořeny, najdete v tématu vygenerované soubory projektu.To learn more about files that are created, see Generated project files.

Místní spuštění funkceRun the function locally

Visual Studio Code se integruje s Azure Functions Core Tools a umožní vám spustit tento projekt na místním vývojovém počítači před publikováním do Azure.Visual Studio Code integrates with Azure Functions Core Tools to let you run this project on your local development computer before you publish to Azure.

  1. Pro volání funkce stiskněte klávesu F5 ke spuštění projektu Function App.To call your function, press F5 to start the function app project. Výstup z nástrojů Tools se zobrazí na panelu Terminál.Output from Core Tools is displayed in the Terminal panel.

  2. Pokud jste ještě nenainstalovali Azure Functions Core Tools, vyberte na příkazovém řádku nainstalovat .If you haven't already installed Azure Functions Core Tools, select Install at the prompt. Po instalaci základních nástrojů se vaše aplikace spustí na panelu terminálu .When the Core Tools are installed, your app starts in the Terminal panel. Koncový bod adresy URL vámi spuštěné funkce aktivované protokolem HTTP se zobrazí v místním prostředí.You can see the URL endpoint of your HTTP-triggered function running locally.

    Místní výstup Azure

  3. Pokud běží základní nástroje, přejděte na následující adresu URL a spusťte požadavek GET, který zahrnuje ?name=Functions řetězec dotazu.With Core Tools running, navigate to the following URL to execute a GET request, which includes ?name=Functions query string.

    http://localhost:7071/api/HttpExample?name=Functions

  4. Vrátí se odpověď, která v prohlížeči vypadá jako v následujících případech:A response is returned, which looks like the following in a browser:

    Odezva místního hostitele funkce v prohlížeči

  5. Informace o žádosti se zobrazí na panelu terminálu .Information about the request is shown in Terminal panel.

    Spuštění funkce na panelu terminálu

  6. Stisknutím kombinace kláves CTRL + C zastavte základní nástroje a odpojte ladicí program.Press Ctrl + C to stop Core Tools and disconnect the debugger.

Místní spuštění funkceRun the function locally

Azure Functions Core Tools se integruje s Visual Studio Code, aby se mohl spustit a ladit Azure Functions projektu místně.Azure Functions Core Tools integrates with Visual Studio Code to let you run and debug an Azure Functions project locally. Podrobnosti o tom, jak ladit v Visual Studio Code, najdete v tématu ladění powershellu Azure Functions místně.For details on how to debug in Visual Studio Code, see Debug PowerShell Azure Functions locally.

  1. Stisknutím klávesy F5 spusťte projekt Function App.Press F5 to start the function app project. Výstup z nástrojů Tools se zobrazí na panelu Terminál.Output from Core Tools is displayed in the Terminal panel.

  2. Na panelu Terminál zkopírujte adresu URL koncového bodu vaší funkce aktivované protokolem HTTP.In the Terminal panel, copy the URL endpoint of your HTTP-triggered function.

    Místní výstup Azure

  3. Přidejte řetězec dotazu ?name=<yourname> k této adrese URL a pak pomocí Invoke-RestMethod příkazu ve druhém příkazovém řádku prostředí PowerShell spusťte požadavek následujícím způsobem:Append the query string ?name=<yourname> to this URL, and then use Invoke-RestMethod in a second PowerShell command prompt to execute the request, as follows:

    PS > Invoke-RestMethod -Method Get -Uri http://localhost:7071/api/HttpTrigger?name=PowerShell
    Hello PowerShell
    

    Požadavek GET můžete také spustit z prohlížeče z následující adresy URL:You can also execute the GET request from a browser from the following URL:

    http://localhost:7071/api/HttpExample?name=PowerShell

    Když zavoláte koncový bod HttpTrigger bez předání name parametru buď jako parametr dotazu, nebo v těle, funkce vrátí BadRequest chybu.When you call the HttpTrigger endpoint without passing a name parameter either as a query parameter or in the body, the function returns a BadRequest error. Při revizi kódu v run.ps1 vidíte, že k této chybě dochází v rámci návrhu.When you review the code in run.ps1, you see that this error occurs by design.

  4. Informace o žádosti se zobrazí na panelu terminálu .Information about the request is shown in Terminal panel.

    Spuštění funkce na panelu terminálu

  5. Po dokončení stiskněte klávesy CTRL + C a zastavte základní nástroje.When done, press Ctrl + C to stop Core Tools.

Po ověření správného fungování funkce na místním počítači je na čase publikovat projekt do Azure.After you've verified that the function runs correctly on your local computer, it's time to publish the project to Azure.

Po ověření, že se funkce na místním počítači spustí správně, je čas použít Visual Studio Code k publikování projektu přímo do Azure.After you've verified that the function runs correctly on your local computer, it's time to use Visual Studio Code to publish the project directly to Azure.

Přihlášení k AzureSign in to Azure

Než můžete aplikaci publikovat, musíte se přihlásit do Azure.Before you can publish your app, you must sign in to Azure.

  1. Pokud ještě nejste přihlášení, zvolte na řádku aktivity ikonu Azure a pak v oblasti Azure: funkce zvolte Přihlásit se k Azure.... Pokud ho ještě nemáte, můžete si vytvořit bezplatný účet Azure.If you aren't already signed in, choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose Sign in to Azure.... If you don't already have one, you can Create a free Azure account. Studenti můžou kliknout sem a ** vytvořit si bezplatný účet Azure for Students .**Students can click here to Create a free Azure for Students account

    Odezva místního hostitele funkce v prohlížeči

    Pokud jste už přihlášení, přečtěte si další část.If you're already signed in, go to the next section.

  2. Po zobrazení výzvy v prohlížeči vyberte svůj účet Azure a přihlaste se pomocí svých přihlašovacích údajů k účtu Azure.When prompted in the browser, choose your Azure account and sign in using your Azure account credentials.

  3. Po úspěšném přihlášení můžete zavřít nové okno prohlížeče.After you've successfully signed in, you can close the new browser window. Předplatná, která patří k vašemu účtu Azure, se zobrazí na bočním panelu.The subscriptions that belong to your Azure account are displayed in the Side bar.

Publikování projektu do AzurePublish the project to Azure

V této části vytvoříte aplikaci funkcí a související prostředky v předplatném Azure a pak svůj kód nasadíte.In this section, you create a function app and related resources in your Azure subscription and then deploy your code.

Důležité

Publikování do existující aplikace funkcí přepíše obsah této aplikace v Azure.Publishing to an existing function app overwrites the content of that app in Azure.

  1. Zvolte ikonu Azure na řádku aktivity a potom v oblasti Azure: funkce zvolte tlačítko nasadit do aplikace Function App... .Choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose the Deploy to function app... button.

    Publikování projektu do Azure

  2. Zadejte následující informace na následujících dotazech:Provide the following information at the prompts:

    • Vyberte složku: Zvolte složku z pracovního prostoru nebo přejděte k nějakému, který obsahuje vaši aplikaci Function App.Select folder: Choose a folder from your workspace or browse to one that contains your function app. Tato funkce se nezobrazuje, pokud už máte spuštěnou platnou aplikaci Function App.You won't see this if you already have a valid function app opened.

    • Vyberte předplatné: zvolte předplatné, které chcete použít.Select subscription: Choose the subscription to use. Toto se nezobrazí, pokud máte jenom jedno předplatné.You won't see this if you only have one subscription.

    • Vyberte Function App v Azure: zvolte + Create new Function App .Select Function App in Azure: Choose + Create new Function App. (Nevybírejte Advanced možnost, která není pokrytá v tomto článku.)(Don't choose the Advanced option, which isn't covered in this article.)

    • Zadejte globálně jedinečný název aplikace Function App: zadejte název, který je platný v cestě URL.Enter a globally unique name for the function app: Type a name that is valid in a URL path. Název, který zadáte, bude ověřený, abyste se ujistili, že je v Azure Functions jedinečný.The name you type is validated to make sure that it's unique in Azure Functions.

    • Vyberte modul runtime: Zvolte verzi Pythonu, kterou jste spustili místně.Select a runtime: Choose the version of Python you've been running on locally. python --versionK zkontrolování vaší verze můžete použít příkaz.You can use the python --version command to check your version.
    • Vyberte modul runtime: zvolte verzi Node.js, na které jste pracovali místně.Select a runtime: Choose the version of Node.js you've been running on locally. node --versionK zkontrolování vaší verze můžete použít příkaz.You can use the node --version command to check your version.
    • Vyberte umístění pro nové prostředky: pro lepší výkon zvolte oblast poblíž.Select a location for new resources: For better performance, choose a region near you.
  3. Po dokončení se ve vašem předplatném vytvoří následující prostředky Azure s použitím názvů na základě názvu vaší aplikace Function App:When completed, the following Azure resources are created in your subscription, using names based on your function app name:

    • Skupina prostředků, což je logický kontejner pro související prostředky.A resource group, which is a logical container for related resources.
    • Účet Standard Azure Storage, který uchovává stav a další informace o vašich projektech.A standard Azure Storage account, which maintains state and other information about your projects.
    • Plán spotřeby, který definuje základního hostitele pro aplikaci s funkcí bez serveru.A consumption plan, which defines the underlying host for your serverless function app.
    • Aplikace Function App, která poskytuje prostředí pro spuštění kódu vaší funkce.A function app, which provides the environment for executing your function code. Aplikace Function App umožňuje seskupit funkce jako logickou jednotku pro snadnější správu, nasazování a sdílení prostředků v rámci stejného plánu hostování.A function app lets you group functions as a logical unit for easier management, deployment, and sharing of resources within the same hosting plan.
    • Instance Application Insights připojená k aplikaci Function App, která sleduje využití funkce bez serveru.An Application Insights instance connected to the function app, which tracks usage of your serverless function.

    Po vytvoření aplikace funkcí a použití balíčku nasazení se zobrazí oznámení.A notification is displayed after your function app is created and the deployment package is applied.

  4. Pokud chcete zobrazit výsledky vytvoření a nasazení, včetně prostředků Azure, které jste vytvořili, vyberte Zobrazit výstup v tomto oznámení.Select View Output in this notification to view the creation and deployment results, including the Azure resources that you created. Pokud jste oznámení nezobrazili, vyberte ikonu zvonku v pravém dolním rohu, abyste ji viděli znovu.If you miss the notification, select the bell icon in the lower right corner to see it again.

    Vytvořit kompletní oznámení

Spuštění funkce v AzureRun the function in Azure

  1. Zpátky v oblasti Azure: Functions (funkce ) na bočním panelu rozbalte novou aplikaci Function App v rámci vašeho předplatného.Back in the Azure: Functions area in the side bar, expand the new function app under your subscription. Rozbalte funkce, klikněte pravým tlačítkem myši (Windows) nebo Ctrl + Click (MacOS) na HttpExamplea pak zvolte Kopírovat adresu URL funkce.Expand Functions, right-click (Windows) or Ctrl + click (macOS) on HttpExample, and then choose Copy function URL.

    Zkopírujte adresu URL funkce pro nový Trigger HTTP.

  2. Vložte tuto adresu URL pro požadavek HTTP do adresního řádku prohlížeče, přidejte name řetězec dotazu ?name=Functions na konec této adresy URL a potom spusťte požadavek.Paste this URL for the HTTP request into your browser's address bar, add the name query string as ?name=Functions to the end of this URL, and then execute the request. Adresa URL, která volá funkci aktivovanou protokolem HTTP, by měla být v následujícím formátu:The URL that calls your HTTP-triggered function should be in the following format:

    http://<functionappname>.azurewebsites.net/api/httpexample?name=Functions
    

    Následující příklad ukazuje odpověď v prohlížeči na požadavek Remote GET vracený funkcí:The following example shows the response in the browser to the remote GET request returned by the function:

    Odezva funkce v prohlížeči

Vyčištění prostředkůClean up resources

Až budete pokračovat k dalšímu kroku, přidejte do své funkce vazbu fronty Azure Storage, budete muset všechny vaše prostředky zachovávat, abyste mohli vytvářet informace o tom, co jste už provedli.When you continue to the next step, Add an Azure Storage queue binding to your function, you'll need to keep all your resources in place to build on what you've already done.

V opačném případě můžete pomocí následujících kroků odstranit aplikaci Function App a její související prostředky, abyste se vyhnuli dalším nákladům.Otherwise, you can use the following steps to delete the function app and its related resources to avoid incurring any further costs.

  1. V Visual Studio Code stisknutím klávesy F1 otevřete paletu příkazů.In Visual Studio Code, press F1 to open the command palette. V paletě příkazů vyhledejte a vyberte Azure Functions: Open in portal .In the command palette, search for and select Azure Functions: Open in portal.

  2. Zvolte aplikaci Function App a stiskněte klávesu ENTER.Choose your function app, and press Enter. Na Azure Portal se otevře stránka Function App.The function app page opens in the Azure portal.

  3. Na kartě Přehled vyberte odkaz s názvem vedle skupiny prostředků.In the Overview tab, select the named link next to Resource group.

    Vyberte skupinu prostředků, kterou chcete odstranit ze stránky aplikace funkcí.

  4. Na stránce Skupina prostředků zkontrolujte seznam zahrnutých prostředků a ověřte, že jsou to ty, které chcete odstranit.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  5. Vyberte Odstranit skupinu prostředků a postupujte podle pokynů.Select Delete resource group, and follow the instructions.

    Odstranění může trvat několik minut.Deletion may take a couple of minutes. Po jeho dokončení se na několik sekund zobrazí oznámení.When it's done, a notification appears for a few seconds. K zobrazení tohoto oznámení můžete také vybrat ikonu zvonku v horní části stránky.You can also select the bell icon at the top of the page to view the notification.

Další informace o nákladech na funkce najdete v tématu odhad nákladů na plán spotřeby.To learn more about Functions costs, see Estimating Consumption plan costs.

Další krokyNext steps

Pomocí Visual Studio Code jste vytvořili aplikaci funkcí s jednoduchou funkcí aktivovanou protokolem HTTP.You have used Visual Studio Code to create a function app with a simple HTTP-triggered function. V dalším článku rozbalíte tuto funkci přidáním výstupní vazby.In the next article, you expand that function by adding an output binding. Tato vazba zapíše řetězec z požadavku HTTP do zprávy ve frontě Azure Queue Storage.This binding writes the string from the HTTP request to a message in an Azure Queue Storage queue.