Azure Functions Core Tools használataWork with Azure Functions Core Tools

Azure Functions Core Tools lehetővé teszi a függvények fejlesztését és tesztelését a helyi számítógépen a parancssorból vagy a terminálból.Azure Functions Core Tools lets you develop and test your functions on your local computer from the command prompt or terminal. A helyi függvények csatlakozhatnak az élő Azure-szolgáltatásokhoz, és a függvények a teljes functions Runtime használatával hibakeresést végezhetnek a helyi számítógépen.Your local functions can connect to live Azure services, and you can debug your functions on your local computer using the full Functions runtime. Az Azure-előfizetésben is üzembe helyezhet egy Function alkalmazást.You can even deploy a function app to your Azure subscription.

Fontos

Ne keverje a helyi fejlesztési ugyanaz a függvényalkalmazás a portál fejlesztési.Do not mix local development with portal development in the same function app. Amikor hoz létre, és a egy helyi projektből függvények közzétételéhez, kell nem próbál karbantartása, vagy módosítsa a projekt kódját a portálon.When you create and publish functions from a local project, you should not try to maintain or modify project code in the portal.

A functions a helyi számítógépen való fejlesztése és az Azure-ba való közzétételük az alapeszközök használatával az alábbi alapvető lépéseket követi:Developing functions on your local computer and publishing them to Azure using Core Tools follows these basic steps:

Alapvető eszközök verzióiCore Tools versions

A Azure Functions Core Tools két verziója létezik.There are two versions of Azure Functions Core Tools. A használt verzió a helyi fejlesztési környezettől, a választott nyelvtőlés a szükséges támogatási szinttől függ:The version you use depends on your local development environment, choice of language, and level of support required:

Ha másként nincs jelezve, a cikkben szereplő példák a 2. x verzióra vonatkoznak.Unless otherwise noted, the examples in this article are for version 2.x.

Az Azure Functions Core Tools telepítéseInstall the Azure Functions Core Tools

Azure functions Core Tools tartalmaz egy olyan verziót, amely a helyi fejlesztési számítógépen futtatható Azure functions futtatókörnyezetet is felhasználja.Azure Functions Core Tools includes a version of the same runtime that powers Azure Functions runtime that you can run on your local development computer. Emellett parancsokat is biztosít a függvények létrehozásához, az Azure-hoz való kapcsolódáshoz és a functions-projektek üzembe helyezéséhez.It also provides commands to create functions, connect to Azure, and deploy function projects.

2-es verzió. xVersion 2.x

Az eszközök 2. x verziója a .NET Core-ra épülő Azure Functions Runtime 2. x verziót használja.Version 2.x of the tools uses the Azure Functions runtime 2.x that is built on .NET Core. Ez a verzió a .NET Core 2. x összes platformján támogatott, beleértve a Windows, a MacOSés a Linux rendszertis.This version is supported on all platforms .NET Core 2.x supports, including Windows, macOS, and Linux.

Fontos

A .NET Core 2. x SDK a bővítményekhasználatával történő telepítésének követelményét kihagyhatja.You can bypass the requirement for installing the .NET Core 2.x SDK by using extension bundles.

WindowsWindows

A következő lépések a NPM segítségével telepítik a Windows rendszerhez tartozó alapvető eszközöket.The following steps use npm to install Core Tools on Windows. A csokitis használhatja.You can also use Chocolatey. További információ: alapvető eszközök – fontosinformációk.For more information, see the Core Tools readme.

  1. Telepítse a Node.js-t, amely tartalmazza a NPM.Install Node.js, which includes npm. Az eszközök 2. x verziója esetében csak a Node. js 8,5-es és újabb verziói támogatottak.For version 2.x of the tools, only Node.js 8.5 and later versions are supported.

  2. Telepítse a Core Tools csomagot:Install the Core Tools package:

    npm install -g azure-functions-core-tools
    

    A NPM letöltése és telepítése eltarthat néhány percig.It may take a few minutes for npm to download and install the Core Tools package.

  3. Ha nem tervezi a bővítményekhasználatát, telepítse a Windowshoz készült .net Core 2. x SDK-t.If you do not plan to use extension bundles, install the .NET Core 2.x SDK for Windows.

MacOS és HomebrewMacOS with Homebrew

A következő lépések a Homebrew-t használják a fő eszközök macOS rendszeren való telepítéséhez.The following steps use Homebrew to install the Core Tools on macOS.

  1. Telepítse a Homebrew-t, ha még nincs telepítve.Install Homebrew, if it's not already installed.

  2. Telepítse a Core Tools csomagot:Install the Core Tools package:

    brew tap azure/functions
    brew install azure-functions-core-tools
    
  3. Ha nem tervezi a bővítményekhasználatát, telepítse a .net Core 2. x SDK-t a MacOS rendszerhez.If you do not plan to use extension bundles, install .NET Core 2.x SDK for macOS.

Linux (Ubuntu/Debian) APT-velLinux (Ubuntu/Debian) with APT

Az alábbi lépések segítségével telepítheti az alapvető eszközöket az Ubuntu/Debian Linux-disztribúción.The following steps use APT to install Core Tools on your Ubuntu/Debian Linux distribution. Más Linux-disztribúciók esetében tekintse meg az alapvető eszközök readmecímű témakört.For other Linux distributions, see the Core Tools readme.

  1. Telepítse a Microsoft Package repository GPG kulcsot a csomag integritásának ellenőrzéséhez:Install the Microsoft package repository GPG key, to validate package integrity:

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
    sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
    
  2. Az APT-frissítés végrehajtása előtt állítsa be a .NET-fejlesztői források listáját.Set up the .NET development source list before doing an APT update.

    A következő parancs futtatásával állíthatja be az APT-forrásokhoz tartozó Ubuntu-listát:To set up the APT source list for Ubuntu, run this command:

    sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-$(lsb_release -cs)-prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list'
    

    A Debian APT-forráslista beállításához futtassa a következő parancsot:To set up the APT source list for Debian, run this command:

    sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/debian/$(lsb_release -rs)/prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list'
    
  3. Az alábbi listában keresse meg az /etc/apt/sources.list.d/dotnetdev.list fájlt a megfelelő Linux-verziókhoz tartozó sztringek közül:Check the /etc/apt/sources.list.d/dotnetdev.list file for one of the appropriate Linux version strings listed below:

    Linux-disztribúcióLinux distribution VersionVersion
    Debian 10Debian 10 buster
    Debian 9Debian 9 stretch
    Debian 8Debian 8 jessie
    Ubuntu 18,10Ubuntu 18.10 cosmic
    Ubuntu 18.04Ubuntu 18.04 bionic
    Ubuntu 17,04Ubuntu 17.04 zesty
    Ubuntu 16.04/Linux mint 18Ubuntu 16.04/Linux Mint 18 xenial
  4. Az APT-forrás frissítésének elindítása:Start the APT source update:

    sudo apt-get update
    
  5. Telepítse a Core Tools csomagot:Install the Core Tools package:

    sudo apt-get install azure-functions-core-tools
    
  6. Ha nem tervezi a bővítményekhasználatát, telepítse a .net Core 2. x SDK-t a Linux rendszerhez.If you do not plan to use extension bundles, install .NET Core 2.x SDK for Linux.

Egy helyi Functions-projekt létrehozásaCreate a local Functions project

A functions projekt könyvtára tartalmazza a Host. JSON és a Local. Settings. JSONfájlt, valamint az egyes függvények kódját tartalmazó almappákat.A functions project directory contains the files host.json and local.settings.json, along with subfolders that contain the code for individual functions. Ez a könyvtár egyenértékű egy Azure-beli Function alkalmazással.This directory is the equivalent of a function app in Azure. A functions mappa struktúrájával kapcsolatos további tudnivalókért tekintse meg a Azure functions fejlesztői útmutatócímű témakört.To learn more about the Functions folder structure, see the Azure Functions developers guide.

A 2. x verzióhoz az inicializáláskor ki kell választania a projekt alapértelmezett nyelvét, és az összes funkció hozzáadásra kerül az alapértelmezett nyelvi sablonok használatával.Version 2.x requires you to select a default language for your project when it is initialized, and all functions added use default language templates. Az 1. x verzióban az egyes függvények létrehozásakor minden alkalommal meg kell adnia a nyelvet.In version 1.x, you specify the language each time you create a function.

A terminál ablakban vagy egy parancssorban futtassa a következő parancsot a projekt és a helyi git-tárház létrehozásához:In the terminal window or from a command prompt, run the following command to create the project and local Git repository:

func init MyFunctionProj

Amikor megadja a projekt nevét, létrejön egy új, a névvel ellátott mappa, amely inicializálva van.When you provide a project name, a new folder with that name is created and initialized. Ellenkező esetben az aktuális mappa inicializálása megtörtént.Otherwise, the current folder is initialized.
A 2. x verzióban a parancs futtatásakor ki kell választania egy futtatókörnyezetet a projekthez.In version 2.x, when you run the command you must choose a runtime for your project.

Select a worker runtime:
dotnet
node
python (preview)
powershell (preview)

A fel/le nyílbillentyűk használatával válassza ki a nyelvet, majd nyomja le az ENTER billentyűt.Use the up/down arrow keys to choose a language, then press Enter. Ha JavaScript-vagy írógéppel-függvények fejlesztését tervezi, válassza a csomópontlehetőséget, majd válassza ki a nyelvet.If you plan to develop JavaScript or TypeScript functions, choose node, and then select the language. Az írógéppel néhány további követelménytis tartalmaz.TypeScript has some additional requirements.

A kimenet a következő példához hasonlít egy JavaScript-projekthez:The output looks like the following example for a JavaScript project:

Select a worker runtime: node
Writing .gitignore
Writing host.json
Writing local.settings.json
Writing C:\myfunctions\myMyFunctionProj\.vscode\extensions.json
Initialized empty Git repository in C:/myfunctions/myMyFunctionProj/.git/

a func init a következő beállításokat támogatja, amelyek csak 2. x verziójúak, hacsak másként nincs jelezve:func init supports the following options, which are version 2.x-only, unless otherwise noted:

BeállításOption LeírásDescription
--csx Egy C# parancsfájl-(. CSX) projekt inicializálása.Initializes a C# script (.csx) project. A következő parancsokban meg kell adnia a --csx értéket.You must specify --csx in subsequent commands.
--docker Hozzon létre egy Docker egy tárolóhoz egy olyan alaprendszerkép használatával, amely a kiválasztott --worker-runtime típuson alapul.Create a Dockerfile for a container using a base image that is based on the chosen --worker-runtime. Akkor használja ezt a beállítást, ha egyéni Linux-tárolóba szeretne közzétenni.Use this option when you plan to publish to a custom Linux container.
--force A projekt inicializálása akkor is, ha vannak meglévő fájlok a projektben.Initialize the project even when there are existing files in the project. Ez a beállítás felülírja a meglévő fájlokat ugyanazzal a névvel.This setting overwrites existing files with the same name. A Project mappában található egyéb fájlok nem érintettek.Other files in the project folder aren't affected.
--no-source-control -n Megakadályozza a git-tárház alapértelmezett létrehozását az 1. x verzióban.Prevents the default creation of a Git repository in version 1.x. A 2. x verzióban a git-tárház alapértelmezés szerint nincs létrehozva.In version 2.x, the git repository isn't created by default.
--source-control Meghatározza, hogy a git-tárház létrejött-e.Controls whether a git repository is created. Alapértelmezés szerint a tárház nem jön létre.By default, a repository isn't created. Ha @no__t – 0, létrejön egy adattár.When true, a repository is created.
--worker-runtime Beállítja a projekt nyelvi futtatókörnyezetét.Sets the language runtime for the project. A támogatott értékek a következők: dotnet, node (JavaScript), java és python.Supported values are dotnet, node (JavaScript), java, and python. Ha nincs beállítva, a rendszer arra kéri, hogy válassza ki a futtatókörnyezetet az inicializálás során.When not set, you are prompted to choose your runtime during initialization.

Fontos

Alapértelmezés szerint a Core Tools 2. x verziója a .net futtatókörnyezethez C# (. csproj) hoz létre Function app-projekteket.By default, version 2.x of the Core Tools creates function app projects for the .NET runtime as C# class projects (.csproj). A C# Visual Studióval vagy a Visual Studio Code-hoz használható projektek a tesztelés során és az Azure-ba való közzététel során fordíthatók le.These C# projects, which can be used with Visual Studio or Visual Studio Code, are compiled during testing and when publishing to Azure. Ha ehelyett az 1. x verzióban és a portálon létrehozott ugyanazon C# parancsfájl-(. CSX) fájlokat szeretné létrehozni és használni, akkor a függvények létrehozásakor és telepítésekor a --csx paramétert is meg kell adnia.If you instead want to create and work with the same C# script (.csx) files created in version 1.x and in the portal, you must include the --csx parameter when you create and deploy functions.

Bővítmények regisztrálásaRegister extensions

HTTP- és időzítő eseményindító kivételével Functions kötések verze modulu runtime a 2.x bővítménycsomagok vannak implementálva.With the exception of HTTP and timer triggers, Functions bindings in runtime version 2.x are implemented as extension packages. A verzió 2.x verzióját az Azure Functions futtatókörnyezettel, explicit módon regisztrálnia kell a bővítmények a függvényekben használt kötési típusok.In version 2.x of the Azure Functions runtime, you have to explicitly register the extensions for the binding types used in your functions. A kivételek, a HTTP-kötések és az időzítési eseményindítóktól bővítmények nem igénylő.The exceptions to this are HTTP bindings and timer triggers, which do not require extensions.

Választhatja a kötési bővítményeket külön-külön telepíti, vagy egy köteg kiterjesztéshivatkozásának souboru projektu host.json is hozzáadhat.You can choose to install binding extensions individually, or you can add an extension bundle reference to the host.json project file. Bővítmény csomagjaiból eltávolítja az esélye a csomag kompatibilitási problémák több kötési típus használatakor.Extension bundles removes the chance of having package compatibility issues when using multiple binding types. Az ajánlott módszer regisztrálásához a kötési bővítményeket.It is the recommended approach for registering binding extensions. Bővítmény csomagjaiból is eltávolítja a követelménynek, telepíti a .NET Core 2.x SDK.Extension bundles also removes the requirement of installing the .NET Core 2.x SDK.

bővítmény-csomagokExtension bundles

A kötési bővítmények telepítésének legegyszerűbb módja a bővítmény-csomagokengedélyezése.The easiest way to install binding extensions is to enable extension bundles. Ha engedélyezi a csomagokat, a rendszer automatikusan telepíti a bővítmények előre meghatározott készletét.When you enable bundles, a predefined set of extension packages is automatically installed.

A bővítmények engedélyezéséhez nyissa meg a Host. JSON fájlt, és frissítse annak tartalmát, hogy az megfeleljen a következő kódnak:To enable extension bundles, open the host.json file and update its contents to match the following code:

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

További tudnivalókért lásd: regisztrálása az Azure Functions kötési bővítményeket.To learn more, see Register Azure Functions binding extensions. Kötések a functions.json-fájl hozzáadása előtt hozzá kell adnia a host.json a bővítmény kötegeket.You should add extension bundles to the host.json before you add bindings to the functions.json file.

Az egyes bővítmények regisztrálásaRegister individual extensions

Bővítmények, amelyek nem a csomag egyik gyermekszoftver telepítenie kell, ha manuálisan regisztrálhatja az egyes bővítménycsomagok adott kötések.If you need to install extensions that aren't in a bundle, you can manually register individual extension packages for specific bindings.

Megjegyzés

Manuálisan kell regisztrálni extensions segítségével func extensions install, rendelkeznie kell a .NET Core SDK-t 2.x.To manually register extensions by using func extensions install, you must have the .NET Core 2.x SDK installed.

Miután frissítette a function.json -fájl, amely a függvénynek szüksége van, futtassa a következő parancsot a projektmappában összes kötését.After you have updated your function.json file to include all the bindings that your function needs, run the following command in the project folder.

func extensions install

A parancs beolvassa a function.json fájlra kattintva látható, mely csomagokat kell, telepíti őket, és ismét létrehozza a bővítmények projekt.The command reads the function.json file to see which packages you need, installs them, and rebuilds the extensions project. Az új kötések felveszi a jelenlegi verzió, hanem nem frissíti a meglévő kötéseit.It adds any new bindings at the current version but does not update existing bindings. Használja a --force lehetőséget, ha meglévő kötések a legújabb verzióra újakat telepítésekor.Use the --force option to update existing bindings to the latest version when installing new ones.

Local settings file (Helyi beállításfájl)Local settings file

A local. Settings. JSON fájl az alkalmazás beállításait, a kapcsolatok karakterláncait és a helyi Fejlesztőeszközök által használt beállításokat tárolja.The local.settings.json file stores app settings, connection strings, and settings used by local development tools. A local. Settings. JSON fájlban lévő beállításokat csak akkor használja a rendszer, ha helyileg futtat projekteket.Settings in the local.settings.json file are used only when you're running projects locally. A helyi beállítások fájlja a következő struktúrával rendelkezik:The local settings file has this structure:

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "<language worker>",
    "AzureWebJobsStorage": "<connection-string>",
    "AzureWebJobsDashboard": "<connection-string>",
    "MyBindingConnection": "<binding-connection-string>"
  },
  "Host": {
    "LocalHttpPort": 7071,
    "CORS": "*",
    "CORSCredentials": false
  },
  "ConnectionStrings": {
    "SQLConnectionString": "<sqlclient-connection-string>"
  }
}

Ezek a beállítások akkor támogatottak, ha helyileg futtatja a projekteket:These settings are supported when you run projects locally:

BeállításSetting LeírásDescription
IsEncrypted Ha ez a beállítás a trueértékre van beállítva, az összes érték helyi számítógép kulccsal lesz titkosítva.When this setting is set to true, all values are encrypted with a local machine key. func settings Parancsokkal használható.Used with func settings commands. Az falsealapértelmezett érték:.Default value is false.
Values Az Alkalmazásbeállítások és a kapcsolódási karakterláncok tömbje, amely akkor használatos, amikor egy projekt helyileg fut.Array of application settings and connection strings used when a project is running locally. Ezek a kulcs-érték (String-String) párok megfelelnek az Azure-beli Function alkalmazás beállításainak, például AzureWebJobsStorage:.These key-value (string-string) pairs correspond to application settings in your function app in Azure, like AzureWebJobsStorage. Számos eseményindító és kötés olyan tulajdonsággal rendelkezik, amely egy kapcsolati karakterlánc-alkalmazásra Connection vonatkozó beállításra hivatkozik, például a blob Storage eseményindítóhoz.Many triggers and bindings have a property that refers to a connection string app setting, like Connection for the Blob storage trigger. Ezen tulajdonságok esetében a Values tömbben definiált Alkalmazásbeállítás szükséges.For these properties, you need an application setting defined in the Values array.
AzureWebJobsStoragea kötelező Alkalmazásbeállítások a HTTP-n kívüli eseményindítók esetében.AzureWebJobsStorage is a required app setting for triggers other than HTTP.
A functions Runtime 2. x verziójának a [FUNCTIONS_WORKER_RUNTIME] beállítást kell megadnia, amelyet a projekthez a Core Tools generál.Version 2.x of the Functions runtime requires the [FUNCTIONS_WORKER_RUNTIME] setting, which is generated for your project by Core Tools.
Ha az Azure Storage-emulátor helyileg van telepítve AzureWebJobsStorage UseDevelopmentStorage=true, és a értékre van állítva, a Core Tools az emulátort használja.When you have the Azure storage emulator installed locally and you set AzureWebJobsStorage to UseDevelopmentStorage=true, Core Tools uses the emulator. Az emulátor a fejlesztés során hasznos, de a telepítés előtt tesztelni kell egy tényleges tárolási kapcsolatban.The emulator is useful during development, but you should test with an actual storage connection before deployment.
Az értékeknek karakterláncnak és nem JSON-objektumoknak vagy tömböknek kell lenniük.Values must be strings and not JSON objects or arrays. A nevek beállítása nem tartalmazhat kettőspontot:() vagy dupla aláhúzást__().Setting names can't include a colon (:) or a double underline (__). Ezeket a karaktereket a futtatókörnyezet foglalta le.These characters are reserved by the runtime.
Host Az ebben a szakaszban található beállítások testre szabják a functions gazdagép folyamatát, amikor helyileg futtat projekteket.Settings in this section customize the Functions host process when you run projects locally. Ezek a beállítások eltérhetnek a gazdagép. JSON beállításaitól, amelyek akkor is érvényesek, amikor projekteket futtatnak az Azure-ban.These settings are separate from the host.json settings, which also apply when you run projects in Azure.
LocalHttpPort Beállítja a helyi functions-gazdagép (func host start és func run) futtatásakor használt alapértelmezett portot.Sets the default port used when running the local Functions host (func host start and func run). A --port parancssori kapcsoló elsőbbséget élvez ezzel a beállítással szemben.The --port command-line option takes precedence over this setting.
CORS Meghatározza a több eredetű erőforrás-megosztás (CORS)számára engedélyezett származási erőforrásokat.Defines the origins allowed for cross-origin resource sharing (CORS). Az eredetek vesszővel tagolt listaként vannak megadva, szóközök nélkül.Origins are supplied as a comma-separated list with no spaces. A helyettesítő karakteres*érték () támogatott, amely bármilyen forrásból engedélyezi a kérelmeket.The wildcard value (*) is supported, which allows requests from any origin.
CORSCredentials Ha a értékre van withCredentials állítva, a truekérelmeket engedélyezi.When set to true, allows withCredentials requests.
ConnectionStrings Egy gyűjtemény.A collection. Ne használja ezt a gyűjteményt a függvények kötései által használt kapcsolati sztringekhez.Don't use this collection for the connection strings used by your function bindings. Ezt a gyűjteményt kizárólag olyan keretrendszerek használják, amelyek általában a konfigurációs fájl ( ConnectionStrings például Entity Framework) szakaszának a kapcsolatok karakterláncait kapják meg.This collection is used only by frameworks that typically get connection strings from the ConnectionStrings section of a configuration file, like Entity Framework. Az objektumban található kapcsolódási karakterláncok a System. SqlClient. szolgáltatói típussal lesznek hozzáadva a környezethez.Connection strings in this object are added to the environment with the provider type of System.Data.SqlClient. Az ebben a gyűjteményben lévő elemek nem jelennek meg az Azure-ban más Alkalmazásbeállítások használatával.Items in this collection aren't published to Azure with other app settings. Ezeket az értékeket explicit módon fel kell vennie Connection strings a Function app-beállítások gyűjteményéből.You must explicitly add these values to the Connection strings collection of your function app settings. Ha a függvény kódjában SqlConnection hoz létre egy kódot, a kapcsolati sztring értékét a portálon az Alkalmazásbeállítások között lévő többi kapcsolattal együtt kell tárolnia.If you're creating a SqlConnection in your function code, you should store the connection string value with your other connections in Application Settings in the portal.

Alapértelmezés szerint ezek a beállítások nem települnek át automatikusan, ha a projekt közzé van téve az Azure-ban.By default, these settings are not migrated automatically when the project is published to Azure. Ha közzéteszi a --publish-local-settings kapcsolót, akkor győződjön meg arról, hogy ezek a beállítások bekerülnek az Azure-beli Function alkalmazásba.Use the --publish-local-settings switch when you publish to make sure these settings are added to the function app in Azure. Vegye figyelembe, hogy a ConnectionStrings lévő értékek soha nem lesznek közzétéve.Note that values in ConnectionStrings are never published.

A Function app Settings értékeit környezeti változókként is beolvashatja a kódban.The function app settings values can also be read in your code as environment variables. További információkért tekintse meg az alábbi nyelvspecifikus témakörök környezeti változók című szakaszát:For more information, see the Environment variables section of these language-specific reference topics:

Ha nincs megadva érvényes tárolási kapcsolódási karakterlánc a AzureWebJobsStorage értékhez, és az emulátor nincs használatban, a következő hibaüzenet jelenik meg:When no valid storage connection string is set for AzureWebJobsStorage and the emulator isn't being used, the following error message is shown:

A AzureWebJobsStorage hiányzó értéke a local. Settings. JSON fájlban.Missing value for AzureWebJobsStorage in local.settings.json. Ez a HTTP-n kívüli összes eseményindító esetében kötelező.This is required for all triggers other than HTTP. Futtathatja a "funkció Azure functionapp Fetch-app-Settings <functionAppName @ no__t-1" parancsot, vagy megadhat egy kapcsolatok karakterláncot a local. Settings. JSON fájlban.You can run 'func azure functionapp fetch-app-settings <functionAppName>' or specify a connection string in local.settings.json.

A tárolási kapcsolatok karakterláncának beolvasásaGet your storage connection strings

Még ha a Storage emulatort is szeretné használni a fejlesztéshez, érdemes lehet egy tényleges tárolási kapcsolatban is tesztelni.Even when using the storage emulator for development, you may want to test with an actual storage connection. Feltételezve, hogy már létrehozott egy Storage-fiókot, a következő módokon szerezhet be érvényes tárolási kapcsolatok karakterláncot:Assuming you have already created a storage account, you can get a valid storage connection string in one of the following ways:

  • A Azure Portal.From the Azure portal. Navigáljon a Storage-fiókjához, válassza a hozzáférési kulcsok lehetőséget a Beállításokterületen, majd másolja a kapcsolati karakterlánc egyik értékét.Navigate to your storage account, select Access keys in Settings, then copy one of the Connection string values.

    A Azure Portalból származó kapcsolatok karakterláncának másolása

  • Az Azure-fiókhoz való kapcsolódáshoz használjon Azure Storage Explorer .Use Azure Storage Explorer to connect to your Azure account. Az Explorerbenbontsa ki az előfizetését, válassza ki a Storage-fiókját, és másolja az elsődleges vagy másodlagos kapcsolatok sztringjét.In the Explorer, expand your subscription, select your storage account, and copy the primary or secondary connection string.

    A Storage Explorerból származó kapcsolatok karakterláncának másolása

  • Az alábbi parancsok egyikével töltheti le a kapcsolódási karakterláncot az Azure-ból a Core Tools használatával:Use Core Tools to download the connection string from Azure with one of the following commands:

    • Egy meglévő Function alkalmazás összes beállításának letöltése:Download all settings from an existing function app:

      func azure functionapp fetch-app-settings <FunctionAppName>
      
    • Egy adott Storage-fiókhoz tartozó kapcsolatok karakterláncának beolvasása:Get the Connection string for a specific storage account:

      func azure storage fetch-connection-string <StorageAccountName>
      

      Ha még nem jelentkezett be az Azure-ba, a rendszer felszólítja erre.When you are not already signed in to Azure, you are prompted to do so.

Függvény létrehozásaCreate a function

Hozzon létre egy függvényt, futtassa a következő parancsot:To create a function, run the following command:

func new

A 2. x verzióban a func new futtatásakor a rendszer arra kéri, hogy válasszon egy sablont a Function app alapértelmezett nyelvén, majd a rendszer kéri, hogy válasszon egy nevet a függvénynek.In version 2.x, when you run func new you are prompted to choose a template in the default language of your function app, then you are also prompted to choose a name for your function. Az 1. x verzióban a rendszer azt is kéri, hogy válassza ki a nyelvet.In version 1.x, you are also prompted to choose the language.

Select a language: Select a template:
Blob trigger
Cosmos DB trigger
Event Grid trigger
HTTP trigger
Queue trigger
SendGrid
Service Bus Queue trigger
Service Bus Topic trigger
Timer trigger

A függvény kódja a megadott nevű almappában jön létre, ahogy az a következő üzenetsor-trigger kimenetében látható:Function code is generated in a subfolder with the provided function name, as you can see in the following queue trigger output:

Select a language: Select a template: Queue trigger
Function name: [QueueTriggerJS] MyQueueTrigger
Writing C:\myfunctions\myMyFunctionProj\MyQueueTrigger\index.js
Writing C:\myfunctions\myMyFunctionProj\MyQueueTrigger\readme.md
Writing C:\myfunctions\myMyFunctionProj\MyQueueTrigger\sample.dat
Writing C:\myfunctions\myMyFunctionProj\MyQueueTrigger\function.json

Ezeket a beállításokat a paranccsal is megadhatja a következő argumentumok használatával:You can also specify these options in the command using the following arguments:

ArgumentumArgument LeírásDescription
--csx (2. x verzió) Ugyanazokat C# a szkripteket (. CSX) hozza létre, amelyek az 1. x verzióban és a portálon használatosak.(Version 2.x) Generates the same C# script (.csx) templates used in version 1.x and in the portal.
--language -l A sablon programozási nyelve, például C#, F#, vagy JavaScript.The template programming language, such as C#, F#, or JavaScript. Ez a beállítás az 1. x verzióban szükséges.This option is required in version 1.x. A 2. x verzióban ne használja ezt a kapcsolót, vagy válasszon olyan nyelvet, amely megfelel a munkavégző futtatókörnyezetnek.In version 2.x, do not use this option or choose a language that matches the worker runtime.
--name -n A függvény neve.The function name.
--template -t A func templates list paranccsal megtekintheti az elérhető sablonok teljes listáját az egyes támogatott nyelvekhez.Use the func templates list command to see the complete list of available templates for each supported language.

Ha például JavaScript HTTP-triggert szeretne létrehozni egyetlen parancsban, futtassa a következőt:For example, to create a JavaScript HTTP trigger in a single command, run:

func new --template "Http Trigger" --name MyHttpTrigger

Ha üzenetsor által aktivált függvényt szeretne létrehozni egyetlen parancsban, futtassa a következőt:To create a queue-triggered function in a single command, run:

func new --template "Queue Trigger" --name QueueTriggerJS

Függvények helyi futtatásaRun functions locally

Functions-projekt futtatásához futtassa a functions gazdagépet.To run a Functions project, run the Functions host. A gazdagép lehetővé teszi az eseményindítók használatát a projektben lévő összes függvénynél.The host enables triggers for all functions in the project.

2-es verzió. xVersion 2.x

A futtatókörnyezet 2. x verziójában a Start parancs a projekt nyelvétől függően változhat.In version 2.x of the runtime, the start command varies, depending on your project language.

C#C#

func start --build

JavaScriptJavaScript

func start

TypeScriptTypeScript

npm install
npm start     

1. x verzióVersion 1.x

A functions futtatókörnyezet 1. x verziójának a host parancsot kell megadnia, ahogy az alábbi példában is látható:Version 1.x of the Functions runtime requires the host command, as in the following example:

func host start

a func start a következő beállításokat támogatja:func start supports the following options:

BeállításOption LeírásDescription
--no-build A Futtatás előtt ne hozzon létre aktuális projektet.Do no build current project before running. Csak a DotNet-projektekhez.For dotnet projects only. Az alapértelmezett érték false (hamis).Default is set to false. Csak 2. x verzió.Version 2.x only.
--cert A titkos kulcsot tartalmazó. pfx-fájl elérési útja.The path to a .pfx file that contains a private key. Csak --useHttps esetében használatos.Only used with --useHttps. Csak 2. x verzió.Version 2.x only.
--cors-credentials A csak a cookie-k és a hitelesítési fejlécek használatának engedélyezése csak a 2. x verzióban.Allow cross-origin authenticated requests (i.e. cookies and the Authentication header) Version 2.x only.
--cors A CORS-eredetek vesszővel tagolt listája, szóközök nélkül.A comma-separated list of CORS origins, with no spaces.
--language-worker A nyelv feldolgozójának konfigurálásához szükséges argumentumok.Arguments to configure the language worker. Csak 2. x verzió.Version 2.x only.
--nodeDebugPort -n A csomópont-hibakereső által használandó port.The port for the node debugger to use. Alapértelmezett A Launch. JSON vagy a 5858 érték.Default: A value from launch.json or 5858. Csak 1. x verzió.Version 1.x only.
--password A jelszó vagy egy olyan fájl, amely egy. pfx fájl jelszavát tartalmazza.Either the password or a file that contains the password for a .pfx file. Csak --cert esetében használatos.Only used with --cert. Csak 2. x verzió.Version 2.x only.
--port -p A figyelni kívánt helyi port.The local port to listen on. Alapértelmezett érték: 7071.Default value: 7071.
--pause-on-error A folyamat bezárása előtt szüneteltesse a további adatokat.Pause for additional input before exiting the process. Csak akkor használható, ha egy integrált fejlesztői környezetből (IDE) indít alapszintű eszközöket.Used only when launching Core Tools from an integrated development environment (IDE).
--script-root --prefix A futtatni vagy telepíteni kívánt Function alkalmazás gyökeréhez tartozó elérési út megadására szolgál.Used to specify the path to the root of the function app that is to be run or deployed. Ez olyan lefordított projektek esetében használatos, amelyek a projektfájlok almappában hozhatók elő.This is used for compiled projects that generate project files into a subfolder. Ha például létrehoz egy C# Class Library-projektet, a Host. JSON, a local. Settings. JSON és a function. JSON fájlok egy olyan gyökérkönyvtárban jönnek létre, amelynek elérési útja például a MyProject/bin/Debug/netstandard2.0.For example, when you build a C# class library project, the host.json, local.settings.json, and function.json files are generated in a root subfolder with a path like MyProject/bin/Debug/netstandard2.0. Ebben az esetben az előtagot --script-root MyProject/bin/Debug/netstandard2.0 értékre állítsa be.In this case, set the prefix as --script-root MyProject/bin/Debug/netstandard2.0. Ez a Function alkalmazás gyökere, ha az Azure-ban fut.This is the root of the function app when running in Azure.
--timeout -t A függvények gazdagépének időtúllépése másodpercben.The timeout for the Functions host to start, in seconds. Alapértelmezett 20 másodperc.Default: 20 seconds.
--useHttps Kötés @no__t – 0 helyett http://localhost:{port} értékre.Bind to https://localhost:{port} rather than to http://localhost:{port}. Alapértelmezés szerint ez a beállítás megbízható tanúsítványt hoz létre a számítógépen.By default, this option creates a trusted certificate on your computer.

A functions-gazdagép indításakor a HTTP-triggert függvények URL-címét adja meg:When the Functions host starts, it outputs the URL of HTTP-triggered functions:

Found the following functions:
Host.Functions.MyHttpTrigger

Job host started
Http Function MyHttpTrigger: http://localhost:7071/api/MyHttpTrigger

Fontos

A helyileg futtatott hitelesítés nem kényszeríti ki a HTTP-végpontokat.When running locally, authentication isn't enforced for HTTP endpoints. Ez azt jelenti, hogy az összes helyi HTTP-kérelem authLevel = "anonymous"-ként van kezelve.This means that all local HTTP requests are handled as authLevel = "anonymous". További információkért lásd a http- kötést ismertető cikket.For more information, see the HTTP binding article.

Tesztelési adat átadása egy függvénynekPassing test data to a function

A függvények helyi teszteléséhez indítsa el a functions gazdagépet , és hívja meg a végpontokat a helyi kiszolgálón a HTTP-kérelmek használatával.To test your functions locally, you start the Functions host and call endpoints on the local server using HTTP requests. A hívott végpont a függvény típusától függ.The endpoint you call depends on the type of function.

Megjegyzés

A jelen témakörben szereplő példák a cURL eszközzel küldenek HTTP-kéréseket a terminálról vagy egy parancssorból.Examples in this topic use the cURL tool to send HTTP requests from the terminal or a command prompt. Az Ön által választott eszköz használatával HTTP-kéréseket küldhet a helyi kiszolgálónak.You can use a tool of your choice to send HTTP requests to the local server. A cURL eszköz alapértelmezés szerint a Linux-alapú rendszereken és a Windows 10-es Build 17063-es és újabb verzióiban érhető el.The cURL tool is available by default on Linux-based systems and Windows 10 build 17063 and later. A régebbi Windows rendszeren először le kell töltenie és telepítenie kell a curl eszközt.On older Windows, you must first download and install the cURL tool.

A tesztelési funkciókkal kapcsolatos általánosabb információkért lásd: stratégiák a kód teszteléséhez Azure functions.For more general information on testing functions, see Strategies for testing your code in Azure Functions.

A HTTP és a webhook által aktivált függvényekHTTP and webhook triggered functions

A következő végpontot hívja meg helyileg a HTTP és a webhook által aktivált függvények futtatásához:You call the following endpoint to locally run HTTP and webhook triggered functions:

http://localhost:{port}/api/{function_name}

Győződjön meg arról, hogy ugyanazt a kiszolgálónevet és portot használja, amelyet a functions-gazdagép figyel.Make sure to use the same server name and port that the Functions host is listening on. Ez a függvény gazdagépének indításakor generált kimenetben jelenik meg.You see this in the output generated when starting the Function host. Ezt az URL-címet bármely, az trigger által támogatott HTTP-módszerrel meghívhatja.You can call this URL using any HTTP method supported by the trigger.

A következő cURL-parancs elindítja a MyHttpTrigger Gyorsindítás függvényt egy GET kérelemből, a lekérdezési karakterláncban átadott Name paraméterrel.The following cURL command triggers the MyHttpTrigger quickstart function from a GET request with the name parameter passed in the query string.

curl --get http://localhost:7071/api/MyHttpTrigger?name=Azure%20Rocks

A következő példa ugyanazt a függvényt hívja meg a kérelem törzsében a post kérelem átadásakor:The following example is the same function called from a POST request passing name in the request body:

curl --request POST http://localhost:7071/api/MyHttpTrigger --data '{"name":"Azure Rocks"}'

A lekérdezési karakterláncban található adatok beolvasása egy böngészőből is elvégezhető.You can make GET requests from a browser passing data in the query string. Minden más HTTP-módszer esetében a cURL, a Hegedűs, a Poster vagy egy hasonló HTTP-tesztelési eszközt kell használnia.For all other HTTP methods, you must use cURL, Fiddler, Postman, or a similar HTTP testing tool.

Nem HTTP által aktivált függvényekNon-HTTP triggered functions

A HTTP-triggereken és webhookokon kívüli egyéb függvények esetében az adminisztrációs végpont meghívásával helyileg is tesztelheti a függvényeket.For all kinds of functions other than HTTP triggers and webhooks, you can test your functions locally by calling an administration endpoint. Ha ezt a végpontot egy HTTP POST-kérelemmel hívja meg a helyi kiszolgálón, a függvényt indítja el.Calling this endpoint with an HTTP POST request on the local server triggers the function. Szükség esetén a POST kérelem törzsében is elvégezheti a tesztelési célú adatellenőrzést.You can optionally pass test data to the execution in the body of the POST request. Ez a funkció hasonló a Azure Portal teszt lapjához.This functionality is similar to the Test tab in the Azure portal.

A nem HTTP-függvények elindításához a következő rendszergazdai végpontot kell meghívni:You call the following administrator endpoint to trigger non-HTTP functions:

http://localhost:{port}/admin/functions/{function_name}

Ahhoz, hogy egy függvény rendszergazdai végpontján át lehessen adni a tesztelési feladatokat, meg kell adnia a POST kérelem üzenet törzsében lévő összes adatát.To pass test data to the administrator endpoint of a function, you must supply the data in the body of a POST request message. Az üzenet törzsének a következő JSON-formátummal kell rendelkeznie:The message body is required to have the following JSON format:

{
    "input": "<trigger_input>"
}

A @no__t 0 érték a függvény által várt formátumú értékeket tartalmaz.The <trigger_input> value contains data in a format expected by the function. A következő cURL-példa egy QueueTriggerJS függvény BEJEGYZÉSe.The following cURL example is a POST to a QueueTriggerJS function. Ebben az esetben a bemenet egy karakterlánc, amely egyenértékű a várólistában várható üzenettel.In this case, the input is a string that is equivalent to the message expected to be found in the queue.

curl --request POST -H "Content-Type:application/json" --data '{"input":"sample queue data"}' http://localhost:7071/admin/functions/QueueTriggerJS

A func run parancs használata az 1. x verzióbanUsing the func run command in version 1.x

Fontos

A func run parancs nem támogatott az eszközök 2. x verziójában.The func run command is not supported in version 2.x of the tools. További információ: Azure functions futtatókörnyezet verzióinak megcélzása.For more information, see the topic How to target Azure Functions runtime versions.

A függvényeket közvetlenül is meghívhatja func run <FunctionName> használatával, és a függvény bemeneti adatokat is megadhat.You can also invoke a function directly by using func run <FunctionName> and provide input data for the function. Ez a parancs hasonló egy függvény futtatásához a Azure Portal teszt lapján.This command is similar to running a function using the Test tab in the Azure portal.

a func run a következő beállításokat támogatja:func run supports the following options:

BeállításOption LeírásDescription
--content -c Beágyazott tartalom.Inline content.
--debug -d A függvény futtatása előtt csatoljon egy hibakeresőt a gazdagéphez.Attach a debugger to the host process before running the function.
--timeout -t Várakozási idő (másodpercben), amíg a helyi függvények gazdagépe nem áll készen.Time to wait (in seconds) until the local Functions host is ready.
--file -f A tartalomként használandó fájlnév.The file name to use as content.
--no-interactive A nem kéri a bevitelt.Does not prompt for input. Automatizálási forgatókönyvek esetén hasznos.Useful for automation scenarios.

Ha például egy HTTP-triggert használó függvényt szeretne meghívni, és tartalmat kell átadnia, futtassa a következő parancsot:For example, to call an HTTP-triggered function and pass content body, run the following command:

func run MyHttpTrigger -c '{\"name\": \"Azure\"}'

Közzététel az Azure-banPublish to Azure

A Azure Functions Core Tools kétféle telepítési típust támogat: a Function-projektfájlok közvetlen üzembe helyezése a Function alkalmazásban a zip üzembe helyezésével és az Egyéni Docker-tároló üzembe helyezésével.The Azure Functions Core Tools supports two types of deployment: deploying function project files directly to your function app via Zip Deploy and deploying a custom Docker container. Már létre kell hoznia egy Function alkalmazást az Azure-előfizetésében, amelyre telepíteni fogja a kódot.You must have already created a function app in your Azure subscription, to which you'll deploy your code. A fordítást igénylő projekteket úgy kell felépíteni, hogy a bináris fájlok üzembe helyezhetők legyenek.Projects that require compilation should be built so that the binaries can be deployed.

A Project mappa olyan nyelvspecifikus fájlokat és címtárakat tartalmazhat, amelyeket nem lehet közzétenni.A project folder may contain language-specific files and directories that shouldn't be published. A kizárt elemek a legfelső szintű projekt mappában található. funcignore fájlban szerepelnek.Excluded items are listed in a .funcignore file in the root project folder.

Üzembe helyezés (projektfájlok)Deployment (project files)

Ha a helyi kódot egy Azure-beli Function alkalmazásban szeretné közzétenni, használja a publish parancsot:To publish your local code to a function app in Azure, use the publish command:

func azure functionapp publish <FunctionAppName>

Ez a parancs egy meglévő Function alkalmazásba tesz közzé az Azure-ban.This command publishes to an existing function app in Azure. Hibaüzenet jelenik meg, ha olyan <FunctionAppName>-ra próbál közzétenni, amely nem létezik az előfizetésében.You'll get an error if you try to publish to a <FunctionAppName> that doesn't exist in your subscription. Ha szeretné megtudni, hogyan hozhat létre egy Function alkalmazást a parancssorból vagy a terminál ablakból az Azure CLI használatával, tekintse meg a Függvényalkalmazás létrehozása kiszolgáló nélküli végrehajtáshozcímű témakört.To learn how to create a function app from the command prompt or terminal window using the Azure CLI, see Create a Function App for serverless execution. Alapértelmezés szerint a parancs üzembe helyezi az alkalmazást a központi telepítési csomagból való futtatásra.By default, this command deploys your app to run from the deployment package. Az ajánlott telepítési mód letiltásához használja a --nozip kapcsolót.To disable this recommended deployment mode, use the --nozip option.

Fontos

Ha a Azure Portalban hoz létre egy Function alkalmazást, a függvény alapértelmezés szerint a Function Runtime 2. x verzióját használja.When you create a function app in the Azure portal, it uses version 2.x of the Function runtime by default. Ha azt szeretné, hogy a Function app a futtatókörnyezet 1. x verzióját használja, kövesse az 1. x verzió futtatásánakutasításait.To make the function app use version 1.x of the runtime, follow the instructions in Run on version 1.x. Egy meglévő függvényt tartalmazó Function alkalmazás futásidejű verziója nem módosítható.You can't change the runtime version for a function app that has existing functions.

A következő közzétételi beállítások mindkét verzióra érvényesek: 1. x és 2. x.The following publish options apply for both versions, 1.x and 2.x:

BeállításOption LeírásDescription
--publish-local-settings -i A beállítások közzététele a local. Settings. JSON fájlban az Azure-ba, ha a beállítás már létezik, a rendszer megkéri a felülírásra.Publish settings in local.settings.json to Azure, prompting to overwrite if the setting already exists. Ha a Storage emulatort használja, először módosítsa az alkalmazás beállításait egy tényleges Storage-kapcsolatban.If you are using the storage emulator, first change the app setting to an actual storage connection.
--overwrite-settings -y Ha --publish-local-settings -i van használatban, hagyja figyelmen kívül az Alkalmazásbeállítások felülírására vonatkozó kérést.Suppress the prompt to overwrite app settings when --publish-local-settings -i is used.

A következő közzétételi beállítások csak a 2. x verzióban támogatottak:The following publish options are only supported in version 2.x:

BeállításOption LeírásDescription
--publish-settings-only -o Csak a beállítások közzététele és a tartalom kihagyása.Only publish settings and skip the content. Az alapértelmezett érték a prompt.Default is prompt.
--list-ignored-files A közzététel során figyelmen kívül hagyott fájlok listáját jeleníti meg, amely a. funcignore fájlon alapul.Displays a list of files that are ignored during publishing, which is based on the .funcignore file.
--list-included-files A közzétett fájlok listáját jeleníti meg, amely a. funcignore fájlon alapul.Displays a list of files that are published, which is based on the .funcignore file.
--nozip Kikapcsolja az alapértelmezett Run-From-Package üzemmódot.Turns the default Run-From-Package mode off.
--build-native-deps Kihagyja a generálás. Wheels mappát a Python-függvények alkalmazásainak közzétételekor.Skips generating .wheels folder when publishing python function apps.
--additional-packages A natív függőségek kiépítésekor telepítendő csomagok listája.List of packages to install when building native dependencies. Például: python3-dev libevent-dev.For example: python3-dev libevent-dev.
--force Bizonyos helyzetekben figyelmen kívül hagyhatja a közzététel előtti ellenőrzést.Ignore pre-publishing verification in certain scenarios.
--csx C# Parancsfájl-(. CSX) projekt közzététele.Publish a C# script (.csx) project.
--no-build A DotNet-függvények felépítése kihagyható.Skip building dotnet functions.
--dotnet-cli-params A lefordított C# (. csproj) függvények közzétételekor a Core Tools a "DotNet Build-output bin/publish" metódust hívja meg.When publishing compiled C# (.csproj) functions, the core tools calls 'dotnet build --output bin/publish'. Az erre átadott paraméterek a parancssorhoz lesznek hozzáfűzve.Any parameters passed to this will be appended to the command line.

Üzembe helyezés (egyéni tároló)Deployment (custom container)

Azure Functions lehetővé teszi a Function projekt üzembe helyezését egy Egyéni Docker-tárolóban.Azure Functions lets you deploy your function project in a custom Docker container. További információkért lásd: függvény létrehozása Linuxon egyéni rendszerkép használatával.For more information, see Create a function on Linux using a custom image. Az egyéni tárolók Docker kell rendelkezniük.Custom containers must have a Dockerfile. Ha Docker szeretne létrehozni egy alkalmazást, használja a--Docker kapcsolót a következőn: func init.To create an app with a Dockerfile, use the --dockerfile option on func init.

func deploy

A következő egyéni tároló üzembe helyezési lehetőségei érhetők el:The following custom container deployment options are available:

BeállításOption LeírásDescription
--registry Annak a Docker-beállításjegyzéknek a neve, amelyre az aktuális felhasználó bejelentkezett.The name of a Docker Registry the current user signed-in to.
--platform Üzemeltetési platform a Function alkalmazáshoz.Hosting platform for the function app. Az érvényes beállítások a következők: kubernetesValid options are kubernetes
--name Function alkalmazás neve.Function app name.
--max Igény szerint beállíthatja a alkalmazásban telepítendő Function app-példányok maximális számát.Optionally, sets the maximum number of function app instances to deploy to.
--min Igény szerint beállíthatja az alkalmazásban telepítendő Function app-példányok minimális számát.Optionally, sets the minimum number of function app instances to deploy to.
--config Egy opcionális telepítési konfigurációs fájl beállítása.Sets an optional deployment configuration file.

Figyelési függvényekMonitoring functions

A függvények végrehajtásának ajánlott figyelése az Azure Application Insights integrálásával történik.The recommended way to monitor the execution of your functions is by integrating with Azure Application Insights. A végrehajtási naplókat a helyi számítógépre is továbbíthatja.You can also stream execution logs to your local computer. További információért lásd: Azure functions figyelése.To learn more, see Monitor Azure Functions.

Application Insights integráció engedélyezéseEnable Application Insights integration

Ha a Azure Portalban hoz létre egy Function alkalmazást, a rendszer alapértelmezés szerint a Application Insights-integrációt végzi.When you create a function app in the Azure portal, the Application Insights integration is done for you by default. Ha azonban az Azure CLI használatával hozza létre a Function alkalmazást, az Azure-beli Function alkalmazásban nem történik meg az integráció.However, when you create your function app by using the Azure CLI, the integration in your function app in Azure isn't done.

A függvények megkönnyítik Application Insights integráció hozzáadását egy Function-alkalmazáshoz a Azure Portal.Functions makes it easy to add Application Insights integration to a function app from the Azure portal.

  1. A portálválassza a minden szolgáltatás > Function appslehetőséget, válassza ki a Function alkalmazást, majd válassza az ablak tetején található Application Insights szalagcímet.In the portal, select All services > Function Apps, select your function app, and then select the Application Insights banner at the top of the window

    Application Insights engedélyezése a portálról

  2. Hozzon létre egy Application Insights erőforrást a rendszerkép alatti táblázatban megadott beállítások használatával.Create an Application Insights resource by using the settings specified in the table below the image.

    Application Insights-erőforrás létrehozása

    BeállításSetting Ajánlott értékSuggested value LeírásDescription
    NameName Egyedi alkalmazás neveUnique app name A legegyszerűbb, ha ugyanazt a nevet használja, mint a Function alkalmazás, amelynek egyedinek kell lennie az előfizetésében.It's easiest to use the same name as your function app, which must be unique in your subscription.
    LocationLocation Nyugat-EurópaWest Europe Ha lehetséges, használja ugyanazt a régiót , mint a Function alkalmazás, vagy pedig az adott régióhoz közeledik.If possible, use the same region as your function app, or one that's close to that region.
  3. Kattintson az OK gombra.Select OK. A Application Insights erőforrás ugyanabban az erőforráscsoportban és előfizetésben jön létre, mint a Function alkalmazás.The Application Insights resource is created in the same resource group and subscription as your function app. Az erőforrás létrehozása után zárjuk be a Application Insights ablakot.After the resource is created, close the Application Insights window.

  4. Lépjen vissza a Function alkalmazásba, válassza az Alkalmazásbeállításoklehetőséget, majd görgessen le az Alkalmazásbeállítások menüponthoz.Back in your function app, select Application settings, and then scroll down to Application settings. Ha megjelenik egy nevű APPINSIGHTS_INSTRUMENTATIONKEYbeállítás, Application Insights integráció engedélyezve van az Azure-ban futó Function-alkalmazáshoz.If you see a setting named APPINSIGHTS_INSTRUMENTATIONKEY, Application Insights integration is enabled for your function app running in Azure.

Folyamatos átviteli naplók engedélyezéseEnable streaming logs

Megtekintheti a függvények által a helyi számítógépen lévő parancssori munkamenetben létrehozott naplófájlok streamjét.You can view a stream of log files being generated by your functions in a command-line session on your local computer.

Natív adatfolyam-naplókNative streaming logs

Beépített log streamingBuilt-in log streaming

Az Azure logstream -ban futó adott Function app-beli adatfolyam-naplók fogadásának megkezdéséhez használja a következő példát:Use the logstream option to start receiving streaming logs of a specific function app running in Azure, as in the following example:

func azure functionapp logstream <FunctionAppName>

Élő metrikastreamLive Metrics Stream

A Function alkalmazáshoz tartozó élő metrikastream egy új böngészőablakban is megtekintheti a --browser lehetőséggel együtt, az alábbi példában látható módon:You can also view the Live Metrics Stream for your function app in a new browser window by including the --browser option, as in the following example:

func azure functionapp logstream <FunctionAppName> --browser

Az ilyen típusú folyamatos átviteli naplókhoz engedélyeznie kell Application Insights integrációját a Function alkalmazáshoz.This type of streaming logs requires that you enable Application Insights integration for your function app.

További lépésekNext steps

A Azure Functions Core Tools nyílt forráskódú, és a githubon fut.Azure Functions Core Tools is open source and hosted on GitHub.
Egy hiba vagy szolgáltatás kérésének megkereséséhez Nyisson meg egy GitHub-problémát.To file a bug or feature request, open a GitHub issue.