Azure Functions Core Tools çalışınWork with Azure Functions Core Tools

• 03/13/2019
• Okunmasına 19 dakika kaldı
• • 

Azure Functions Core Tools, komut isteminden veya terminalden yerel bilgisayarınızda işlevlerinizi geliştirmenize ve test etmenize olanak tanır.Azure Functions Core Tools lets you develop and test your functions on your local computer from the command prompt or terminal. Yerel işlevleriniz canlı Azure hizmetlerine bağlanabilir ve tüm Işlevler çalışma zamanını kullanarak işlevlerinizi yerel bilgisayarınızdaki hata ayıklaması yapabilirsiniz.Your local functions can connect to live Azure services, and you can debug your functions on your local computer using the full Functions runtime. Hatta, Azure aboneliğinize bir işlev uygulaması dağıtabilirsiniz.You can even deploy a function app to your Azure subscription.

Yerel bilgisayarınızda işlevleri geliştirme ve temel araçları kullanarak bunları Azure 'da yayımlama aşağıdaki temel adımları izler:Developing functions on your local computer and publishing them to Azure using Core Tools follows these basic steps:

Temel araçlar sürümleriCore Tools versions

Azure Functions Core Tools iki sürümü vardır.There are two versions of Azure Functions Core Tools. Kullandığınız sürüm yerel geliştirme ortamınıza, dil seçimineve gerekli destek düzeyine bağlıdır:The version you use depends on your local development environment, choice of language, and level of support required:

• Sürüm 1. x: çalışma zamanının sürüm 1. x ' i destekler.Version 1.x: supports version 1.x of the runtime. Araçların bu sürümü yalnızca Windows bilgisayarlarda desteklenir ve bir NPM paketindenyüklenir.This version of the tools is only supported on Windows computers and is installed from an npm package. Bu sürümle birlikte, resmi olarak desteklenmeyen deneysel dillerde işlevler oluşturabilirsiniz.With this version, you can create functions in experimental languages that are not officially supported. Daha fazla bilgi için bkz. Azure Işlevlerinde desteklenen dillerFor more information, see Supported languages in Azure Functions

• Sürüm 2. x: çalışma zamanının sürüm 2. x' i destekler.Version 2.x: supports version 2.x of the runtime. Bu sürüm Windows, MacOSve Linux'u destekler.This version supports Windows, macOS, and Linux. Yükleme için platforma özgü paket yöneticilerini veya NPM 'yi kullanır.Uses platform-specific package managers or npm for installation.

Aksi belirtilmediği takdirde, bu makaledeki örnekler 2. x sürümü içindir.Unless otherwise noted, the examples in this article are for version 2.x.

Azure Functions Core Tools’u YüklemeInstall the Azure Functions Core Tools

Azure Functions Core Tools , yerel geliştirme bilgisayarınızda çalıştırabileceğiniz Azure işlevleri çalışma zamanını destekleyen aynı çalışma zamanının bir sürümünü içerir.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. Ayrıca işlevler oluşturmak, Azure 'a bağlanmak ve işlev projelerini dağıtmak için komutlar sağlar.It also provides commands to create functions, connect to Azure, and deploy function projects.

Sürüm 2. xVersion 2.x

Araçların sürüm 2. x, .NET Core üzerinde oluşturulan Azure Işlevleri çalışma zamanı 2. x 'i kullanır.Version 2.x of the tools uses the Azure Functions runtime 2.x that is built on .NET Core. Bu sürüm, Windows, MacOSve Linuxdahil tüm platformlarda .NET Core 2. x desteği için desteklenir.This version is supported on all platforms .NET Core 2.x supports, including Windows, macOS, and Linux.

PencerelerinWindows

Aşağıdaki adımlarda, Windows 'a temel araçları yüklemek için NPM kullanılır.The following steps use npm to install Core Tools on Windows. Chocolateyde kullanabilirsiniz.You can also use Chocolatey. Daha fazla bilgi için bkz. temel araçlar Benioku.For more information, see the Core Tools readme.

1. NPM içeren Node.js' yi yükler.Install Node.js, which includes npm. Araçların sürüm 2. x için yalnızca Node. js 8,5 ve üzeri sürümleri desteklenir.For version 2.x of the tools, only Node.js 8.5 and later versions are supported.

2. Temel Araçlar paketini yükler:Install the Core Tools package:

   npm install -g azure-functions-core-tools
   

   NPM 'nin temel araçlar paketini indirmesi ve yüklemesi birkaç dakika sürebilir.It may take a few minutes for npm to download and install the Core Tools package.

3. Uzantı demetikullanmayı planlamıyorsanız, Windows için .NET Core 2. x SDK 'sınıyükleyebilirsiniz.If you do not plan to use extension bundles, install the .NET Core 2.x SDK for Windows.

Homebrew ile MacOSMacOS with Homebrew

Aşağıdaki adımlarda, macOS 'a çekirdek araçları yüklemek için homebrew kullanılır.The following steps use Homebrew to install the Core Tools on macOS.

1. Zaten yüklenmemişse homebrew'ı yükleme.Install Homebrew, if it's not already installed.

2. Temel Araçlar paketini yükler:Install the Core Tools package:

   brew tap azure/functions
   brew install azure-functions-core-tools
   

3. Uzantı demetikullanmayı planlamıyorsanız, MacOS için .NET Core 2. x SDK'yı yükleyebilirsiniz.If you do not plan to use extension bundles, install .NET Core 2.x SDK for macOS.

APT ile Linux (Ubuntu/dekim)Linux (Ubuntu/Debian) with APT

Aşağıdaki adımlarda, Ubuntu/de, Linux dağıtımına çekirdek araçları yüklemek için apt kullanılır.The following steps use APT to install Core Tools on your Ubuntu/Debian Linux distribution. Diğer Linux dağıtımları için bkz. temel araçlar Benioku dosyası.For other Linux distributions, see the Core Tools readme.

1. Paket bütünlüğünü doğrulamak için Microsoft paket deposu GPG anahtarını yükler: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. Bir APT güncelleştirmesi yapmadan önce .NET geliştirme kaynak listesini ayarlayın.Set up the .NET development source list before doing an APT update.

   Ubuntu için APT kaynak listesini ayarlamak için şu komutu çalıştırın: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'
   

   Dekim için APT kaynak listesini ayarlamak için şu komutu çalıştırın: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. Aşağıda listelenen uygun Linux sürümü dizelerinden biri için /etc/apt/sources.list.d/dotnetdev.list dosyasını denetleyin:Check the /etc/apt/sources.list.d/dotnetdev.list file for one of the appropriate Linux version strings listed below:

   Linux dağıtımıLinux distribution	SürümVersion
   Debian 10Debian 10	buster
   Borçlu 9Debian 9	stretch
   Desek8Debian 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. APT kaynak güncelleştirmesini başlatın:Start the APT source update:

   sudo apt-get update
   

5. Temel Araçlar paketini yükler:Install the Core Tools package:

   sudo apt-get install azure-functions-core-tools
   

6. Uzantı demetikullanmayı planlamıyorsanız, Linux için .NET Core 2. x SDK'yı yükleyebilirsiniz.If you do not plan to use extension bundles, install .NET Core 2.x SDK for Linux.

Yerel Işlevler projesi oluşturmaCreate a local Functions project

Bir işlevler proje dizini, Host. JSON ve Local. Settings. JSONdosyalarını, tek tek işlevlerin kodunu içeren alt klasörlerle birlikte içerir.A functions project directory contains the files host.json and local.settings.json, along with subfolders that contain the code for individual functions. Bu dizin, Azure 'daki bir işlev uygulamasının eşdeğeridir.This directory is the equivalent of a function app in Azure. Işlevler klasör yapısı hakkında daha fazla bilgi edinmek için bkz. Azure işlevleri Geliştirici Kılavuzu.To learn more about the Functions folder structure, see the Azure Functions developers guide.

Sürüm 2. x, başlatıldığında projeniz için varsayılan bir dil seçmenizi ve tüm işlevlerin varsayılan dil şablonlarını kullanmasını gerektirir.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. 1. x sürümünde, her bir işlev oluşturduğunuzda dili belirtirsiniz.In version 1.x, you specify the language each time you create a function.

Terminal penceresinde veya bir komut isteminden, projeyi ve yerel Git deposunu oluşturmak için aşağıdaki komutu çalıştırın:In the terminal window or from a command prompt, run the following command to create the project and local Git repository:

func init MyFunctionProj

Bir proje adı sağladığınızda, bu ada sahip yeni bir klasör oluşturulur ve başlatılır.When you provide a project name, a new folder with that name is created and initialized. Aksi takdirde, geçerli klasör başlatılır.Otherwise, the current folder is initialized.
Sürüm 2. x içinde, komutunu çalıştırdığınızda projeniz için bir çalışma zamanı seçmeniz gerekir.In version 2.x, when you run the command you must choose a runtime for your project.

Select a worker runtime:
dotnet
node
python 
powershell

Yukarı/aşağı ok tuşlarını kullanarak bir dil seçin ve ENTER tuşuna basın.Use the up/down arrow keys to choose a language, then press Enter. JavaScript veya TypeScript işlevleri geliştirmeyi planlıyorsanız düğüm' yi seçin ve ardından dili seçin.If you plan to develop JavaScript or TypeScript functions, choose node, and then select the language. TypeScript bazı ek gereksinimleresahiptir.TypeScript has some additional requirements.

Çıktı bir JavaScript projesi için aşağıdaki örneğe benzer şekilde görünür: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 init, aksi belirtilmediği takdirde yalnızca sürüm 2. x olan aşağıdaki seçenekleri destekler:func init supports the following options, which are version 2.x-only, unless otherwise noted:

Uzantılarını kaydetmeRegister extensions

Bağlamaları hariç olmak üzere HTTP ve Zamanlayıcı Tetikleyicileri, İşlevler çalışma zamanı sürüm 2.x uzantı paketleri uygulanır.With the exception of HTTP and timer triggers, Functions bindings in runtime version 2.x are implemented as extension packages. Sürüm 2.x Azure işlevleri çalışma zamanı, sahip, işlevlerde kullanılan bağlama türleri için uzantıları açıkça kaydedilecek.In version 2.x of the Azure Functions runtime, you have to explicitly register the extensions for the binding types used in your functions. Bu HTTP bağlamaları ve uzantılar gerektirmeyen Zamanlayıcı Tetikleyicileri özel durumlardır.The exceptions to this are HTTP bindings and timer triggers, which do not require extensions.

Bağlama uzantıları'nı tek başına yüklemeyi seçebilirsiniz veya bir uzantı paketi başvurusu host.json proje dosyasına ekleyebilirsiniz.You can choose to install binding extensions individually, or you can add an extension bundle reference to the host.json project file. Uzantı paketleri birden çok bağlama türleri kullanırken paket uyumluluk sorunlarına sahip olma olasılığını kaldırır.Extension bundles removes the chance of having package compatibility issues when using multiple binding types. Bağlama uzantılarını kaydetme için önerilen yaklaşımdır.It is the recommended approach for registering binding extensions. Uzantı paketleri de .NET Core yükleme gereksinimini kaldırır 2.x SDK.Extension bundles also removes the requirement of installing the .NET Core 2.x SDK.

Uzantı paketleriExtension bundles

Bağlama uzantılarını yüklemenin en kolay yolu, uzantıpaketlerinin etkinleştirilme yöntemidir.The easiest way to install binding extensions is to enable extension bundles. Paketleri etkinleştirdiğinizde, önceden tanımlanmış bir uzantı paketleri kümesi otomatik olarak yüklenir.When you enable bundles, a predefined set of extension packages is automatically installed.

Uzantı paketleri 'ni etkinleştirmek için, Host. json dosyasını açın ve içeriğini aşağıdaki kodla eşleşecek şekilde güncelleştirin: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)"
    }
}

Daha fazla bilgi için bkz. kaydetme Azure işlevleri bağlama uzantıları.To learn more, see Register Azure Functions binding extensions. Bağlamaları functions.json dosyaya eklemeden önce uzantı paketleri için host.json eklemeniz gerekir.You should add extension bundles to the host.json before you add bindings to the functions.json file.

Tek tek uzantılarını kaydetmeRegister individual extensions

Bir paket halinde olmayan uzantıları yüklemeniz gerekiyorsa, özel bağlamalar için ayrı bir uzantı paketleri el ile kaydedebilirsiniz.If you need to install extensions that aren't in a bundle, you can manually register individual extension packages for specific bindings.

Güncelleştirdikten sonra function.json dosyasını proje klasöründe aşağıdaki komutu çalıştırın, işlevinizi gereken tüm bağlamaları içerecek şekilde.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

Komut okur function.json ihtiyacınız paketler görmek için bir dosya yükler ve uzantıları projesi oluşturur.The command reads the function.json file to see which packages you need, installs them, and rebuilds the extensions project. Geçerli sürümde yeni bağlamalar ekler, ancak var olan bağlamaları güncelleştirmez.It adds any new bindings at the current version but does not update existing bindings. Kullanım --force yenilerini yüklerken mevcut bağlamaları en son sürüme güncelleştirmek için seçeneği.Use the --force option to update existing bindings to the latest version when installing new ones.

Yerel ayarlar dosyasıLocal settings file

Local. Settings. JSON dosyası, uygulama ayarlarını, bağlantı dizelerini ve yerel geliştirme araçları tarafından kullanılan ayarları depolar.The local.settings.json file stores app settings, connection strings, and settings used by local development tools. Local. Settings. JSON dosyasındaki ayarlar yalnızca projeleri yerel olarak çalıştırırken kullanılır.Settings in the local.settings.json file are used only when you're running projects locally. Yerel ayarlar dosyası bu yapıya sahiptir: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>"
  }
}

Projeleri yerel olarak çalıştırdığınızda bu ayarlar desteklenir:These settings are supported when you run projects locally:

Varsayılan olarak, bu ayarlar proje Azure 'da yayımlandığında otomatik olarak geçirilmez.By default, these settings are not migrated automatically when the project is published to Azure. Bu ayarların Azure 'daki işlev uygulamasına eklendiğinden emin olmak için yayımlarken --publish-local-settings anahtarını kullanın.Use the --publish-local-settings switch when you publish to make sure these settings are added to the function app in Azure. ConnectionString içindeki değerlerin hiçbir şekilde yayımlanmadığını unutmayın.Note that values in ConnectionStrings are never published.

İşlev uygulaması ayarları değerleri, kodunuzda ortam değişkenleri olarak da okunabilir.The function app settings values can also be read in your code as environment variables. Daha fazla bilgi için, bu dile özgü başvuru konularının ortam değişkenleri bölümüne bakın:For more information, see the Environment variables section of these language-specific reference topics:

• C#derlemesiC# precompiled
• C#betik (. CSX)C# script (.csx)
• JavaJava
• JavaScriptJavaScript

AzureWebJobsStorage için geçerli bir depolama bağlantı dizesi ayarlanmamışsa ve öykünücü kullanılmıyorsa, aşağıdaki hata iletisi görüntülenir:When no valid storage connection string is set for AzureWebJobsStorage and the emulator isn't being used, the following error message is shown:

Yerel. Settings. JSON içinde AzureWebJobsStorage için eksik değer.Missing value for AzureWebJobsStorage in local.settings.json. HTTP dışındaki tüm tetikleyiciler için bu gereklidir.This is required for all triggers other than HTTP. ' Func Azure functionapp Fetch-App-settings <functionAppName>' çalıştırabilir veya yerel. Settings. JSON içinde bir bağlantı dizesi belirtebilirsiniz.You can run 'func azure functionapp fetch-app-settings <functionAppName>' or specify a connection string in local.settings.json.

Depolama bağlantı dizelerinizi alınGet your storage connection strings

Geliştirme için depolama öykünücüsü kullanılırken bile gerçek bir depolama bağlantısıyla test etmek isteyebilirsiniz.Even when using the storage emulator for development, you may want to test with an actual storage connection. Zaten bir depolama hesabı oluşturmuşolduğunuz varsayılarak, aşağıdaki yollarla geçerli bir depolama bağlantı dizesi alabilirsiniz:Assuming you have already created a storage account, you can get a valid storage connection string in one of the following ways:

• Azure portalda, depolama hesaplarınıarayıp seçin.From the Azure portal, search for and select Storage accounts. Azure portal

  Depolama hesabınızı seçin, Ayarlar' da erişim tuşları ' nı seçin, sonra bağlantı dizesi değerlerinden birini kopyalayın.Select your storage account, select Access keys in Settings, then copy one of the Connection string values. Azure portal](./media/functions-run-local/copy-storage-connection-portal.png) bağlantı dizesini ![Kopyala

• Azure hesabınıza bağlanmak için Azure Depolama Gezgini kullanın.Use Azure Storage Explorer to connect to your Azure account. Gezgin'de aboneliğinizi genişletin, depolama hesabınızı seçin ve birincil veya ikincil bağlantı dizesini kopyalayın.In the Explorer, expand your subscription, select your storage account, and copy the primary or secondary connection string.

  

• Azure 'dan bağlantı dizesini aşağıdaki komutlardan biriyle indirmek için temel araçları kullanın:Use Core Tools to download the connection string from Azure with one of the following commands:

  • Var olan bir işlev uygulamasından tüm ayarları indir:Download all settings from an existing function app:

    func azure functionapp fetch-app-settings <FunctionAppName>
    

  • Belirli bir depolama hesabı için bağlantı dizesini al:Get the Connection string for a specific storage account:

    func azure storage fetch-connection-string <StorageAccountName>
    

    Azure 'da henüz oturum açmadıysanız, bunu yapmanız istenir.When you are not already signed in to Azure, you are prompted to do so.

İşlev oluşturmaCreate a function

Bir işlev oluşturmak için aşağıdaki komutu çalıştırın:To create a function, run the following command:

func new

Sürüm 2. x ' de func new çalıştırdığınızda, işlev uygulamanızın varsayılan dilinde bir şablon seçmeniz istenir. Ayrıca, işleviniz için bir ad seçmeniz istenir.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. 1. x sürümünde de dili seçmeniz istenir.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

İşlev kodu, aşağıdaki kuyruk tetikleyicisi çıktısında görebileceğiniz gibi, belirtilen işlev adına sahip bir alt klasörde oluşturulur: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

Ayrıca, aşağıdaki bağımsız değişkenleri kullanarak komutta bu seçenekleri belirtebilirsiniz:You can also specify these options in the command using the following arguments:

Örneğin, tek bir komutta bir JavaScript HTTP tetikleyicisi oluşturmak için şunu çalıştırın:For example, to create a JavaScript HTTP trigger in a single command, run:

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

Tek bir komutta kuyruk tetiklemeli bir işlev oluşturmak için şunu çalıştırın:To create a queue-triggered function in a single command, run:

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

İşlevleri yerel olarak çalıştırRun functions locally

Bir Işlevler projesi çalıştırmak için, Işlevler ana bilgisayarını çalıştırın.To run a Functions project, run the Functions host. Konak, projedeki tüm işlevler için Tetikleyicileri mümkün.The host enables triggers for all functions in the project.

Sürüm 2. xVersion 2.x

Çalışma zamanının 2. x sürümünde, başlangıç komutu Proje dilinize bağlı olarak değişir.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     

Sürüm 1. xVersion 1.x

Işlevler çalışma zamanının sürüm 1. x, aşağıdaki örnekte olduğu gibi host komutunu gerektirir:Version 1.x of the Functions runtime requires the host command, as in the following example:

func host start

func start aşağıdaki seçenekleri destekler:func start supports the following options:

Işlevler ana bilgisayarı başlatıldığında, HTTP ile tetiklenen işlevlerin URL 'sini verir: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

Test verilerini bir işleve geçirmePassing test data to a function

İşlevlerinizi yerel olarak test etmek için, işlevleri ana bilgisayarı başlatır ve http isteklerini kullanarak yerel sunucuda uç noktaları çağırabilirsiniz.To test your functions locally, you start the Functions host and call endpoints on the local server using HTTP requests. Çağırdığınız uç nokta, işlevin türüne bağlıdır.The endpoint you call depends on the type of function.

Test işlevleri hakkında daha fazla genel bilgi için bkz. Azure işlevlerinde kodunuzu test etme stratejileri.For more general information on testing functions, see Strategies for testing your code in Azure Functions.

HTTP ve Web kancası tarafından tetiklenen işlevlerHTTP and webhook triggered functions

HTTP ve Web kancası tarafından tetiklenen işlevleri yerel olarak çalıştırmak için aşağıdaki uç noktayı çağırın:You call the following endpoint to locally run HTTP and webhook triggered functions:

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

Işlevlerin barındırın dinlediği sunucu adını ve bağlantı noktasını kullandığınızdan emin olun.Make sure to use the same server name and port that the Functions host is listening on. Bunu, Işlev Konağı başlatılırken oluşturulan çıktıda görürsünüz.You see this in the output generated when starting the Function host. Tetikleyici tarafından desteklenen herhangi bir HTTP yöntemini kullanarak bu URL 'YI çağırabilirsiniz.You can call this URL using any HTTP method supported by the trigger.

Aşağıdaki kıvrımlı komutu, sorgu dizesinde geçirilen Name parametresine sahıp bir GET isteğinden MyHttpTrigger hızlı başlangıç işlevini tetikler.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şağıdaki örnek, istek gövdesinde bir POST isteği geçirme adından çağrılan aynı fonksiyondır: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"}'

Sorgu dizesindeki verileri geçirerek tarayıcıdan GET istekleri yapabilirsiniz.You can make GET requests from a browser passing data in the query string. Diğer tüm HTTP yöntemleri için kıvrımlı, Fiddler, Postman veya benzer bir HTTP test aracı kullanmanız gerekir.For all other HTTP methods, you must use cURL, Fiddler, Postman, or a similar HTTP testing tool.

HTTP dışı tetiklenen işlevlerNon-HTTP triggered functions

HTTP Tetikleyicileri ve Web kancaları dışındaki tüm işlev türlerinde, bir yönetim uç noktası çağırarak işlevlerinizi yerel olarak test edebilirsiniz.For all kinds of functions other than HTTP triggers and webhooks, you can test your functions locally by calling an administration endpoint. Bu uç noktanın yerel sunucuda bir HTTP POST isteğiyle çağrılması işlevi tetikler.Calling this endpoint with an HTTP POST request on the local server triggers the function. İsteğe bağlı olarak, POST isteğinin gövdesinde test verilerini yürütmeye geçirebilirsiniz.You can optionally pass test data to the execution in the body of the POST request. Bu işlev, Azure portal Test sekmesine benzerdir.This functionality is similar to the Test tab in the Azure portal.

HTTP olmayan işlevleri tetiklemek için aşağıdaki yönetici uç noktasını çağırın:You call the following administrator endpoint to trigger non-HTTP functions:

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

Test verilerini bir işlevin yönetici uç noktasına geçirmek için, verileri bir POST isteği iletisinin gövdesinde belirtmeniz gerekir.To pass test data to the administrator endpoint of a function, you must supply the data in the body of a POST request message. İleti gövdesinin aşağıdaki JSON biçimine sahip olması gerekir:The message body is required to have the following JSON format:

{
    "input": "<trigger_input>"
}

<trigger_input> değeri, işlevi tarafından beklenen bir biçimde veriler içeriyor.The <trigger_input> value contains data in a format expected by the function. Aşağıdaki kıvrımlı örnek bir QueueTriggerJS işlevinin GÖNDERISINI sağlar.The following cURL example is a POST to a QueueTriggerJS function. Bu durumda, giriş sırada bulunması beklenen iletiyle eşdeğer bir dizedir.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

1. x sürümünde func run komutu kullanmaUsing the func run command in version 1.x

Ayrıca, func run <FunctionName> kullanarak doğrudan bir işlevi çağırabilir ve işlev için giriş verileri sağlayabilirsiniz.You can also invoke a function directly by using func run <FunctionName> and provide input data for the function. Bu komut, Azure portal Test sekmesini kullanarak bir işlevi çalıştırmaya benzer.This command is similar to running a function using the Test tab in the Azure portal.

func run aşağıdaki seçenekleri destekler:func run supports the following options:

Örneğin, HTTP ile tetiklenen bir işlev çağırmak ve içerik gövdesini geçirmek için aşağıdaki komutu çalıştırın:For example, to call an HTTP-triggered function and pass content body, run the following command:

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

Azure 'da yayımlamaPublish to Azure

Azure Functions Core Tools iki tür dağıtımı destekler: işlev projesi dosyalarını ZIP dağıtımı ve dağıtımaracılığıyla doğrudan işlev uygulamanıza dağıtma.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. Kodunuzu dağıtacağınız Azure aboneliğinizde zaten bir işlev uygulaması oluşturmuşolmanız gerekir.You must have already created a function app in your Azure subscription, to which you'll deploy your code. İkililerin dağıtılması için derleme gerektiren projeler oluşturulmalıdır.Projects that require compilation should be built so that the binaries can be deployed.

Proje klasörü, yayınlanmaması gereken dile özgü dosyalar ve dizinler içerebilir.A project folder may contain language-specific files and directories that shouldn't be published. Dışlanan öğeler kök proje klasöründeki bir. funcignore dosyasında listelenir.Excluded items are listed in a .funcignore file in the root project folder.

Dağıtım (proje dosyaları)Deployment (project files)

Yerel kodunuzu Azure 'da bir işlev uygulamasına yayımlamak için publish komutunu kullanın:To publish your local code to a function app in Azure, use the publish command:

func azure functionapp publish <FunctionAppName>

Bu komut, Azure 'da var olan bir işlev uygulamasına yayınlar.This command publishes to an existing function app in Azure. Aboneliğinizde mevcut olmayan bir <FunctionAppName> yayımlamaya çalışırsanız hata alırsınız.You'll get an error if you try to publish to a <FunctionAppName> that doesn't exist in your subscription. Azure CLı kullanarak komut isteminden veya Terminal penceresinde bir işlev uygulaması oluşturmayı öğrenmek için bkz. sunucusuz yürütme için işlev uygulaması oluşturma.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. Varsayılan olarak, bu komut, uzak derlemeyi kullanır ve uygulamanızı dağıtım paketinden çalıştırmaküzere dağıtır.By default, this command uses remote build and deploys your app to run from the deployment package. Bu önerilen dağıtım modunu devre dışı bırakmak için --nozip seçeneğini kullanın.To disable this recommended deployment mode, use the --nozip option.

Aşağıdaki yayımlama seçenekleri, 1. x ve 2. x sürümleri için geçerlidir:The following publish options apply for both versions, 1.x and 2.x:

Aşağıdaki yayımlama seçenekleri yalnızca sürüm 2. x içinde desteklenir:The following publish options are only supported in version 2.x:

Dağıtım (özel kapsayıcı)Deployment (custom container)

Azure Işlevleri, işlev projenizi özel bir Docker kapsayıcısınadağıtmanızı sağlar.Azure Functions lets you deploy your function project in a custom Docker container. Daha fazla bilgi için bkz. özel bir görüntü kullanarak Linux 'ta Işlev oluşturma.For more information, see Create a function on Linux using a custom image. Özel kapsayıcılar bir Dockerfile içermelidir.Custom containers must have a Dockerfile. Dockerfile ile bir uygulama oluşturmak için, func initüzerinde--dockerfile seçeneğini kullanın.To create an app with a Dockerfile, use the --dockerfile option on func init.

func deploy

Aşağıdaki özel kapsayıcı dağıtım seçenekleri kullanılabilir:The following custom container deployment options are available:

İzleme işlevleriMonitoring functions

İşlevlerinizin yürütülmesini izlemek için önerilen yol, Azure Application Insights ile tümleştirilmesine göre yapılır.The recommended way to monitor the execution of your functions is by integrating with Azure Application Insights. Ayrıca, yürütme günlüklerini yerel bilgisayarınıza da akışla aktarabilirsiniz.You can also stream execution logs to your local computer. Daha fazla bilgi için bkz. Azure Işlevlerini izleme.To learn more, see Monitor Azure Functions.

Application Insights tümleştirmeyi etkinleştirEnable Application Insights integration

Azure portal bir işlev uygulaması oluşturduğunuzda, Application Insights tümleştirmesi varsayılan olarak sizin için yapılır.When you create a function app in the Azure portal, the Application Insights integration is done for you by default. Ancak, Azure CLı kullanarak işlev uygulamanızı oluşturduğunuzda, Azure 'daki işlev uygulamanızda tümleştirme yapılmaz.However, when you create your function app by using the Azure CLI, the integration in your function app in Azure isn't done.

İşlevler, Azure Portalbir işlev uygulamasına Application Insights tümleştirme eklemeyi kolaylaştırır.Functions makes it easy to add Application Insights integration to a function app from the Azure portal.

1. Portal tüm hizmetler > işlev uygulamaları' nı seçin, işlev uygulamanızı seçin ve ardından pencerenin üst kısmındaki Application Insights başlığını seçinIn the portal, select All services > Function Apps, select your function app, and then select the Application Insights banner at the top of the window

   

2. Görüntünün altındaki tabloda belirtilen ayarları kullanarak bir Application Insights kaynağı oluşturun.Create an Application Insights resource by using the settings specified in the table below the image.

   

   AyarSetting	Önerilen değerSuggested value	AçıklamaDescription
   NameName	Benzersiz uygulama adıUnique app name	Kendi aboneliğinizde benzersiz olması gereken işlev uygulamanız ile aynı adı kullanmak en kolay yoldur.It's easiest to use the same name as your function app, which must be unique in your subscription.
   LocationLocation	Batı AvrupaWest Europe	Mümkünse, işlev uygulamanız ile aynı bölgeyi veya bu bölgeye yakın olanı kullanın.If possible, use the same region as your function app, or one that's close to that region.

3. Tamam’ı seçin.Select OK. Application Insights kaynak, işlev uygulamanız ile aynı kaynak grubunda ve abonelikte oluşturulur.The Application Insights resource is created in the same resource group and subscription as your function app. Kaynak oluşturulduktan sonra Application Insights penceresini kapatın.After the resource is created, close the Application Insights window.

4. İşlev uygulamanıza geri dönün, uygulama ayarları' nı seçin ve ardından uygulama ayarları' na kaydırın.Back in your function app, select Application settings, and then scroll down to Application settings. Adlı APPINSIGHTS_INSTRUMENTATIONKEYbir ayar görürseniz, Azure 'da çalışan işlev uygulamanız için Application Insights tümleştirme etkinleştirilir.If you see a setting named APPINSIGHTS_INSTRUMENTATIONKEY, Application Insights integration is enabled for your function app running in Azure.

Akış günlüklerini etkinleştirEnable streaming logs

İşlevleriniz tarafından oluşturulan günlük dosyalarının akışını, yerel bilgisayarınızdaki bir komut satırı oturumunda görüntüleyebilirsiniz.You can view a stream of log files being generated by your functions in a command-line session on your local computer.

Yerel akış günlükleriNative streaming logs

Yerleşik günlük akışıBuilt-in log streaming

Aşağıdaki örnekte olduğu gibi, Azure 'da çalışan belirli bir işlev uygulamasının akış günlüklerini almaya başlamak için seçeneğinikullanın:logstreamUse 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>

Canlı Ölçüm AkışıLive Metrics Stream

Ayrıca, aşağıdaki örnekte olduğu gibi --browser seçeneğini ekleyerek işlev uygulamanızın canlı ölçüm akışı yeni bir tarayıcı penceresinde görüntüleyebilirsiniz: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

Bu tür akış günlükleri, işlev uygulamanız için Application Insights tümleştirmeyi etkinleştirmenizi gerektirir.This type of streaming logs requires that you enable Application Insights integration for your function app.

Sonraki adımlarNext steps

Microsoft Azure Functions Core Tools kullanarak Azure işlevleri geliştirmeyi, test yapmayı ve yayımlamayı öğrenin Azure Functions Core Tools açık kaynak ve GitHub üzerinde barındırılır.Learn how to develop, test, and publish Azure Functions by using Azure Functions Core Tools Microsoft learn module Azure Functions Core Tools is open source and hosted on GitHub.
Bir hata veya özellik isteğini dosyabir GitHub sorunu açın.To file a bug or feature request, open a GitHub issue.