Werken met Azure Functions Core ToolsWork with Azure Functions Core Tools

Met Azure Functions Core Tools kunt u uw functies op de lokale computer ontwikkelen en testen vanaf de opdracht prompt of Terminal.Azure Functions Core Tools lets you develop and test your functions on your local computer from the command prompt or terminal. Uw lokale functies kunnen verbinding maken met Live Azure-Services, en u kunt fouten opsporen in uw functies op uw lokale computer met behulp van de volledige functions-runtime.Your local functions can connect to live Azure services, and you can debug your functions on your local computer using the full Functions runtime. U kunt zelfs een functie-app implementeren in uw Azure-abonnement.You can even deploy a function app to your Azure subscription.

Belangrijk

Geen verschillende lokale ontwikkeling met portal-ontwikkeling in dezelfde functie-app.Do not mix local development with portal development in the same function app. Wanneer u maken en publiceren van functies in een lokale-project, moet u niet proberen te onderhouden of projectcode in de portal wijzigen.When you create and publish functions from a local project, you should not try to maintain or modify project code in the portal.

Het ontwikkelen van functies op uw lokale computer en het publiceren van deze naar Azure met behulp van kern Hulpprogramma's volgt deze basis stappen:Developing functions on your local computer and publishing them to Azure using Core Tools follows these basic steps:

Kern Hulpprogramma's versiesCore Tools versions

Er zijn twee versies van Azure Functions Core Tools.There are two versions of Azure Functions Core Tools. Welke versie u gebruikt, is afhankelijk van uw lokale ontwikkel omgeving, de keuze van de taalen het vereiste ondersteunings niveau:The version you use depends on your local development environment, choice of language, and level of support required:

  • Versie 1. x: ondersteunt versie 1. x van de runtime.Version 1.x: supports version 1.x of the runtime. Deze versie van de hulpprogram ma's wordt alleen ondersteund op Windows-computers en wordt geïnstalleerd vanuit een NPM-pakket.This version of the tools is only supported on Windows computers and is installed from an npm package. Met deze versie kunt u functies maken in experimentele talen die niet officieel worden ondersteund.With this version, you can create functions in experimental languages that are not officially supported. Zie ondersteunde talen in azure functions voor meer informatie.For more information, see Supported languages in Azure Functions

  • Versie 2. x: ondersteunt versie 2. x van de runtime.Version 2.x: supports version 2.x of the runtime. Deze versie biedt ondersteuning voor Windows, macOSen Linux.This version supports Windows, macOS, and Linux. Maakt gebruik van platformspecifieke pakket beheerders of NPM voor installatie.Uses platform-specific package managers or npm for installation.

Tenzij anders vermeld, zijn de voor beelden in dit artikel van versie 2. x.Unless otherwise noted, the examples in this article are for version 2.x.

Azure Functions Core Tools installerenInstall the Azure Functions Core Tools

Azure functions core tools bevat een versie van dezelfde runtime die voorziet in azure functions runtime die u kunt uitvoeren op uw lokale ontwikkel computer.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. Het bevat ook opdrachten voor het maken van functies, verbinding maken met Azure en functie projecten implementeren.It also provides commands to create functions, connect to Azure, and deploy function projects.

Versie 2. xVersion 2.x

Versie 2. x van de hulpprogram ma's maakt gebruik van de Azure Functions runtime 2. x die is gebouwd op .NET core.Version 2.x of the tools uses the Azure Functions runtime 2.x that is built on .NET Core. Deze versie wordt ondersteund op alle platformen .NET Core 2. x ondersteunt, waaronder Windows, macOSen Linux.This version is supported on all platforms .NET Core 2.x supports, including Windows, macOS, and Linux.

Belangrijk

U kunt de vereiste voor het installeren van de .NET Core 2. x SDK overs Laan door gebruik te maken van uitbreidings bundels.You can bypass the requirement for installing the .NET Core 2.x SDK by using extension bundles.

WindowsWindows

In de volgende stappen wordt NPM gebruikt om de belangrijkste Hulpprogram Ma's in Windows te installeren.The following steps use npm to install Core Tools on Windows. U kunt ook Choco ladegebruiken.You can also use Chocolatey. Zie het Leesmij-bestand met belangrijkste Hulpprogram ma'svoor meer informatie.For more information, see the Core Tools readme.

  1. Installeer Node.js, dat NPM omvat.Install Node.js, which includes npm. Voor versie 2. x van de hulpprogram ma's worden alleen node. js 8,5 en latere versies ondersteund.For version 2.x of the tools, only Node.js 8.5 and later versions are supported.

  2. Installeer het pakket met kern Hulpprogramma's:Install the Core Tools package:

    npm install -g azure-functions-core-tools
    

    Het kan enkele minuten duren voordat NPM het pakket met kern Hulpprogramma's downloadt en installeert.It may take a few minutes for npm to download and install the Core Tools package.

  3. Als u geen uitbreidings bundelswilt gebruiken, installeert u de .net Core 2. x SDK voor Windows.If you do not plan to use extension bundles, install the .NET Core 2.x SDK for Windows.

MacOS met HomebrewMacOS with Homebrew

In de volgende stappen wordt homebrew gebruikt om de belangrijkste Hulpprogram Ma's voor macOS te installeren.The following steps use Homebrew to install the Core Tools on macOS.

  1. Installeer homebrewals dit nog niet is gebeurd.Install Homebrew, if it's not already installed.

  2. Installeer het pakket met kern Hulpprogramma's:Install the Core Tools package:

    brew tap azure/functions
    brew install azure-functions-core-tools
    
  3. Als u geen uitbreidings bundelswilt gebruiken, installeert u .net Core 2. x SDK voor macOS.If you do not plan to use extension bundles, install .NET Core 2.x SDK for macOS.

Linux (Ubuntu/Debian) met APTLinux (Ubuntu/Debian) with APT

De volgende stappen gebruiken apt om kern hulpprogramma's te installeren op uw Ubuntu/Debian Linux-distributie.The following steps use APT to install Core Tools on your Ubuntu/Debian Linux distribution. Raadpleeg het Leesmij-bestand voor de belangrijkste Hulpprogram ma'svoor andere Linux-distributies.For other Linux distributions, see the Core Tools readme.

  1. Installeer de micro soft package repository GPG-sleutel om de pakket integriteit te valideren: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. Controleer of op uw Ubuntu-server een van de juiste versies uit de onderstaande tabel wordt uitgevoerd.Verify your Ubuntu server is running one of the appropriate versions from the table below. Voer de volgende handelingen uit om de apt-bron toe te voegen:To add the apt source, run:

    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'
    sudo apt-get update
    
    Linux-distributieLinux distribution VersionVersion
    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
  3. Installeer het pakket met kern Hulpprogramma's:Install the Core Tools package:

    sudo apt-get install azure-functions-core-tools
    
  4. Als u niet van plan bent om uitbreidings bundelste gebruiken, installeert u .net Core 2. x SDK voor Linux.If you do not plan to use extension bundles, install .NET Core 2.x SDK for Linux.

Een lokaal Functions-project makenCreate a local Functions project

Een project directory functions bevat de bestanden host. json en Local. settings. json, samen met submappen die de code voor afzonderlijke functies bevatten.A functions project directory contains the files host.json and local.settings.json, along with subfolders that contain the code for individual functions. Deze map is het equivalent van een functie-app in Azure.This directory is the equivalent of a function app in Azure. Zie de hand leiding voor de Azure functions-ontwikkel aarsvoor meer informatie over de mapstructuur van de functies.To learn more about the Functions folder structure, see the Azure Functions developers guide.

Versie 2. x vereist dat u een standaard taal voor het project selecteert wanneer deze wordt geïnitialiseerd en alle functies worden toegevoegd standaard taal sjablonen gebruiken.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. In versie 1. x geeft u de taal op telkens wanneer u een functie maakt.In version 1.x, you specify the language each time you create a function.

Voer in het Terminal venster of vanaf een opdracht prompt de volgende opdracht uit om het project en de lokale Git-opslag plaats te maken:In the terminal window or from a command prompt, run the following command to create the project and local Git repository:

func init MyFunctionProj

Wanneer u een project naam opgeeft, wordt een nieuwe map met die naam gemaakt en geïnitialiseerd.When you provide a project name, a new folder with that name is created and initialized. Anders wordt de huidige map geïnitialiseerd.Otherwise, the current folder is initialized.
In versie 2. x, wanneer u de opdracht uitvoert, moet u een runtime voor uw project kiezen.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)

Gebruik de pijl omhoog/omlaag om een taal te kiezen en druk vervolgens op ENTER.Use the up/down arrow keys to choose a language, then press Enter. Als u van plan bent java script-of type script-functies te ontwikkelen, kiest u knoop punten selecteert u vervolgens de taal.If you plan to develop JavaScript or TypeScript functions, choose node, and then select the language. Type script heeft een aantal aanvullende vereisten.TypeScript has some additional requirements.

De uitvoer ziet eruit als in het volgende voor beeld voor een Java script-project: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/

func initbiedt ondersteuning voor de volgende opties: versie 2. x-only, tenzij anders vermeld.func init supports the following options, which are version 2.x-only, unless otherwise noted:

OptieOption DescriptionDescription
--csx Initialiseert een C# script-project (. CSX).Initializes a C# script (.csx) project. U moet in --csx volgende opdrachten opgeven.You must specify --csx in subsequent commands.
--docker Maak een Dockerfile voor een container met behulp van een basis installatie kopie op basis --worker-runtimevan de gekozen.Create a Dockerfile for a container using a base image that is based on the chosen --worker-runtime. Gebruik deze optie wanneer u van plan bent om te publiceren naar een aangepaste Linux-container.Use this option when you plan to publish to a custom Linux container.
--force Initialiseer het project zelfs wanneer er bestaande bestanden in het project aanwezig zijn.Initialize the project even when there are existing files in the project. Deze instelling overschrijft bestaande bestanden met dezelfde naam.This setting overwrites existing files with the same name. Andere bestanden in de projectmap worden niet beïnvloed.Other files in the project folder aren't affected.
--no-source-control -n Hiermee wordt voor komen dat een Git-opslag plaats standaard wordt gemaakt in versie 1. x.Prevents the default creation of a Git repository in version 1.x. In versie 2. x wordt de Git-opslag plaats standaard niet gemaakt.In version 2.x, the git repository isn't created by default.
--source-control Hiermee wordt bepaald of een Git-opslag plaats wordt gemaakt.Controls whether a git repository is created. Een opslag plaats wordt standaard niet gemaakt.By default, a repository isn't created. Wanneer truewordt een opslag plaats gemaakt.When true, a repository is created.
--worker-runtime Hiermee stelt u de taal runtime voor het project in.Sets the language runtime for the project. Ondersteunde waarden zijn dotnet, node (Java script) java, en python.Supported values are dotnet, node (JavaScript), java, and python. Wanneer deze niet is ingesteld, wordt u gevraagd uw runtime te kiezen tijdens de initialisatie.When not set, you are prompted to choose your runtime during initialization.

Belangrijk

Versie 2. x van de kern hulpprogramma's maakt standaard functie-app-projecten voor .NET runtime als C# class-projecten (. csproj).By default, version 2.x of the Core Tools creates function app projects for the .NET runtime as C# class projects (.csproj). Deze C# projecten, die kunnen worden gebruikt met Visual Studio of Visual Studio code, worden gecompileerd tijdens het testen en bij het publiceren naar Azure.These C# projects, which can be used with Visual Studio or Visual Studio Code, are compiled during testing and when publishing to Azure. Als u in plaats daarvan dezelfde C# script bestanden (. CSX) wilt maken en gebruiken die zijn gemaakt in versie 1. x en in de portal, moet u de --csx para meter toevoegen wanneer u functies maakt en implementeert.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.

Extensies registrerenRegister extensions

Functies met uitzondering van de HTTP- en timer wordt geactiveerd, bindingen in runtimeversie 2.x worden geïmplementeerd als extensiepakketten.With the exception of HTTP and timer triggers, Functions bindings in runtime version 2.x are implemented as extension packages. In versie 2.x van de Azure Functions-runtime die u moet expliciet de extensies voor de bindingstypen gebruikt in uw functies te registreren.In version 2.x of the Azure Functions runtime, you have to explicitly register the extensions for the binding types used in your functions. De uitzonderingen op deze zijn HTTP-bindingen en timer wordt geactiveerd, waarvoor geen extensies vereist.The exceptions to this are HTTP bindings and timer triggers, which do not require extensions.

U kunt bindinguitbreidingen afzonderlijk installeren of u een extensie-bundel-verwijzing naar het projectbestand host.json kunt toevoegen.You can choose to install binding extensions individually, or you can add an extension bundle reference to the host.json project file. Extensie-bundels Hiermee verwijdert u de kans op pakket compatibiliteitsproblemen bij het gebruik van meerdere bindingstypen.Extension bundles removes the chance of having package compatibility issues when using multiple binding types. Het is de aanbevolen aanpak voor het registreren van de bindinguitbreidingen.It is the recommended approach for registering binding extensions. Extensie bundels verwijdert ook de vereiste van het installeren van de .NET Core SDK 2.x.Extension bundles also removes the requirement of installing the .NET Core 2.x SDK.

extensie-bundelsExtension bundles

De eenvoudigste manier om bindings uitbreidingen te installeren is door uitbreidings bundelsin te scha kelen.The easiest way to install binding extensions is to enable extension bundles. Wanneer u bundels inschakelt, wordt automatisch een vooraf gedefinieerde set uitbreidings pakketten geïnstalleerd.When you enable bundles, a predefined set of extension packages is automatically installed.

Als u uitbreidings bundels wilt inschakelen, opent u het bestand host. json en werkt u de inhoud bij zodat deze overeenkomt met de volgende code: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)"
    }
}

Zie voor meer informatie, registreren Azure Functions-bindinguitbreidingen.To learn more, see Register Azure Functions binding extensions. Voordat u de bindingen aan het bestand functions.json toevoegen, moet u de extensie bundels toevoegen aan de host.json.You should add extension bundles to the host.json before you add bindings to the functions.json file.

Afzonderlijke uitbreidingen registrerenRegister individual extensions

Als u nodig hebt voor het installeren van extensies die zich niet in een bundel, kunt u afzonderlijke extensiepakketten voor specifieke bindingen handmatig registreren.If you need to install extensions that aren't in a bundle, you can manually register individual extension packages for specific bindings.

Notitie

Extensies handmatig registreren met behulp van func extensions install, hebt u de .NET Core 2.x SDK is geïnstalleerd.To manually register extensions by using func extensions install, you must have the .NET Core 2.x SDK installed.

Nadat u hebt bijgewerkt uw function.json bestand om op te nemen van de bindingen die uw functie nodig heeft, voer de volgende opdracht uit in de projectmap.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

De opdracht leest de function.json bestand om te zien welke pakketten die u nodig hebt, worden ze geïnstalleerd en wordt het project extensies.The command reads the function.json file to see which packages you need, installs them, and rebuilds the extensions project. Voegt een nieuwe bindingen toe op de huidige versie, maar wordt de bestaande bindingen niet bijgewerkt.It adds any new bindings at the current version but does not update existing bindings. Gebruik de --force optie bestaande bindingen bijwerken naar de meest recente versie bij het installeren van nieuwe labels.Use the --force option to update existing bindings to the latest version when installing new ones.

Lokale instellingsbestandLocal settings file

In het bestand local. settings. json worden de app-instellingen, verbindings reeksen en instellingen opgeslagen die worden gebruikt door de lokale ontwikkelingsprogram ma's.The local.settings.json file stores app settings, connection strings, and settings used by local development tools. Instellingen in het bestand local. settings. json worden alleen gebruikt wanneer u projecten lokaal uitvoert.Settings in the local.settings.json file are used only when you're running projects locally. Het lokale instellingen bestand heeft deze structuur: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>"
  }
}

Deze instellingen worden ondersteund wanneer u projecten lokaal uitvoert:These settings are supported when you run projects locally:

InstellingSetting DescriptionDescription
IsEncrypted Als deze instelling is ingesteld op true, worden alle waarden versleuteld met een lokale computer sleutel.When this setting is set to true, all values are encrypted with a local machine key. Wordt gebruikt func settings met opdrachten.Used with func settings commands. De standaard waarde falseis.Default value is false.
Values Matrix van toepassings instellingen en verbindings reeksen die worden gebruikt wanneer een project lokaal wordt uitgevoerd.Array of application settings and connection strings used when a project is running locally. Deze combi natie van sleutel waarden (string-string) komt overeen met de toepassings instellingen in uw functie-app AzureWebJobsStoragein azure, zoals.These key-value (string-string) pairs correspond to application settings in your function app in Azure, like AzureWebJobsStorage. Veel triggers en bindingen hebben een eigenschap die verwijst naar een Connection String app-instelling, Connection zoals voor de Blob Storage-trigger.Many triggers and bindings have a property that refers to a connection string app setting, like Connection for the Blob storage trigger. Voor deze eigenschappen hebt u een toepassings instelling nodig die in de Values matrix is gedefinieerd.For these properties, you need an application setting defined in the Values array.
AzureWebJobsStorageis een vereiste app-instelling voor andere triggers dan HTTP.AzureWebJobsStorage is a required app setting for triggers other than HTTP.
Versie 2. x van de functions runtime vereist deFUNCTIONS_WORKER_RUNTIMEinstelling [], die voor uw project wordt gegenereerd door kern hulpprogramma's.Version 2.x of the Functions runtime requires the [FUNCTIONS_WORKER_RUNTIME] setting, which is generated for your project by Core Tools.
Wanneer u de Azure Storage-emulator lokaal hebt geïnstalleerd en hebt AzureWebJobsStorage ingesteld UseDevelopmentStorage=trueop, maakt de kern hulpprogramma's gebruik van de emulator.When you have the Azure storage emulator installed locally and you set AzureWebJobsStorage to UseDevelopmentStorage=true, Core Tools uses the emulator. De emulator is handig tijdens de ontwikkeling, maar u moet eerst een echte opslag verbinding testen voordat u de implementatie kunt uitvoeren.The emulator is useful during development, but you should test with an actual storage connection before deployment.
Waarden moeten teken reeksen en geen JSON-objecten of matrices zijn.Values must be strings and not JSON objects or arrays. Namen van instellingen mogen geen dubbele punt:() of een dubbel onderstrepen__() bevatten.Setting names can't include a colon (:) or a double underline (__). Deze tekens zijn gereserveerd door de runtime.These characters are reserved by the runtime.
Host Met de instellingen in deze sectie wordt het hostproces voor functies aangepast wanneer u projecten lokaal uitvoert.Settings in this section customize the Functions host process when you run projects locally. Deze instellingen zijn gescheiden van de host. json-instellingen, die ook van toepassing zijn wanneer u projecten in azure uitvoert.These settings are separate from the host.json settings, which also apply when you run projects in Azure.
LocalHttpPort Hiermee stelt u de standaard poort in die wordt gebruikt voor hetfunc host start uitvoeren func runvan de lokale functions-host (en).Sets the default port used when running the local Functions host (func host start and func run). De --port opdracht regel optie heeft voor rang op deze instelling.The --port command-line option takes precedence over this setting.
CORS Hiermee worden de oorsprong gedefinieerd die zijn toegestaan voor het delen van cross-Origin-resources (CORS).Defines the origins allowed for cross-origin resource sharing (CORS). Oorsprongen worden geleverd als een door komma's gescheiden lijst zonder spaties.Origins are supplied as a comma-separated list with no spaces. De waarde van het*Joker teken () wordt ondersteund, waardoor aanvragen van elke oorsprong worden toegestaan.The wildcard value (*) is supported, which allows requests from any origin.
CORSCredentials Als deze is trueingesteld op withCredentials , worden aanvragen toegestaan.When set to true, allows withCredentials requests.
ConnectionStrings Een verzameling.A collection. Gebruik deze verzameling niet voor de verbindings reeksen die worden gebruikt door uw functie bindingen.Don't use this collection for the connection strings used by your function bindings. Deze verzameling wordt alleen gebruikt door frameworks die meestal verbindings reeksen ophalen uit de ConnectionStrings sectie van een configuratie bestand, zoals Entity Framework.This collection is used only by frameworks that typically get connection strings from the ConnectionStrings section of a configuration file, like Entity Framework. Verbindings reeksen in dit object worden toegevoegd aan de omgeving met het provider type System. data. SqlClient.Connection strings in this object are added to the environment with the provider type of System.Data.SqlClient. Items in deze verzameling worden niet naar Azure gepubliceerd met andere app-instellingen.Items in this collection aren't published to Azure with other app settings. U moet deze waarden expliciet toevoegen aan de Connection strings verzameling van de instellingen van de functie-app.You must explicitly add these values to the Connection strings collection of your function app settings. Als u een SqlConnection in uw functie code maakt, moet u de Connection String waarde opslaan met uw andere verbindingen in Toepassings instellingen in de portal.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.

Deze instellingen worden standaard niet automatisch gemigreerd wanneer het project wordt gepubliceerd naar Azure.By default, these settings are not migrated automatically when the project is published to Azure. Gebruik de --publish-local-settings switch Wanneer u publiceert om ervoor te zorgen dat deze instellingen worden toegevoegd aan de functie-app in Azure.Use the --publish-local-settings switch when you publish to make sure these settings are added to the function app in Azure. Houd er rekening mee dat waarden in Connections Tring nooit worden gepubliceerd.Note that values in ConnectionStrings are never published.

De waarden van de functie-app-instellingen kunnen ook in uw code worden gelezen als omgevings variabelen.The function app settings values can also be read in your code as environment variables. Zie de sectie omgevings variabelen van deze taalspecifieke naslag onderwerpen voor meer informatie:For more information, see the Environment variables section of these language-specific reference topics:

Als er geen geldige opslag Connection String is ingesteld AzureWebJobsStorage voor en de emulator niet wordt gebruikt, wordt het volgende fout bericht weer gegeven:When no valid storage connection string is set for AzureWebJobsStorage and the emulator isn't being used, the following error message is shown:

Ontbrekende waarde voor AzureWebJobsStorage in Local. settings. json.Missing value for AzureWebJobsStorage in local.settings.json. Dit is vereist voor alle triggers behalve HTTP.This is required for all triggers other than HTTP. U kunt func Azure functionapp fetch-app-Settings <functionAppName>uitvoeren of een Connection String in Local. settings. json opgeven.You can run 'func azure functionapp fetch-app-settings <functionAppName>' or specify a connection string in local.settings.json.

Uw opslag verbindings reeksen ophalenGet your storage connection strings

Zelfs wanneer u de opslag emulator gebruikt voor ontwikkeling, wilt u wellicht testen met een echte opslag verbinding.Even when using the storage emulator for development, you may want to test with an actual storage connection. Ervan uitgaande dat u al een opslag account hebt gemaakt, kunt u op een van de volgende manieren een geldig opslag Connection String krijgen:Assuming you have already created a storage account, you can get a valid storage connection string in one of the following ways:

  • Van de Azure-portal.From the Azure portal. Navigeer naar uw opslag account, selecteer toegangs sleutels in instellingenen kopieer een van de verbindings reeks waarden.Navigate to your storage account, select Access keys in Settings, then copy one of the Connection string values.

    connection string kopiëren van Azure Portal

  • Gebruik Azure Storage Explorer om verbinding te maken met uw Azure-account.Use Azure Storage Explorer to connect to your Azure account. Vouw in de Exploreruw abonnement uit, selecteer uw opslag account en kopieer de primaire of secundaire Connection String.In the Explorer, expand your subscription, select your storage account, and copy the primary or secondary connection string.

    connection string kopiëren van Storage Explorer

  • Gebruik de basis Hulpprogramma's om de connection string te downloaden van Azure met een van de volgende opdrachten:Use Core Tools to download the connection string from Azure with one of the following commands:

    • Alle instellingen van een bestaande functie-app downloaden:Download all settings from an existing function app:

      func azure functionapp fetch-app-settings <FunctionAppName>
      
    • De verbindings reeks ophalen voor een specifiek opslag account:Get the Connection string for a specific storage account:

      func azure storage fetch-connection-string <StorageAccountName>
      

      Wanneer u nog niet bent aangemeld bij Azure, wordt u gevraagd dit te doen.When you are not already signed in to Azure, you are prompted to do so.

Een functie makenCreate a function

Voer de volgende opdracht uit om een functie te maken:To create a function, run the following command:

func new

In versie 2. x, wanneer u uitvoert func new , wordt u gevraagd een sjabloon in de standaard taal van uw functie-app te kiezen. vervolgens wordt u gevraagd om een naam voor de functie te kiezen.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. In versie 1. x wordt u ook gevraagd om de taal te kiezen.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

Functie code wordt gegenereerd in een submap met de naam van de geleverde functie, zoals u kunt zien in de volgende uitvoer van de wachtrij trigger: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

U kunt deze opties ook opgeven in de opdracht met behulp van de volgende argumenten:You can also specify these options in the command using the following arguments:

ArgumentArgument DescriptionDescription
--csx (Versie 2. x) Hiermee worden dezelfde C# script-sjablonen (. CSX) gegenereerd die worden gebruikt in versie 1. x en in de portal.(Version 2.x) Generates the same C# script (.csx) templates used in version 1.x and in the portal.
--language -l De programmeer taal van de sjabloon, C#zoals F#, of Java script.The template programming language, such as C#, F#, or JavaScript. Deze optie is vereist in versie 1. x.This option is required in version 1.x. In versie 2. x gebruikt u deze optie niet of kiest u een taal die overeenkomt met de runtime van de werk nemer.In version 2.x, do not use this option or choose a language that matches the worker runtime.
--name -n De functie naam.The function name.
--template -t Gebruik de func templates list opdracht om de volledige lijst met beschik bare sjablonen voor elke ondersteunde taal weer te geven.Use the func templates list command to see the complete list of available templates for each supported language.

Als u bijvoorbeeld een Java script-trigger in één opdracht wilt maken, voert u het volgende uit:For example, to create a JavaScript HTTP trigger in a single command, run:

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

Als u een in een wachtrij geactiveerde functie wilt maken in één opdracht, voert u het volgende uit:To create a queue-triggered function in a single command, run:

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

Functies lokaal uitvoerenRun functions locally

Als u een functions-project wilt uitvoeren, voert u de host functions uit.To run a Functions project, run the Functions host. De host schakelt triggers in voor alle functies in het project.The host enables triggers for all functions in the project.

Versie 2. xVersion 2.x

In versie 2. x van de runtime varieert de start opdracht, afhankelijk van de taal van uw project.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     

Versie 1. xVersion 1.x

Versie 1. x van de functions runtime vereist host de opdracht, zoals in het volgende voor beeld:Version 1.x of the Functions runtime requires the host command, as in the following example:

func host start

func startbiedt ondersteuning voor de volgende opties:func start supports the following options:

OptieOption DescriptionDescription
--no-build Pas het huidige project niet samen om uit te voeren.Do no build current project before running. Alleen voor dotnet-projecten.For dotnet projects only. De standaard waarde is ingesteld op ONWAAR.Default is set to false. Alleen versie 2. x.Version 2.x only.
--cert Het pad naar een pfx-bestand dat een persoonlijke sleutel bevat.The path to a .pfx file that contains a private key. Alleen gebruikt met --useHttps.Only used with --useHttps. Alleen versie 2. x.Version 2.x only.
--cors-credentials Alleen-lezen geverifieerde aanvragen (cookies en de verificatie header) versie 2. x toestaan.Allow cross-origin authenticated requests (i.e. cookies and the Authentication header) Version 2.x only.
--cors Een door komma's gescheiden lijst met CORS-oorsprong, zonder spaties.A comma-separated list of CORS origins, with no spaces.
--language-worker Argumenten voor het configureren van de taal medewerker.Arguments to configure the language worker. Alleen versie 2. x.Version 2.x only.
--nodeDebugPort -n De poort voor het fout opsporingsprogramma van het knoop punt dat moet worden gebruikt.The port for the node debugger to use. Prijs Een waarde van Launch. json of 5858.Default: A value from launch.json or 5858. Alleen versie 1. x.Version 1.x only.
--password Ofwel het wacht woord of een bestand dat het wacht woord voor een pfx-bestand bevat.Either the password or a file that contains the password for a .pfx file. Alleen gebruikt met --cert.Only used with --cert. Alleen versie 2. x.Version 2.x only.
--port -p De lokale poort waarop moet worden geluisterd.The local port to listen on. Standaard waarde: 7071.Default value: 7071.
--pause-on-error Wacht op extra invoer voordat het proces wordt afgesloten.Pause for additional input before exiting the process. Wordt alleen gebruikt bij het starten van kern Hulpprogramma's van een Integrated Development Environment (IDE).Used only when launching Core Tools from an integrated development environment (IDE).
--script-root --prefix Hiermee geeft u het pad op naar de hoofdmap van de functie-app die moet worden uitgevoerd of geïmplementeerd.Used to specify the path to the root of the function app that is to be run or deployed. Dit wordt gebruikt voor gecompileerde projecten die Project bestanden in een submap genereren.This is used for compiled projects that generate project files into a subfolder. Wanneer u bijvoorbeeld een C# klassen bibliotheek project bouwt, worden de bestanden host. json, local. settings. json en function. json gegenereerd in een hoofdmap met een pad zoals. MyProject/bin/Debug/netstandard2.0For 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. In dit geval stelt u het voor voegsel --script-root MyProject/bin/Debug/netstandard2.0in als.In this case, set the prefix as --script-root MyProject/bin/Debug/netstandard2.0. Dit is de basis van de functie-app wanneer deze wordt uitgevoerd in Azure.This is the root of the function app when running in Azure.
--timeout -t De time-out voor het starten van de functions-host, in seconden.The timeout for the Functions host to start, in seconds. Prijs 20 seconden.Default: 20 seconds.
--useHttps Maak een https://localhost:{port} binding aan in http://localhost:{port}plaats van aan.Bind to https://localhost:{port} rather than to http://localhost:{port}. Met deze optie wordt standaard een vertrouwd certificaat op uw computer gemaakt.By default, this option creates a trusted certificate on your computer.

Wanneer de functie host wordt gestart, wordt de URL van de met HTTP geactiveerde functies uitgevoerd: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

Belangrijk

Bij lokaal uitvoeren wordt verificatie niet afgedwongen voor HTTP-eind punten.When running locally, authentication isn't enforced for HTTP endpoints. Dit betekent dat alle lokale HTTP-aanvragen worden verwerkt authLevel = "anonymous"als.This means that all local HTTP requests are handled as authLevel = "anonymous". Zie het artikel over de http-bindingvoor meer informatie.For more information, see the HTTP binding article.

Test gegevens door geven aan een functiePassing test data to a function

Als u uw functies lokaal wilt testen, start u de functies host en roept u eind punten aan op de lokale server met behulp van HTTP-aanvragen.To test your functions locally, you start the Functions host and call endpoints on the local server using HTTP requests. Het eind punt dat u aanroept, is afhankelijk van het type functie.The endpoint you call depends on the type of function.

Notitie

Voor beelden in dit onderwerp gebruiken het krul hulp programma voor het verzenden van HTTP-aanvragen van de terminal of een opdracht prompt.Examples in this topic use the cURL tool to send HTTP requests from the terminal or a command prompt. U kunt een hulp programma van uw keuze gebruiken om HTTP-aanvragen naar de lokale server te verzenden.You can use a tool of your choice to send HTTP requests to the local server. Het krul hulp programma is standaard beschikbaar op Linux-systemen en Windows 10 build 17063 en hoger.The cURL tool is available by default on Linux-based systems and Windows 10 build 17063 and later. In oudere versies van Windows moet u eerst het krul hulp programmadownloaden en installeren.On older Windows, you must first download and install the cURL tool.

Zie strategieën voor het testen van uw code in azure functionsvoor meer algemene informatie over het testen van functies.For more general information on testing functions, see Strategies for testing your code in Azure Functions.

Geactiveerde HTTP-en webhook-functiesHTTP and webhook triggered functions

U roept het volgende eind punt aan om HTTP en door de webhook geactiveerde functies lokaal uit te voeren:You call the following endpoint to locally run HTTP and webhook triggered functions:

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

Zorg ervoor dat u dezelfde server naam en poort gebruikt als waarop de host van de functies luistert.Make sure to use the same server name and port that the Functions host is listening on. U ziet dit in de uitvoer die wordt gegenereerd bij het starten van de host van de functie.You see this in the output generated when starting the Function host. U kunt deze URL aanroepen met de HTTP-methode die wordt ondersteund door de trigger.You can call this URL using any HTTP method supported by the trigger.

Met de volgende krul opdracht wordt MyHttpTrigger de Quick Start-functie geactiveerd vanuit een GET-aanvraag met de para meter name door gegeven in de query teken reeks.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

Het volgende voor beeld is dezelfde functie die wordt aangeroepen vanuit een POST-aanvraag voor het door geven van een naam in de hoofd tekst van de aanvraag: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"}'

U kunt GET-aanvragen indienen vanuit een browser waarmee gegevens worden door gegeven in de query teken reeks.You can make GET requests from a browser passing data in the query string. Voor alle andere HTTP-methoden moet u krul, Fiddler, Postman of een soortgelijk hulp programma voor HTTP-tests gebruiken.For all other HTTP methods, you must use cURL, Fiddler, Postman, or a similar HTTP testing tool.

Niet-HTTP-geactiveerde functiesNon-HTTP triggered functions

Voor alle soorten functies behalve HTTP-triggers en webhooks kunt u uw functies lokaal testen door een beheer eindpunt aan te roepen.For all kinds of functions other than HTTP triggers and webhooks, you can test your functions locally by calling an administration endpoint. Als dit eind punt wordt aangeroepen met een HTTP POST-aanvraag op de lokale server, wordt de functie geactiveerd.Calling this endpoint with an HTTP POST request on the local server triggers the function. U kunt eventueel test gegevens door geven aan de uitvoering in de hoofd tekst van de POST-aanvraag.You can optionally pass test data to the execution in the body of the POST request. Deze functionaliteit is vergelijkbaar met het tabblad testen in de Azure Portal.This functionality is similar to the Test tab in the Azure portal.

U roept het volgende Administrator-eind punt aan om niet-HTTP-functies te activeren:You call the following administrator endpoint to trigger non-HTTP functions:

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

Als u test gegevens wilt door geven aan het eind punt van de beheerder van een functie, moet u de gegevens opgeven in de hoofd tekst van een bericht van een POST-aanvraag.To pass test data to the administrator endpoint of a function, you must supply the data in the body of a POST request message. De hoofd tekst van het bericht moet de volgende JSON-indeling hebben:The message body is required to have the following JSON format:

{
    "input": "<trigger_input>"
}

De <trigger_input> waarde bevat gegevens in een indeling die door de functie wordt verwacht.The <trigger_input> value contains data in a format expected by the function. Het volgende krul-voor beeld is een post QueueTriggerJS naar een functie.The following cURL example is a POST to a QueueTriggerJS function. In dit geval is de invoer een teken reeks die overeenkomt met het bericht dat naar verwachting in de wachtrij wordt gevonden.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

Gebruik de func run opdracht in versie 1. xUsing the func run command in version 1.x

Belangrijk

De func run opdracht wordt niet ondersteund in versie 2. x van de hulpprogram ma's.The func run command is not supported in version 2.x of the tools. Zie het onderwerp How to Azure functions runtime-versiesvoor meer informatie.For more information, see the topic How to target Azure Functions runtime versions.

U kunt ook rechtstreeks een functie aanroepen met func run <FunctionName> behulp van en invoer gegevens opgeven voor de functie.You can also invoke a function directly by using func run <FunctionName> and provide input data for the function. Deze opdracht is vergelijkbaar met het uitvoeren van een functie met behulp van het tabblad testen in de Azure Portal.This command is similar to running a function using the Test tab in the Azure portal.

func runbiedt ondersteuning voor de volgende opties:func run supports the following options:

OptieOption DescriptionDescription
--content -c Inline-inhoud.Inline content.
--debug -d Koppel een fout opsporingsprogramma aan het hostproces voordat u de functie uitvoert.Attach a debugger to the host process before running the function.
--timeout -t De tijd (in seconden) die moet worden gewacht totdat de lokale functions-host gereed is.Time to wait (in seconds) until the local Functions host is ready.
--file -f De bestands naam die moet worden gebruikt als inhoud.The file name to use as content.
--no-interactive Er wordt niet gevraagd om invoer.Does not prompt for input. Handig voor automatiserings scenario's.Useful for automation scenarios.

Als u bijvoorbeeld een door HTTP geactiveerde functie wilt aanroepen en de hoofd tekst van de inhoud wilt door geven, voert u de volgende opdracht uit:For example, to call an HTTP-triggered function and pass content body, run the following command:

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

Publiceren naar AzurePublish to Azure

De Azure Functions Core Tools ondersteunt twee typen implementaties: functie project bestanden rechtstreeks implementeren in uw functie-app via zip-implementatie en een aangepaste docker-container implementeren.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. U moet al een functie-app hebben gemaakt in uw Azure-abonnement, waar u uw code gaat implementeren.You must have already created a function app in your Azure subscription, to which you'll deploy your code. Projecten waarvoor compilatie vereist is, moeten worden gebouwd zodat de binaire bestanden kunnen worden geïmplementeerd.Projects that require compilation should be built so that the binaries can be deployed.

Een projectmap kan taalspecifieke bestanden en mappen bevatten die niet mogen worden gepubliceerd.A project folder may contain language-specific files and directories that shouldn't be published. Uitgesloten items worden weer gegeven in een. funcignore-bestand in de hoofdmap van het project.Excluded items are listed in a .funcignore file in the root project folder.

Implementatie (project bestanden)Deployment (project files)

Als u uw lokale code naar een functie-app in azure wilt publiceren publish , gebruikt u de opdracht:To publish your local code to a function app in Azure, use the publish command:

func azure functionapp publish <FunctionAppName>

Met deze opdracht wordt gepubliceerd naar een bestaande functie-app in Azure.This command publishes to an existing function app in Azure. U krijgt een fout melding als u probeert te publiceren naar een <FunctionAppName> die niet voor komt in uw abonnement.You'll get an error if you try to publish to a <FunctionAppName> that doesn't exist in your subscription. Zie een functie-app maken voor serverloze uitvoering voormeer informatie over het maken van een functie-app vanuit de opdracht prompt of het Terminal venster met behulp van de Azure cli.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. Met deze opdracht wordt de app standaard geïmplementeerd voor uitvoering vanuit het implementatie pakket.By default, this command deploys your app to run from the deployment package. Als u deze aanbevolen implementatie modus wilt uitschakelen, --nozip gebruikt u de optie.To disable this recommended deployment mode, use the --nozip option.

Belangrijk

Wanneer u een functie-app maakt in de Azure Portal, gebruikt deze standaard versie 2. x van de functie-runtime.When you create a function app in the Azure portal, it uses version 2.x of the Function runtime by default. Volg de instructies in uitvoeren op versie 1. xom de functie-app versie 1. x van de runtime te laten gebruiken.To make the function app use version 1.x of the runtime, follow the instructions in Run on version 1.x. U kunt de runtime versie niet wijzigen voor een functie-app met bestaande functies.You can't change the runtime version for a function app that has existing functions.

De volgende publicatie opties zijn van toepassing voor beide versies, 1. x en 2. x:The following publish options apply for both versions, 1.x and 2.x:

OptieOption DescriptionDescription
--publish-local-settings -i Publiceer instellingen in Local. settings. json naar Azure en vraag om te worden overschreven als de instelling al bestaat.Publish settings in local.settings.json to Azure, prompting to overwrite if the setting already exists. Als u de opslag emulator gebruikt, wijzigt u eerst de app-instelling in een echte opslag verbinding.If you are using the storage emulator, first change the app setting to an actual storage connection.
--overwrite-settings -y De prompt voor het overschrijven van app- --publish-local-settings -i instellingen onderdrukken wanneer deze wordt gebruikt.Suppress the prompt to overwrite app settings when --publish-local-settings -i is used.

De volgende publicatie opties worden alleen ondersteund in versie 2. x:The following publish options are only supported in version 2.x:

OptieOption DescriptionDescription
--publish-settings-only -o Publiceer instellingen alleen en sla de inhoud over.Only publish settings and skip the content. De standaard instelling is prompt.Default is prompt.
--list-ignored-files Geeft een lijst weer van bestanden die worden genegeerd tijdens het publiceren, dat is gebaseerd op het. funcignore-bestand.Displays a list of files that are ignored during publishing, which is based on the .funcignore file.
--list-included-files Geeft een lijst weer van bestanden die zijn gepubliceerd, die zijn gebaseerd op het. funcignore-bestand.Displays a list of files that are published, which is based on the .funcignore file.
--nozip Hiermee schakelt u Run-From-Package de standaard modus uit.Turns the default Run-From-Package mode off.
--build-native-deps Slaat de map voor het genereren van wielen op tijdens het publiceren van python-functie-apps.Skips generating .wheels folder when publishing python function apps.
--additional-packages Lijst met pakketten die moeten worden geïnstalleerd bij het bouwen van systeem eigen afhankelijkheden.List of packages to install when building native dependencies. Bijvoorbeeld: python3-dev libevent-dev.For example: python3-dev libevent-dev.
--force Verificatie vooraf publiceren in bepaalde scenario's negeren.Ignore pre-publishing verification in certain scenarios.
--csx Publiceer een C# script-project (. CSX).Publish a C# script (.csx) project.
--no-build Sla het bouwen van DOTNET-functies over.Skip building dotnet functions.
--dotnet-cli-params Bij het publiceren C# van gecompileerde (. csproj)-functies roept de kern hulpprogramma's ' DotNet build--output bin/Publish ' aan.When publishing compiled C# (.csproj) functions, the core tools calls 'dotnet build --output bin/publish'. Alle para meters die aan dit worden door gegeven, worden toegevoegd aan de opdracht regel.Any parameters passed to this will be appended to the command line.

Implementatie (aangepaste container)Deployment (custom container)

Met Azure Functions kunt u uw functie project implementeren in een aangepaste docker-container.Azure Functions lets you deploy your function project in a custom Docker container. Zie een functie maken in Linux met behulp van een aangepaste installatie kopievoor meer informatie.For more information, see Create a function on Linux using a custom image. Aangepaste containers moeten een Dockerfile hebben.Custom containers must have a Dockerfile. Als u een app met een Dockerfile wilt maken, gebruikt u de optie- func initDockerfile op.To create an app with a Dockerfile, use the --dockerfile option on func init.

func deploy

De volgende opties voor de implementatie van de aangepaste container zijn beschikbaar:The following custom container deployment options are available:

OptieOption DescriptionDescription
--registry De naam van een docker-REGI ster waarmee de huidige gebruiker zich heeft aangemeld.The name of a Docker Registry the current user signed-in to.
--platform Hosting platform voor de functie-app.Hosting platform for the function app. Geldige opties zijnkubernetesValid options are kubernetes
--name Naam van de functie-app.Function app name.
--max Hiermee stelt u eventueel het maximum aantal functie-app-exemplaren in dat moet worden geïmplementeerd.Optionally, sets the maximum number of function app instances to deploy to.
--min Hiermee stelt u optioneel het minimum aantal functie-app-exemplaren in dat moet worden geïmplementeerd.Optionally, sets the minimum number of function app instances to deploy to.
--config Hiermee stelt u een optioneel implementatie configuratie bestand in.Sets an optional deployment configuration file.

Bewakings functiesMonitoring functions

De aanbevolen manier om de uitvoering van uw functies te controleren is door te integreren met Azure-toepassing Insights.The recommended way to monitor the execution of your functions is by integrating with Azure Application Insights. U kunt ook uitvoerings logboeken streamen naar uw lokale computer.You can also stream execution logs to your local computer. Zie Azure functions bewakenvoor meer informatie.To learn more, see Monitor Azure Functions.

Integratie van Application Insights inschakelenEnable Application Insights integration

Wanneer u een functie-app maakt in de Azure Portal, wordt de Application Insights-integratie standaard voor u uitgevoerd.When you create a function app in the Azure portal, the Application Insights integration is done for you by default. Wanneer u echter uw functie-app maakt met behulp van Azure CLI, wordt de integratie in uw functie-app in azure niet uitgevoerd.However, when you create your function app by using the Azure CLI, the integration in your function app in Azure isn't done.

Met functies kunt u eenvoudig Application Insights integratie toevoegen aan een functie-app vanuit de Azure Portal.Functions makes it easy to add Application Insights integration to a function app from the Azure portal.

  1. Selecteer in de Portal-Portal alle services > functie-apps, selecteer de functie-app en selecteer vervolgens de banner Application Insights boven aan het vensterIn 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 inschakelen vanuit de portal

  2. Maak een Application Insights resource met behulp van de instellingen die zijn opgegeven in de tabel onder de afbeelding.Create an Application Insights resource by using the settings specified in the table below the image.

    Een Application Insights-resource maken

    InstellingSetting Voorgestelde waardeSuggested value DescriptionDescription
    NameName Unieke app-naamUnique app name Het is het gemakkelijkst om dezelfde naam te gebruiken als uw functie-app, die uniek moet zijn in uw abonnement.It's easiest to use the same name as your function app, which must be unique in your subscription.
    LocationLocation Europa -westWest Europe Gebruik, indien mogelijk, dezelfde regio als de functie-app, of een van de regio's die zich dicht bij die regio bevinden.If possible, use the same region as your function app, or one that's close to that region.
  3. Selecteer OK.Select OK. De Application Insights resource wordt gemaakt in dezelfde resource groep en hetzelfde abonnement als uw functie-app.The Application Insights resource is created in the same resource group and subscription as your function app. Nadat de resource is gemaakt, sluit u het venster Application Insights.After the resource is created, close the Application Insights window.

  4. Ga terug naar de functie-app, selecteer Toepassings instellingenen schuif vervolgens omlaag naar Toepassings instellingen.Back in your function app, select Application settings, and then scroll down to Application settings. Als u een instelling ziet met APPINSIGHTS_INSTRUMENTATIONKEYde naam, wordt Application Insights integratie ingeschakeld voor uw functie-app die wordt uitgevoerd in Azure.If you see a setting named APPINSIGHTS_INSTRUMENTATIONKEY, Application Insights integration is enabled for your function app running in Azure.

Streaming-logboeken inschakelenEnable streaming logs

U kunt een stroom weer geven van de logboek bestanden die worden gegenereerd door uw functies in een opdracht regel sessie op uw lokale computer.You can view a stream of log files being generated by your functions in a command-line session on your local computer.

Systeem eigen streaming-logboekenNative streaming logs

Ingebouwde logboek streamingBuilt-in log streaming

Gebruik de logstream optie om streaming-logboeken te ontvangen van een specifieke functie-app die wordt uitgevoerd in azure, zoals in het volgende voor beeld: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>

Live Metrics StreamLive Metrics Stream

U kunt ook de Live Metrics stream voor uw functie-app in een nieuw browser venster weer geven door --browser de optie op te nemen, zoals in het volgende voor beeld: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

Voor dit type streaming-logboeken moet u Application Insights-integratie inschakelen voor uw functie-app.This type of streaming logs requires that you enable Application Insights integration for your function app.

Volgende stappenNext steps

Azure Functions Core Tools is open source en wordt gehost op github.Azure Functions Core Tools is open source and hosted on GitHub.
Open een github-probleemals u een fout of een functie aanvraag wilt indienen.To file a bug or feature request, open a GitHub issue.