Azure İşlevleri local runtime and tools reference

Bu makale, Azure İşlevleri'ı destekleyen yerel çalışma zamanı ve araçlar için referans dokümantasyonu sunmaktadır. Bu araçları yerel bilgisayarınızdan Azure İşlevleri projeleri geliştirmek, yönetmek ve çalıştırmak için kullanın. İkili isim func (veya Windows'da func.exe).

İki yerel geliştirme deneyimi şu adıyla func.exesunuluyor: Azure İşlevleri Core Tools (GA) ve Azure İşlevleri CLI (önizleme). Hangi deneyimi göreceğinize seçici ile seçebilirsiniz.

Önemli

Azure İşlevleri CLI (v5) şu anda önizleme aşamasında. Bu önizleme sürümü henüz Java ve PowerShell'i desteklemez. Şu anda desteklenmeyen dillerle çalışmak için Azure İşlevleri Core Tools v4 kullanmaya devam edin.

Azure İşlevleri için iki komut satırı aracı func.exe vardır:

Azure İşlevleri Temel Araçları Azure İşlevleri CLI
func.exe versiyonu v4 v5
Destek düzeyi Genel kullanılabilirlik (GA) Preview
Ayak izini yükleme Tüm yerel diller için tüm komutları ve özellikleri içeren tam ikili. Küçük temel yüklemenin yanı sıra dil başına iş yükleri ve gerektiğinde eklediğiniz diğer özellikler. Ana bilgisayar kendi iş yükü olarak sunulur, böylece CLI'yı yeniden indirmeden en son ana bilgisayar sürümünü alırsınız.
Kullanılacağı durum Tüm geliştirme iş akışları için tam GA desteğine ihtiyacınız vardır. Yerel ortamınızı Azure barındırma planı yapılandırmanızla eşitlenmiş durumda tutan hızlı başlangıç şablonları ve profilleri gibi yeni özelliklerle hafif, iş yükü tabanlı bir deneyim istiyorsunuz.

Temel Araçları kullanma hakkında daha fazla bilgi edinmek için bkz. Azure İşlevleri Core Tools ile Work.

Temel Araçlar komutları aşağıdaki bağlamlarda düzenlenir ve her biri benzersiz bir eylem kümesi sağlar.

Komut bağlamı Açıklama
func Yerel bilgisayarınızda işlev oluşturma ve çalıştırma komutları.
func azure Yayımlama da dahil olmak üzere Azure kaynaklarla çalışmaya yarayacak komutlar.
func azurecontainerapps Kapsayıcılı işlev uygulamasını Azure Container Apps dağıtma komutları.
func bundles Uzantı paketlerini yönetme komutları.
func durable Dayanıklı İşlevler ile çalışacak komutlar.
func extensions Uzantıları yüklemek ve yönetmek için komutlar.
func kubernetes Kubernetes ve Azure İşlevleri ile çalışmaya yönelik komutlar.
func settings Yerel İşlevler konağı için ortam ayarlarını yönetme komutları.
func templates Kullanılabilir işlev şablonlarını listeleme komutları.

Bu makaledeki komutları kullanmadan önce Core Tools'u yükleyin.

Önemli

Azure İşlevleri CLI (v5) şu anda önizleme aşamasında. Bu önizleme sürümü henüz Java ve PowerShell'i desteklemez. Şu anda desteklenmeyen dillerle çalışmak için Azure İşlevleri Core Tools v4 kullanmaya devam edin.

CLI kullanımı, kurulum ve iş yükleri dahil olmak üzere, Develop Azure İşlevleri local olarak Azure İşlevleri CLI sayfasına bakınız.

Aşağıdaki yerleşik komutlar temel CLI kurulumuyla birlikte gelir:

Command Açıklama
func init Yeni bir Azure İşlevleri projesini başlatın.
func new Bir şablondan yeni bir fonksiyon oluşturun.
func run Azure İşlevleri host runtime'ını yerel olarak başlatın. func start geriye dönük uyumlu bir takma addır.
func quickstart Hızlı başlatma şablon kataloğundan tüm fonksiyon uygulamalarını inceleyin ve inşa edin.
func profile Azure İşlevleri CLI profillerini incele ve yönet.
func setup Yerel Azure İşlevleri CLI bağımlılıklarını hazırlayın (host runtime, language workers, extension bundles).
func workload Kurulu CLI iş yüklerini yönetin.

İş yükleri ek üst düzey komutlar sağlayabilir. Bu komutlar yalnızca katkı sağlayan iş yükünü yükledikten sonra görünür.

func init

Belirli bir dilde yeni bir İşlevler projesi oluşturur.

func init [<PROJECT_FOLDER>]

Sağladığınızda <PROJECT_FOLDER>, komut bu isimle yeni bir klasörde projeyi oluşturur. Aksi takdirde, mevcut klasörü kullanır.

Komut, func init sürüme bağlı olarak şu seçenekleri destekler:

Seçenek Açıklama
--bundles-channel, -c Uzantı paketi yayın kanalı. Desteklenen değerler şunlardır: GA (varsayılan), Previewve Experimental. Yalnızca .NET olmayan projeler için geçerlidir.
--configuration-profile Bir projeyi konak yapılandırma profiliyle başlatır. Bu --configuration-profile seçenek şu anda önizleme aşamasındadır. Daha fazla bilgi için bkz . Yapılandırma profilleri.
--csx C# script olarak .NET fonksiyonları oluşturur. Yalnızca --worker-runtime dotnet ile geçerlidir.
--docker Seçilen --worker-runtime'ye dayalı bir temel görüntü kullanarak bir konteyner için Dockerfile oluşturur. Kapsayıcılı işlev uygulaması dağıtmayı planlarken bu seçeneği kullanın.
--docker-only Var olan bir projeye Dockerfile ekler. local.settings.jsonbelirtilmezse veya ayarlanmadıysa çalışan-çalışma zamanını sorar. Kapsayıcılı işlev uygulaması dağıtmayı planlıyorsanız ve proje zaten mevcutsa bu seçeneği kullanın.
--force Projede mevcut dosyalar olsa bile projeyi başlatır. Bu ayar, aynı ada sahip mevcut dosyaların üzerine yazar. Proje klasöründeki diğer dosyalar etkilenmez.
--language, -l Dile özgü bir projeyi başlatır. Şu anda olarak ayarlandığında --worker-runtimedesteklenmektedirnode. Seçenekler ve typescriptşeklindedirjavascript. veya --worker-runtime javascriptde kullanabilirsiniz--worker-runtime typescript.
--managed-dependencies Yönetilen bağımlılıkları yükler. Şu anda bu özelliği yalnızca PowerShell çalışan çalışma zamanı desteklemektedir.
--model, -m Birden fazla model kullanılabilir olduğunda hedef dil için programlama modelini ayarlar. Desteklenen seçenekler Python için V1 ve V2 ve Node.jsiçin V3 ve V4'dır. Daha fazla bilgi için bkz. Python geliştirici kılavuzu ve Node.js geliştirici kılavuzu.
--no-bundle host.json'de uzantı paketini yapılandırmayın. Yalnızca .NET olmayan projeler için geçerlidir.
--no-docs "Başlarken" belge dosyalarını oluşturma işlemini atlar. Python projeler için geçerlidir.
--skip-npm-install Proje oluşturulduktan sonra çalıştırmayı npm install atlayın. Node.js projeler için geçerlidir.
--source-control Git deposunun oluşturulup oluşturulmayacağını denetler. Varsayılan olarak bir depo oluşturulmaz. olduğunda truebir depo oluşturulur.
--worker-runtime Proje için dil çalışma zamanını ayarlar. Desteklenen değerler şunlardır: csharp, dotnet, dotnet-isolated, javascript, , node (JavaScript), powershell, pythonve typescript. Java için Maven kullanın. Yalnızca proje dosyalarıyla dilden bağımsız bir proje oluşturmak için kullanın custom. Ayarlanmadığında başlatma sırasında çalışma zamanınızı seçmeniz istenir.
--target-framework İşlev uygulaması projesi için hedef çerçeveyi ayarlar. Yalnızca --worker-runtime dotnet-isolated ile geçerlidir. Desteklenen değerler şunlardır: net10.0 (önizleme), net9.0, net8.0 (varsayılan), net6.0 ve net48 (.NET Framework 4.8).

Not

--docker veya --docker-only seçeneğini kullandığınızda, Çekirdek Araçlar otomatik olarak C#, JavaScript, Python ve PowerShell işlevleri için Dockerfile'ı oluşturur. Java işlevleri için Dockerfile dosyasını el ile oluşturmanız gerekir. Daha fazla bilgi için bkz . Kapsayıcılı işlev uygulamaları oluşturma.

Yapılandırma profilleri

Önemli

Yapılandırma profilleri desteği şu anda önizleme aşamasındadır.

Bu seçeneği kullandığınızda --configuration-profile , önceden tanımlanmış bir proje yapılandırması ve ayarı seti oluşturuyorsunuz. Bir yapılandırma profili belirttiğinizde, başlatma diğer tüm başlatma adımlarını atlayabilir.

Profil değeri Açıklama Belirli eylemler
mcp-custom-handler Yapay zeka aracılarının ve diğer MCP istemcilerinin bağlanabileceği bir MCP (Model Bağlam Protokolü) sunucusunu barındırmak için özel işleyiciler kullanan bir proje oluşturur. • "configurationProfile": "mcp-custom-handler" dosyasındaki öğeyi belirli özel işleyici ayarlarıyla yapılandırılır.
• MCP_EXTENSION_ENABLEDolarak ayarlar true.		 
func init [<PATH>] [options]

Sağladığınızda <PATH>, proje o klasörde oluşturulur. Aksi takdirde geçerli klasör kullanılır.

Komut func init şu yerleşik seçenekleri destekler:

Seçenek Açıklama
--stack, -s Proje için kullanılacak yığın (örneğin, python, node, dotnet, ). go Kurulu iş yüklerinizin katkı sağladığı yığınları görmek için koşun func workload list .
--name, -n Fonksiyon uygulaması projesinin adı.
--language, -l Programlama dili (örneğin, C#, F#, JavaScript, TypeScript, Python). Bir yığın birden fazla dili desteklediğinde kullanılır. Desteklenen değerler kurulu yığın iş yüklerinden hesaplanır.
--force Hedef klasör boş olmasa bile yeniden başlat. İskele yapmadan önce klasörü (hariç .git) temizler.

İş yükleri, iş yükünün adı altında gruplanan ek seçenekler sağlar func init --help. Stack başına seçenekler için iş yüküne özgü seçeneklere bakınız.

İstenen yığını sağlanmıyorsa, Komut Sistemi sıfır olmayan bir çıkış koduyla işaret func workload install eden bir ipucu yazdırır ve çıkış yapar.

İş yüküne özgü seçenekler

init Komut, şu iş yüklerinden birini veya birkaçını yüklediğinizde genişler:

Seçenek Açıklama
--target-framework, -tfm Proje için hedef .NET çerçeve (örneğin, net10.0). Varsayılan: net10.0.

.NET başlatıcısı bir uzantı paketi bloğu yazmaz, bu yüzden --no-bundles ve --bundles-channel geçerli değildir.

Birden fazla yük aynı seçeneği kattığında, seçenek bir kez görünür func init --help.

Paylaşılan seçenekler

Şu anda paylaşılan seçenekler --no-bundles ve --bundles-channel. Yazdığınız varsayılan uzantı paket kimliğihost.json seçilen kanala bağlıdır:

Kanal Paket Kimliği
GA (varsayılan) Microsoft.Azure.Functions.ExtensionBundle
Preview Microsoft.Azure.Functions.ExtensionBundle.Preview
Experimental Microsoft.Azure.Functions.ExtensionBundle.Experimental

Varsayılan sürüm aralığı [4.*, 5.0.0).

func new

Geçerli projede şablona dayalı olarak yeni bir işlev oluşturur.

func new

Komut, func new sürüme bağlı olarak şu seçenekleri destekler:

Seçenek Açıklama
--authlevel, -a HTTP tetikleyicisi için yetkilendirme düzeyini ayarlar. Desteklenen değerler şunlardır: function, anonymous, admin. Yerel olarak çalıştırılırken yetkilendirme uygulanmaz. Daha fazla bilgi için bkz . Yetkilendirme düzeyi.
--csx Sürüm 1'de ve portalda kullanılan aynı C# script (.csx) şablonlarını oluşturur.
--file, -f Yeni işlevin hedef dosyası. Python v2 projeleri için, işlevin ekleneceği dosyayı belirtir (varsayılan olarak function_app.py). Node.js v4 projeleri için, klasöründeki src/functions çıkış dosyası adını belirtir. Derlenmiş .NET projeleri için geçerli değildir.
--name, -n İşlev adı.
--template, -t func templates list Desteklenen her dil için kullanılabilir şablonların tam listesini görmek için komutunu kullanın.

Daha fazla bilgi için bkz . İşlev oluşturma.

func new [<PATH>] [options]

Önemli

func new şu anda bir önizleme taslağı. Bir iş yükü kurulum ipucu yazdırır ve bir şablon iş yükü kurulup kablolanana kadar sıfır olmayan çıkış koduyla çıkar. Şablona özgü seçenekler dinamik olarak şablon meta verilerinden hidratlanır, bu yüzden yeni bir şablon seçeneği eklemek için bir CLI sürümü gerekmez.

Komut func new şu yerleşik seçenekleri destekler:

Seçenek Açıklama
--name, -n İşlev adı.
--template, -t Fonksiyon şablonu adı. Mevcut şablonlar, projenin yığınının yüklü <stack>-templates iş yükünden gelir.
--force Varolan dosyaların üzerine yaz.

Ek seçenekler seçilen şablon tarafından dinamik olarak sağlanır. Belirli bir şablon için seçeneklere bakmak için koş func new --template <name> --help .

Mevcut proje için şablon iş yükü kurulmadıysa, CLI işaret eden func workload installbir ipucu yazdırır.

func logs

Kubernetes kümesinde çalışan işlevlerin günlüklerini alır.

func logs --platform kubernetes --name <APP_NAME>

Komut func logs şu seçenekleri destekler:

Seçenek Açıklama
--platform İşlev uygulaması için barındırma platformu. Geçerli seçenekler: kubernetes.
--name Azure işlev uygulaması adı.

Daha fazla bilgi için bkz. KEDA ile Kubernetes'te Azure İşlevleri.

func pack

Proje kodunuzu çalıştırılabilir durumda içeren bir dağıtım paketi oluşturur. Yerel bilgisayarınızda uygulamanız için komutun func azure functionapp publish dışında el ile dağıtım paketi oluşturmanız gerektiğinde bu yöntemi kullanın. Varsayılan olarak, func pack gerektiğinde projenizi oluşturur.

Go fonksiyon uygulamaları için func pack, Azure CLI az functionapp deployment source config-zip komutunu kullanarak dağıtabileceğiniz bir Linux x64 dağıtım paketi oluşturur.

func pack [<FOLDER_PATH>]

Varsayılan olarak, func pack geçerli dizini paketler ve çıkış .zip dosyası projenizin kök klasörüyle aynı ada sahiptir. func pack proje dosyanızı içeren dizinde komutunu çalıştırın. Başka bir dizinde çalıştırmanız func pack gerekiyorsa, gibi <FOLDER_PATH>proje kökü yolu olarak ayarlayınfunc pack ./myprojectroot. Belirli bir .zip dosyası zaten varsa, önce silinir ve ardından güncelleştirilmiş bir sürümle değiştirilir.

Komut func pack şu seçenekleri destekler:

Seçenek Açıklama
--output, -o Dağıtım .zip paket dosyasının oluşturulduğu konumun yolunu ayarlar.
--no-build Project toplanmadan önce oluşturulmaz. C# uygulamaları için yalnızca ikili dosyalarınızı önceden oluşturduğunuzda kullanın. Node.js uygulamalar için hem hem de npm installnpm run build atlanır. Go uygulamaları için, sadece bin/app zaten Linux x64 ikili kartı içerdiğinde kullanın.
--skip-install Node.jstabanlı işlev uygulamasını paketleme sırasında çalıştırmayı npm install atlar. Özel npm modüllerinin üzerine yazılmasını önlemek için kullanılır.
--build-native-deps Python bağımlılıklarını, Azure kullanılan ortamla eşleşen bir görüntü kullanarak yerel olarak yükler. Etkinleştirildiğinde, Core Tools bir Docker kapsayıcısı başlatır, uygulamayı bu kapsayıcının içinde oluşturur ve içinde tüm bağımlılıkların geri yükleneceği .python_packagesbir .zip dosyası oluşturur. Azure'da Linux'a dağıttığınızda olası kitaplık sorunlarını önlemek için Windows çalışırken bu seçeneği kullanın.

func run (sadece v1)

Not

Bu komut yalnızca Core Tools'un 1. sürümü için geçerlidir ve kullanımdan kaldırılmıştır. Sürüm 4 için, func start ve çağırın.

Bir fonksiyonu doğrudan çağırır; bu, Azure portalındaki Test sekmesini kullanarak bir fonksiyonu çalıştırmaya benzer şekilde bir fonksiyonu çağırır.

func run

Komut func run şu seçenekleri destekler:

Seçenek Açıklama
--content İşleve satır içi içerik geçirildi.
--debug İşlevi çalıştırmadan önce konak işlemine bir hata ayıklayıcısı ekleyin.
--file İçerik olarak kullanılacak dosya adı.
--no-interactive Otomasyon senaryoları için yararlı olan girdileri sormaz.
--timeout Yerel İşlevler konağı hazır olana kadar bekleme süresi (saniye cinsinden).

Örneğin, HTTP ile tetiklenen bir işlevi çağırmak ve içerik gövdesini geçirmek için şu komutu çalıştırın:

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

func start

Yerel çalışma zamanı ana bilgisayarını başlatır ve işlev projesini geçerli klasöre yükler.

Belirli komut çalışma zamanı sürümüne bağlıdır.

func start

Komut func start şu seçenekleri destekler:

Seçenek Açıklama
--cert Özel anahtar içeren bir .pfx dosyasının yolu. Yalnızca ile --useHttpsdesteklenir.
--cors Boşluk içermeyen, virgülle ayrılmış CORS çıkış noktaları listesi.
--cors-credentials Tanımlama bilgilerini ve Kimlik doğrulaması üst bilgisini kullanan çıkış noktaları arası kimliği doğrulanmış isteklere izin verir.
--dotnet-isolated-debug true olarak ayarlandığında, hata ayıklanan yalıtılmış .NET projeden bir hata ayıklayıcı eklenene kadar .NET çalışan işlemini duraklatır.
--enable-json-output Mümkün olduğunda konsol günlüklerini JSON olarak yayar.
--enableAuth Yetkilendirme gereksinimlerine sahip tam kimlik doğrulama işleme işlem hattını etkinleştirir.
--functions Yüklenecek işlevlerin boşlukla ayrılmış listesi.
--json-output-file Sağlanırsa, kullanırken --enable-json-outputçıkışı yazmak için kullanılan dosyanın yolu.
--language-worker Dil çalışanını yapılandırmak için bağımsız değişkenler. Örneğin, debug bağlantı noktası ve diğer gerekli bağımsız değişkenler sağlayarak dil çalışanı için hata ayıklamayı etkinleştirebilirsiniz.
--no-build Çalıştırmadan önce geçerli projeyi oluşturmayın. Yalnızca .NET sınıf projeleri için. Varsayılan false değeridir.
--password Parola veya .pfx dosyasının parolasını içeren bir dosya. Yalnızca ile --certkullanılır.
--port, -p Dinlenecek yerel bağlantı noktası. Varsayılan değer: 7071.
--runtime Konağın başlatıldığı sürümü ayarlar. İzin verilen değerler şunlardır: inproc6, inproc8ve default (işlem dışı konağı çalıştırır).
--timeout, -t İşlevler ana bilgisayarının saniyeler içinde başlatılması için zaman aşımı. Varsayılan: 20 saniye.
--useHttps yerine öğesine https://localhost:{port}http://localhost:{port}bağlayın. Varsayılan olarak, bu seçenek bilgisayarınızda güvenilir bir sertifika oluşturur.
--user-log-level Kullanıcı günlükleri için en düşük günlük düzeyini ayarlar. Geçerli değerler şunlardır: Trace, Debug, Information, Warning, Error, , Criticalve None. Bu ayar sistem günlüklerini etkilemez. Yalıtılmış .NET projeler için, bu seçeneğin geçerli olması için Program.cs kullanarak builder.Logging.SetMinimumLevel(LogLevel.Debug)'da en düşük düzeyi de ayarlayın.

Proje çalışırken işlev uç noktalarını tek tek doğrulayın.

func run

Functions ana bilgisayarının çalışma zamanını başlatır ve projeyi mevcut klasöre yükler.

func run [<PATH>] [options]

func start geriye dönük uyumlu bir takma ad olarak korunur ve aynı argümanları ve seçenekleri kabul eder.

Komut func run şu seçenekleri destekler:

Seçenek Açıklama
--port, -p Dinlenecek yerel bağlantı noktası. Varsayılan: 7071.
--cors Boşluk içermeyen, virgülle ayrılmış CORS çıkış noktaları listesi.
--cors-credentials Çerezler ve Authentication başlık kullanan çapraz orijinal doğrulamalı isteklere izin verin.
--functions Yüklenecek işlevlerin boşlukla ayrılmış listesi.
--no-build Projeyi çalışmadan önce inşa etmeyin.
--enable-auth Yetkilendirme gereksinimleri dahil olmak üzere tam kimlik doğrulama-işleme boru hattını etkinleştirin.
--host-version, -v Kullanılacak ana bilgisayar çalışma zamanı sürümü (örneğin, 4.1049.0).
--profile Azure İşlevleri profili, host, worker ve bundle sürümlerini çözerken uygulanır. Bkz. func profile.
--offline Sadece yerel olarak yüklenmiş iş yüklerini kullanın ve ağ kurulumlarını atlayın.
--output Çıkış modu: compact (etkileşimli TUI), plain (CI / TTY olmayan) veya json (programatik tüketiciler ve yapay zeka ajanları için NDJSON). Terminale göre otomatik algılama varsayılan olarak kalıyor.
--no-tui Diğer ad için --output=plain. Etkileşimli TUI'yi devre dışı bırakır.
--log-file Tüm ana bilgisayar olaylarını belirtilen log dosyasına yansıtın.
--no-azurite Yönetilen Azurite'i devre dışı bırak. Ana bilgisayar, yerel bir e-mülatör başlatmadan veya problama yapmadan başlar.

Proje çalışırken, davranışı doğrulamak için fonksiyon uç noktalarını doğrudan çağırın.

Yönetilen Azurite

Projeniz yerel depolama kullandığında (örneğin, AzureWebJobsStorage=UseDevelopmentStorage=true), func run otomatik olarak çalışan bir Azurite emülatörü olup olmadığını kontrol eder ve bulamazsa birini başlatır. E-mülletör çıktığında func run duruyor. Azurite'ı --no-azurite kendiniz yönetip geçiş yapın.

Çıkış modları

func run terminale göre otomatik olarak bir çıkış modunu seçer:

Condition Modül
Etkileşimli terminal (TTY) compact
Etkileşimsiz stdout, yönlendirilmiş çıktı veya CI ortam değişken kümesi plain
Açık --output=json json

CLI asla otomatik seçim yapmaz json. Eğer compact isteniyorsa ama stdout bir TTY değilse, CLI stderr'e plain düşürür ve bir satırlık bildirim yazar. Mod, json her satır için bir nesne olan yeni satırla belirlenmiş JSON (NDJSON) yayımlar; bir schema_version nesne ile .1

func quickstart

Azure İşlevleri hızlı başlatma şablon kataloğundan tamamlanmış fonksiyon uygulamalarını inceler ve iskeleler yapar. Hızlı başlatma şablonları, HTTP API, kuyruk tetikleyici veya Dayanıklı İşlevler orkestrasyonu gibi tam örnek uygulamalardır. Stack iş yükleri, dile özgü çözücülere katkıda bulunur. Katalog, komut-çağrı zamanında alınır.

func quickstart [<PATH>] [options]

Sağladığınızda <PATH>, proje o klasörde oluşturulur. Aksi takdirde geçerli klasör kullanılır.

Komut func quickstart şu seçenekleri destekler:

Seçenek Açıklama
--stack, -s Kullanılacak yığın, örneğin python, node, , veya dotnet.
--language, -l Programlama dili. Desteklenen değerler kurulu hızlı başlatma sağlayıcılarından gelir.
--template, -t Katalogdan şablon kimliği, örneğin http-trigger-python-azd. Tüm etkileşimli istemleri atlar.
--resource, -r Tetikleyici veya bağlama kaynağına göre filtreleyin, örneğin http, timer, blob, eventhub, servicebuscosmossqlmcp, veya .durable
--iac Altyapı-kod türüne göre filtreleyin, örneğin bicep, , terraform, veya none.
--search Şablon isimlerine ve açıklamalara uygulanan küçük harf duyarsız alt dizim filtresi.
--fetch Katalog getirme stratejisi: auto (varsayılan), git, veya http. auto HTTP için araştırma git yapar ve tekrar HTTP'ye geri döner.
--force Hedef klasör boş olmasa bile iskele yapın. İskele yapmadan önce klasörü (hariç .git) temizler.

Alt komutlar:

Subcommand Açıklama
func quickstart list Katalogda mevcut şablonları listeleyin.
func quickstart info Belirli bir şablonun detaylarını gösterin.

func quickstart list

Katalogdan mevcut şablonları listeler, isteğe bağlı olarak filtrelenir.

func quickstart list [options]
Seçenek Açıklama
--stack, -s Kullanılacak yığın, örneğin python, node, , veya dotnet.
--language, -l Programlama dili. Desteklenen değerler kurulu hızlı başlatma sağlayıcılarından gelir.
--resource, -r Tetikleyici veya bağlama kaynağı ile filtreleyin.
--iac Altyapı-kod türüne göre filtreleyin.
--search Küçük harf duyarsız alt dizi ID'ler, şablon adları, kaynak türü, Kod olarak Altyapı tipi ve açıklamalarla eşleşir.
--json Tablo yerine makine tarafından okunabilir JSON yayımlayın.

func quickstart info

Belirli bir şablon hakkında ayrıntılı bilgiler gösterir.

func quickstart info <ID> [options]

<ID> katalogdan alınan şablon ID'dir. Mevcut kimlikleri keşfetmek için kullanın func quickstart list .

Seçenek Açıklama
--json Biçimlendirilmiş çıktı yerine makine tarafından okunabilir JSON yayımlayın.

func profile

Azure İşlevleri CLI profillerini inceler ve yönetir. Profiller, ana sürüm aralığı, uzantı paketi sürüm aralığı ve işçi sürüm aralıkları gibi sürüm kısıtlamalarını kodlar. Ayrıca mirası diğer profillerden tanımlar. Profil kaynakları arasında project-local (.func/profiles/), user-global (~/.azure-functions/profiles/) ve yerleşik profiller bulunur. Sunucuyu başlatırken hangi profilin kısıtlamalarının uygulanacağını seçmek için seçeneği kullanın func run --profile <name> .

func profile <subcommand>

Alt komutlar:

Subcommand Açıklama
func profile list Proje, kullanıcı ve yerleşik kaynaklardan erişilebilen profilleri listeleyin.
func profile show Profil için detayları gösterin.
func profile set Bir proje için varsayılan profili ayarlayın.

func profile list

Proje, kullanıcı ve yerleşik kaynaklardan mevcut profilleri listeler. İsim, kaynak, ana sürüm, uzantı paketi ve durum tablosu oluşturur.

func profile list [<PATH>] [options]
Seçenek Açıklama
--source Virgülle ayrılmış kaynak listesi şunları içerir: project, user, built-in. Tüm kaynaklara varsayılan olarak yazılır.
--json Tablo yerine makine tarafından okunabilir JSON yayımlayın.

func profile show

Tek bir profil için detayları gösterir; ya çözülmüş (kalıtsal değerler uygulanmış) ya da ham (yazıldığı gibi, miras genişletmesi olmadan tanım).

func profile show <NAME> [<PATH>] [options]
Seçenek Açıklama
--raw Ham profil tanımını miras alınmış değerler olmadan gösterin.

func profile set

Bir Fonksiyon projesi için varsayılan profili, profil adını projenin içine .func/config.jsonyazarak ayar. Profil zaten projenin profil listesinde değilse, ekleyin.

func profile set <NAME> [<PATH>]

func setup

Azure İşlevleri projelerini çalıştırmak için yerel makineyi hazırlar. Belirttiğiniz yığınlar için ana bilgisayar çalışma zamanını, dil çalışanlarını, uzantı paketlerini ve şablonları yükler veya doğrular. Profil tabanlı sürüm kısıtlamalarını, ön sürüm seçimini, etkileşimsiz CI modunu ve sadece kontrol modunu destekler.

func setup [<PATH>] [options]

--features Ne kurulacağını veya neyin doğrulanacağını seçiyor. Her birinin çözdüğü özellikler ve iş yükleri şunlardır:

Özellik Kurulu iş yükleri
node host, bundles, node, node-worker, , node-templates
python host, bundles, python, python-worker, , python-templates
go host, bundles, go, go-worker
dotnet host, dotnet, dotnet-templates
runtime host, bundles
host host sadece

--features tekrarlanabilir ve virgülle ayrılmış değerleri kabul eder, böylece özellikleri tek bir çağrıda birleştirebilirsiniz (örneğin, func setup --features node,python). dotnet-isolated için takma ad dotnetolarak kabul edilir.

Seçenek Açıklama
--features Kurulum veya doğrulama için bileşenler. Tekrarlanabilir veya virgül ayrılmış. Her özelliğin yüklediği iş yükleri için yukarıdaki tabloya bakınız.
--profile Azure İşlevleri profile for version constraints. Tekrarlanabilir. --profilesile birleştirilmiş.
--profiles Verim kısıtlamaları için kullanılacak Azure İşlevleri profillerinin virgülle ayrılmış listesi.
--install-policy Kurulum politikası: latest-compatible (varsayılan) veya if-needed.
--source İş yükü çözümlemesi ve kurulumu için NuGet paket kaynağı.
--prerelease Katalogdan çözüm alırken ön sürüm iş yükü sürümlerine izin verin. Varsayılan: iş yükleri önizleme aşamasındayken etkinleştirildi.
--non-interactive Giriş için isteme.
--yes, -y Kurulum istemlerine evet yanıtını ver.
--check Seçilen bağımlılıkların kurulup kurulmadığını doğrulamak, değişiklik yapmadan.
--output Çıkış modu: plain (varsayılan) veya json (NDJSON).

func workload

Azure İşlevleri CLI için kurulan iş yüklerini yönetir.

func workload <subcommand>

Alt komutlar:

Subcommand Açıklama
func workload list Kurulu iş yüklerini listeleyin.
func workload search İş yükü kataloğunu arayın.
func workload install Bir iş yükü kur.
func workload update Kurulumlu bir iş yükünü güncelleyin.
func workload uninstall Bir iş yükünü kaldırın.
func workload prune Yan yana aktif olmayan iş yükü kurulumlarını kaldırın.

func workload list

Yüklü iş yüklerini listeler. Varsayılan olarak, komut yalnızca her iş yükünün yüklü (en yüksek yüklü sürümü) gösteren versiyonunu gösterir. Her kurulumu yan yana görmek için kullanılırdı --all-versions .

func workload list [options]
Seçenek Açıklama
--all-versions, -a Her iş yükünün yüklü her sürümünü listeleyin. Varsayılan: sadece yüklü sürüm.
--json Tablo yerine makine tarafından okunabilir JSON yayımlayın.

Mevcut iş yükü paketlerini bulmak için yapılandırılmış iş yükü kataloğunda arama yapar.

func workload search [<QUERY>] [options]

Atladığınızda <QUERY>, komut katalogdaki tüm iş yüklerini listeler.

Seçenek Açıklama
--source Arama için katalog kaynak URL'si. Varsayılan olarak yapılandırılmış kataloğa geçer.
--prerelease Sonuçlara ön sürümleri ekleyin. Varsayılan: iş yükleri önizleme aşamasındayken etkinleştirildi.
--json Tablo yerine makine tarafından okunabilir JSON yayımlayın.

func workload install

Bir iş yükü paket kimliğini (veya aliasını) yapılandırma katalogu üzerinden çözer ve yükler.

func workload install <ID> [options]

<ID> iş yükü paket kimliği, bir takma ad (örneğin, python) veya yerel bir iş yükü paket dosyasına giden yol olabilir.

Seçenek Açıklama
--version, -v Kurulum için özel bir sürüm. Varsayılan: katalogdaki en son kararlı sürüm.
--source Çözüm için kaynak URL veya yerel dizini kataloglayın. Varsayılan: yapılandırılmış katalog.
--prerelease Katalogdan çözüm alırken ön sürüm sürümlerine izin verin. Varsayılan: iş yükleri önizleme aşamasındayken etkinleştirildi.
--force, -f Aynı ID ve sürümdeki mevcut bir kurulumun üzerine yaz. Ayrıca "güncellemeyi kullan" çağrısını da atlıyor.
--exact, -e Takma ad eşleştirmesini devre dışı bırak. <ID> Paket kimliğinin gerçek anlamı olmalı.

Eğer iş yükünün bir sürümü zaten yüklüyse, Komut Sistemi size bunun yerine kullanmanızı func workload update önerir. Etkileşimsiz bağlamlar ise promptu bir düşüş olarak ele alır.

func workload update

Kurulu bir iş yükü için yerinde atomik sürüm değişimi gerçekleştirir. Güncellemeler yan yana değil; yan yana kurulumlar func workload install --forceiçin .

func workload update [<ID>] [options]

Tek bir iş yükünü veya <ID> tüm yüklü iş yükünü güncellemek için pass an --all yapın. Bu iki seçenekten tam olarak birini belirtin.

Seçenek Açıklama
--version, -v Yenisini yüklemek için sürüm. Varsayılan: en yüksek yüklü sürüm.
--all Kurulu her iş yükünü güncelleyin. <ID> ile birbirini dışlar.
--major Büyük versiyon sınırını geçmesine izin verin. Varsayılan: sadece aynı bölüm.
--source Çözüm için kaynak URL veya yerel dizini kataloglayın. Varsayılan: yapılandırılmış katalog.
--prerelease Katalogdan çözüm alırken ön sürüm sürümlerine izin verin. Varsayılan: iş yükleri önizleme aşamasındayken etkinleştirildi.
--exact, -e Takma ad eşleştirmesini devre dışı bırak. <ID> Paket kimliğinin gerçek anlamı olmalı.

func workload uninstall

Bir iş yükünün yüklü sürümlerinden birini veya tamamını kaldırır.

func workload uninstall <ID> [options]
Seçenek Açıklama
--version, -v Kaldırılması gereken özel bir sürüm. Varsayılan olan: tek yüklü sürüm.
--all-versions, -a Tüm yüklü iş yükü sürümlerini kaldırın. --version ile birbirini dışlar.
--exact, -e Takma ad eşleştirmesini devre dışı bırak. <ID> Paket kimliğinin gerçek anlamı olmalı.

func workload prune

Yan yana aktif olmayan iş yükü kurulumlarını kaldırır. Her kapsam içi paket kimliği için komut en yüksek yüklü sürümü korur ve eski sürümleri kaldırır. Bu komut sadece yerel olarak ve kataloğa hiç dokunmaz.

func workload prune [<ID>] [options]

Atladığınızda <ID>, komut tüm yüklü iş yüklerini busar.

Seçenek Açıklama
--exact, -e Takma ad eşleştirmesini devre dışı bırak. <ID> Paket kimliğinin gerçek anlamı olmalı.

func azure functionapp

Bağlam func azure functionapp aşağıdaki komutları içerir:

Tüm func azure functionapp komutlar şu seçenekleri destekler:

Seçenek Açıklama
--slot Yapılandırıldıysa belirli bir adlandırılmış dağıtım yuvayı hedefler.
--access-token Azure'da kimliği doğrulanmış eylemleri gerçekleştirmek için kullanılacak varsayılan belirteç dışında bir erişim belirteci sağlar.
--access-token-stdin Standart girişten belirli bir erişim belirtecini okur. Belirteci doğrudan gibi az account get-access-tokenönceki bir komuttan okurken bu seçeneği kullanın.
--management-url varsayılan olarak https://management.azure.com olan Azure bulutunun yönetim URL'sini ayarlar. İşlev uygulamanız bağımsız bir bulutta çalıştırıldığında bu seçeneği kullanın.
--subscription Varsayılan Azure aboneliğini ayarlar.

func azure functionapp fetch-app-settings

Belirli bir işlev uygulamasından ayarları alır.

func azure functionapp fetch-app-settings <APP_NAME>

Daha fazla bilgi için bkz . Uygulama ayarlarını indirme.

Komut, ayarları projeninlocal.settings.json dosyasına indiriyor. Ekran değerleri güvenlik için maskelenir. local.settings.json dosyasındaki ayarları yerel şifrelemeyi etkinleştirerek koruyabilirsiniz.

func azure functionapp list-functions

Belirtilen işlev uygulamasındaki işlevleri listeler.

func azure functionapp list-functions <APP_NAME>

Komutu func azure functionapp list-functions şu seçeneği destekler:

Seçenek Açıklama
--show-keys Döndürülen işlev uç noktası URL'lerine işlev düzeyi erişim anahtarı değerlerini ekleyin.

func azure functionapp logstream

Azure'da işlev uygulamasının akış günlüklerine yerel komut istemini bağlar.

func azure functionapp logstream <APP_NAME>

Bağlantı için varsayılan zaman aşımı 2 saattir. saniye olarak zaman aşımı değeriyle SCM_LOGSTREAM_TIMEOUT adlı bir uygulama ayarı ekleyerek zaman aşımını değiştirin. Esnek Tüketim veya Tüketim planında Linux için henüz desteklenmiyor. Bu uygulamalar için portalda --browser günlükleri görüntüleme seçeneğini kullanın.

Komutu func azure functionapp logstream şu seçeneği destekler:

Seçenek Açıklama
--browser varsayılan tarayıcıda işlev uygulaması için Azure Uygulaması Insights Canlı Akışı'nı açın.

Daha fazla bilgi için bkz. Azure İşlevleri'da akış yürütme günlüklerini etkinleştirme.

func azure functionapp publish

bir İşlevler projesini Azure'daki mevcut bir işlev uygulaması kaynağına dağıtır.

func azure functionapp publish <APP_NAME>

Daha fazla bilgi için bkz . Proje dosyalarını dağıtma.

Sürüme göre aşağıdaki yayımlama seçenekleri geçerlidir:

Seçenek Açıklama
--additional-packages Yerel bağımlılıklar oluştururken yüklenecek paketlerin listesi. Örneğin: python3-dev libevent-dev.
--build, -b Linux işlev uygulamasına dağıtım yaparken bir derleme eylemi gerçekleştirir. Kabul eder: remote ve local.
--build-native-deps Python işlev uygulamalarını yayımladığınızda .wheels klasörünü oluşturmayı atlar.
--csx C# betiği (.csx) projesi yayımlama.
--dotnet-cli-params Derlenmiş C# (.csproj) işlevlerini yayımladığınızda, çekirdek araçlar öğesini çağırır dotnet build --output bin/publish. Bu seçeneğe geçirilen tüm parametreler komut satırına eklenir.
--dotnet-version dotnet-isolated uygulamaları için hedef .NET sürümünü belirtir (örneğin, 8.0).
--force Bazı senaryolarda hazırlık doğrulamasını yoksayar.
--list-ignored-files .funcignore dosyasını temel alarak yayımlama sırasında yoksayılan dosyaların listesini görüntüler.
--list-included-files .funcignore dosyasını temel alan, yayımlanan dosyaların listesini görüntüler.
--no-build Project yayımlama sırasında oluşturulmaz. Python için pip install çalışmaz.
--nozip Varsayılan Run-From-Package modu kapatır. Dosyaları wwwroot doğrudan dağıtım paketinden çalıştırmak yerine sunucudaki klasöre ayıklar.
--overwrite-settings, -y kullanırken --publish-local-settings -iuygulama ayarlarının üzerine yazma istemini gizler.
--publish-local-settings, -i local.settings.json ayarlarını Azure yayımlar ve ayarın zaten mevcut olup olmadığının üzerine yazılmasını ister. Yerel depolama öykünücüsü kullanıyorsanız, önce uygulama ayarını gerçek bir depolama bağlantısı olarak değiştirin.
--publish-settings-only, -o Yalnızca ayarları yayımlar ve içeriği atlar. Varsayılan istemdir.
--show-keys Günlüklerde görüntülenen URL'lere işlev anahtarları ekler.

func azure storage fetch-connection-string

Belirtilen Azure Depolama hesabı için bağlantı dizesi alır.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Daha fazla bilgi için bkz. >bağlantı dizesi depolamayı indirme.

func azurecontainerapps deploy

Kapsayıcılı işlev uygulamasını Azure Container Apps bir ortama dağıtır. Varsayılan ana depolama hesabı, işlev uygulaması ve ortam zaten var olmalıdır. Daha fazla bilgi için bkz. Azure Container Apps barındırma Azure İşlevleri.

func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>

Aşağıdaki dağıtım seçenekleri geçerlidir:

Seçenek Açıklama
--environment Mevcut Container Apps ortamının adı.
--image-build true Yerel Docker derlemesini atlamak için olarak ayarlayın.
--image-name Etiket adı da dahil olmak üzere bir kapsayıcı kayıt defterindeki mevcut kapsayıcı görüntüsünün adı.
--location Dağıtımın bölgesi. İdeal olarak, bu bölge ortam ve depolama hesabı kaynaklarıyla aynıdır.
--name Container Apps ortamında işlev uygulaması dağıtımı için kullanılan ad. Bu ad, portalda işlev uygulamasını yönetirken de görünür. Adın ortamda benzersiz olması gerekir.
--registry Ayarlandığında, bir Docker derlemesi çalıştırılır ve görüntü içinde --registryayarlanan kayıt defterine gönderilir. ile --registrykullanamazsınız--image-name. Docker Hub için --registry-username de kullanın.
--registry-password Görüntüyü özel bir kayıt defterinden almak için kullanılan parola veya belirteç.
--registry-username Görüntüyü özel bir kayıt defterinden almak için kullanılan kullanıcı adı.
--resource-group İşlevler ile ilgili kaynakların oluşturulacağı kaynak grubu.
--storage-account İşlev uygulaması tarafından kullanılacak depolama hesabının bağlantı dizesi.
--worker-runtime İşlev uygulamasının çalışma zamanı dilini ayarlar. Bu parametre yalnızca ve --image-nameile --image-build kullanılır; aksi takdirde dil yerel derleme sırasında belirlenir. Desteklenen değerler şunlardır: dotnet, dotnetIsolated, node, python, , powershellve custom (özel işleyiciler için).

Önemli

Depolama bağlantı dizesi ve diğer hizmet kimlik bilgileri önemli gizli dizilerdir. Kullanan func azurecontainerapps deploy ve bunları genel olarak erişilebilen herhangi bir kaynak denetiminde depolamayen betik dosyalarını güvenli bir şekilde depolayın.

func deploy

Komut func deploy kullanım dışıdır. Bunun yerine func kubernetes deploykullanın.

func bundles add

uzantı paketi yapılandırmasını host.json dosyasına ekler.

func bundles add

Komut func bundles add şu seçenekleri destekler:

Seçenek Açıklama
--force, -f Varsa mevcut uzantı paketi yapılandırmasının üzerine yazar.
--channel, -c Uzantı paketi yayın kanalı. Desteklenen değerler şunlardır: GA (varsayılan), Previewve Experimental.

func bundles download

host.json'de yapılandırılan uzantı paketini indirir.

func bundles download

Komut func bundles download şu seçenekleri destekler:

Seçenek Açıklama
--force, -f Uzantı paketi zaten mevcut olsa bile yeniden indirmeye zorlar.

func bundles list

İndirilen uzantı paketlerini listeler.

func bundles list

func bundles path

İndirilen uzantı paketinin yolunu alır.

func bundles path

func durable delete-task-hub

Dayanıklı İşlevler görev hub'ında tüm depolama yapıtlarını siler.

func durable delete-task-hub

Komut func durable delete-task-hub şu seçenekleri destekler:

Seçenek Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın adı.
--task-hub-name Kullanılacak Dayanıklı görev hub'ının adı.

Daha fazla bilgi için Dayanıklı İşlevler belgelerine bakın.

func durable get-history

Belirtilen düzenleme örneğinin geçmişini döndürür.

func durable get-history --id <INSTANCE_ID>

Komut func durable get-history şu seçenekleri destekler:

Seçenek Açıklama
--id Düzenleme örneğinin kimliği. (Gerekli)
--connection-string-setting Kullanılacak depolama bağlantı dizesi olan ayarın adı.
--task-hub-name Kullanılacak Dayanıklı görev hub'ının adı.

Daha fazla bilgi için Dayanıklı İşlevler belgelerine bakın.

func durable get-instances

Tüm düzenleme örneklerinin durumunu döndürür. Bu komut, parametre kullanılarak top sayfalamayı destekler.

func durable get-instances

Komut func durable get-instances şu seçenekleri destekler:

Seçenek Açıklama
--continuation-token Döndürülecek isteklerin belirli bir sayfasını veya bölümünü gösteren belirteç.
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren uygulama ayarının adı.
--created-after Bu tarih ve saatten (UTC) sonra oluşturulan örnekleri alın. Tüm ISO 8601 biçimlendirilmiş tarih saatleri kabul edilir.
--created-before Belirli bir tarih ve saatten (UTC) önce oluşturulan örnekleri alın. Tüm ISO 8601 biçimlendirilmiş tarih saatleri kabul edilir.
--runtime-status Durumu , ve runninggibi completedfailedbelirli bir durumla eşleşen örnekleri alın. Bir veya daha fazla boşlukla ayrılmış durum sağlayabilirsiniz.
--top Belirli bir istekte döndürülen kayıt sayısını sınırlayın.
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının adı.

Daha fazla bilgi için bkz. Dayanıklı İşlevler belgeleri.

func durable get-runtime-status

Belirtilen düzenleme örneğinin durumunu döndürür.

func durable get-runtime-status --id <INSTANCE_ID>

Komut func durable get-runtime-status şu seçenekleri destekler:

Seçenek Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın adı.
--id Düzenleme örneğinin kimliği. (Gerekli)
--show-input Ayarlandığında, yanıt işlevin girişini içerir.
--show-output Ayarlandığında, yanıt yürütme geçmişini içerir.
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının adı.

Daha fazla bilgi için bkz. Dayanıklı İşlevler belgeleri.

func durable purge-history

Belirtilen eşikten daha eski düzenlemelerde düzenleme örneği durumunu, geçmişini ve blob depolamasını temizler.

func durable purge-history

Komut func durable purge-history şu seçenekleri destekler:

Seçenek Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın adı.
--created-after Bu tarih/saat (UTC) tarihinden sonra oluşturulan örneklerin geçmişini silin. Tüm ISO 8601 biçimlendirilmiş tarih saat değerleri kabul edilir.
--created-before Bu tarih/saat (UTC) tarihinden önce oluşturulan örneklerin geçmişini silin. Tüm ISO 8601 biçimlendirilmiş tarih saat değerleri kabul edilir.
--runtime-status Durumu , , completedterminatedve canceledgibi failedbelirli bir durumla eşleşen örneklerin geçmişini silin. Bir veya daha fazla boşlukla ayrılmış durum sağlayın. eklemezseniz --runtime-status, durum ne olursa olsun örnek geçmişi silinir.
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının adı.

Daha fazla bilgi için Dayanıklı İşlevler belgelerine bakın.

func durable raise-event

Belirtilen düzenleme örneğine bir olay oluşturur.

func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>

Komut func durable raise-event şu seçenekleri destekler:

Seçenek Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın adı.
--event-data Olaya satır içi veya JSON dosyasından geçirecek veriler. Dosyalar için, dosya yolunun önüne at işareti (@ gibi @path/to/file.json) ekleyin. (Gerekli)
--event-name Yükseltilmesi gereken olayın adı. (Gerekli)
--id Düzenleme örneğinin kimliği. (Gerekli)
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının adı.

Daha fazla bilgi için bkz. Dayanıklı İşlevler belgeleri.

func durable rewind

Belirtilen düzenleme örneğini geri sarmalar.

func durable rewind --id <INSTANCE_ID> --reason <REASON>

Komut func durable rewind şu seçenekleri destekler:

Seçenek Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın adı.
--id Düzenleme örneğinin kimliği. (Gerekli)
--reason Düzenlemeyi geri sarma nedeni. (Gerekli)
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının adı.

Daha fazla bilgi için bkz. Dayanıklı İşlevler belgeleri.

func durable start-new

Belirtilen orchestrator işlevinin yeni bir örneğini başlatır.

func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>

Komut func durable start-new şu seçenekleri destekler:

Seçenek Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın adı.
--function-name Başlatacak orchestrator işlevinin adı. (Gerekli)
--id Düzenleme örneğinin kimliğini belirtir. (Gerekli)
--input Orchestrator işlevine satır içi veya JSON dosyasından giriş. Dosyalar için, yoluna bir ve işareti ()@ ekleyin; örneğin @path/to/file.json. (Gerekli)
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının adı.

Daha fazla bilgi için bkz. Dayanıklı İşlevler belgeleri.

func durable terminate

Belirtilen düzenleme örneğini sonlandırır.

func durable terminate --id <INSTANCE_ID> --reason <REASON>

Komut func durable terminate şu seçenekleri destekler:

Seçenek Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın adı.
--id Düzenleme örneğinin kimliğini belirtir. (Gerekli)
--reason Düzenlemeyi sonlandırma nedeni. (Gerekli)
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının adı.

Daha fazla bilgi için Dayanıklı İşlevler belgelerine bakın.

func extensions install

İşlev uzantılarını .NET olmayan bir projeye veya C# betik projesine el ile yükler.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>

Komut func extensions install şu seçenekleri destekler:

Seçenek Açıklama
--configPath, -c extensions.csproj dosyasını içeren dizinin yolu.
--csx C# betik oluşturma (.csx) projelerini destekleyin.
--force, -f Mevcut uzantıların sürümlerini güncelleştirin.
--output, -o Uzantılar için çıkış yolu.
--package, -p Belirli bir uzantı paketinin tanımlayıcısı. Belirtilmediğinde, başvuruda bulunan tüm uzantılar gibi func extensions syncyüklenir.
--source, -s NuGet.org kullanmadığında NuGet akış kaynağı.
--version, -v Uzantı paketi sürümü.

Aşağıdaki örnek, yerel projeye Event Hubs uzantısının 5.0.1 sürümünü yükler:

func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1

Kullanırken dikkat edilmesi gerekenler şunlardır func extensions install:

  • Derlenmiş C# projeleri (hem işlem içi hem de yalıtılmış çalışan işlemi) için bunun yerine gibi dotnet add packagestandart NuGet paketi yükleme yöntemlerini kullanın.

  • Çekirdek Araçları'nı kullanarak uzantıları el ile yüklemek için .NET SDK yüklü olmalıdır.

  • Mümkün olduğunda uzantı paketlerini kullanmanız gerekir. Uzantıları el ile yüklemenizin bazı nedenleri şunlardır:

    • Bir pakette bulunmayan bir uzantının belirli bir sürümüne erişmeniz gerekir.
    • Pakette bulunmayan özel bir uzantıya erişmeniz gerekir.
    • Tek bir pakette bulunmayan belirli bir uzantı bileşimine erişmeniz gerekir.

  • Uzantıları el ile yükleyebilmeniz için önce paketi tanımlayan extensionBundle dosyasından nesneyi kaldırmanız gerekir. host.json dosyanızda bir uzantı paketi zaten ayarlanmışsa hiçbir işlem yapılmaz.

  • Bir uzantıyı ilk kez açıkça yüklediğinizde, uygulama projenizin köküne extensions.csproj adlı bir .NET proje dosyası eklenir. Bu dosya, işlevlerinizin gerektirdiği NuGet paketleri kümesini tanımlar. Bu dosyadaki NuGet paket başvuruları ile çalışabilirsiniz ancak Çekirdek Araçlar bu C# proje dosyasını el ile düzenlemek zorunda kalmadan uzantıları yüklemenize olanak tanır.

func extensions sync

Fonksiyon uygulamanızın ihtiyaç duyduğu tüm uzantıları yükler.

Komut func extensions sync şu seçenekleri destekler:

Seçenek Açıklama
--configPath, -c Dosyayı içeren extensions.csproj dizinin yolu.
--csx C# betik oluşturma (.csx) projelerini destekler.
--output, -o Uzantılar için çıkış yolu.

Eksik extensions.csproj bir dosyayı yeniden oluşturur. Dosyanızda host.json bir uzantı paketi tanımlandığında hiçbir işlem yapmaz.

func kubernetes deploy

bir İşlevler projesini kubernetes kümesine özel docker kapsayıcısı olarak dağıtır.

func kubernetes deploy

Bu komut projenizi özel bir kapsayıcı olarak oluşturur ve bir Kubernetes kümesinde yayımlar. Özel kapsayıcılarda Dockerfile olmalıdır. Dockerfile ile uygulama oluşturmak için komutunu kullanarak --docker seçeneğini kullanınfunc init.

Komut func kubernetes deploy şu seçenekleri destekler:

Seçenek Açıklama
--dry-run Dağıtım şablonunu yürütme olmadan görüntüler.
--config-map-name Dağıtımda kullanılacak işlev uygulaması ayarlarıyla mevcut yapılandırma eşlemesinin adı. gerektirir --use-config-map. Varsayılan davranış, Values dosyasındaki nesneyi temel alan ayarlar oluşturmaktır.
--cooldown-period Dağıtım sıfıra geri ölçeklendirilmeden önce tüm tetikleyicilerden sonraki bekleme süresi (saniye cinsinden) artık etkin değildir ve varsayılan değer 300 s'tir.
--ignore-errors Bir kaynak hata döndürdüğünde dağıtıma devam edin. Varsayılan davranış, hatanın durdurulmasıdır.
--image-name Pod dağıtımı için kullanılacak ve işlevlerin okunduğu görüntünün adı.
--keda-version Yüklenecek KEDA sürümünü ayarlayın. Geçerli seçenekler şunlardır: v1 ve v2 (varsayılan).
--keys-secret-name Erişim anahtarlarını depolamak için kullanılacak Kubernetes Gizli Dizileri koleksiyonunun adı.
--max-replicas Yatay Pod Otomatik Ölçeklendiricisi'nin (HPA) ölçeklendirildiği maksimum çoğaltma sayısını ayarlayın.
--min-replicas HPA'nın ölçeklenmeyeceği en düşük çoğaltma sayısını ayarlayın.
--mount-funckeys-as-containervolume Erişim anahtarlarını kapsayıcı birimi olarak bağlayın.
--name Kubernetes'teki dağıtım ve diğer yapıtlar için kullanılan ad.
--namespace Dağıtılacak Kubernetes ad alanını ayarlayın. Varsayılan ad alanıdır.
--no-docker İşlevleri bir görüntü yerine geçerli dizinden okuyun. Görüntü dosya sisteminin takılmasını gerektirir.
--registry Ayarlandığında, bir Docker derlemesi çalıştırılır ve görüntü bu adın kayıt defterine gönderilir. ile --registrykullanamazsınız--image-name. Docker için kullanıcı adınızı kullanın.
--polling-interval HTTP olmayan tetikleyicileri denetlemek için varsayılan olarak 30'lar olan yoklama aralığı (saniye cinsinden).
--pull-secret Özel kayıt defteri kimlik bilgilerine erişmek için kullanılan gizli dizi.
--secret-name Dağıtımda kullanılacak işlev uygulaması ayarlarına sahip mevcut kubernetes gizli dizileri koleksiyonunun adı. Varsayılan davranış, Values dosyasındaki nesneyi temel alan ayarlar oluşturmaktır.
--show-service-fqdn BIR IP adresi kullanmanın varsayılan davranışı yerine Kubernetes FQDN ile HTTP tetikleyicilerinin URL'lerini görüntüleyin.
--service-type Kubernetes Service türünü ayarlayın. Desteklenen değerler şunlardır: ClusterIP, NodePortve LoadBalancer (varsayılan).
--use-config-map ConfigMap İşlev uygulaması ayarlarınıSecretiçin nesne (v1) yerine bir nesne (v1) kullanın. Harita adı kullanılarak --config-map-nameayarlanır.
--use-git-hash-version Git karması'nı kapsayıcı görüntüsü için sürüm olarak kullanın.
--write-configs Kubernetes yapılandırmalarını dağıtmak yerine YAML dosyaları olarak çıktısını oluşturun.
--config-file kullanırken --write-configsçıkış dosyası yolu. Varsayılan: functions.yaml.
--hash-files Görüntü sürümünü belirlemek için karma olarak kullanılacak dosyalar.
--image-build olarak ayarlandığında falseDocker derlemesini atlar.
--key-secret-annotations Anahtar gizli dizisine biçim olarak key1=val1,key2=val2 eklenecek ek açıklamalar.

Çekirdek Araçlar, görüntüyü derlemek ve yayımlamak için yerel Docker CLI'yi kullanır. Docker'ın yerel olarak zaten yüklü olduğundan emin olun. Hesabınıza docker login bağlanmak için komutunu çalıştırın.

Azure İşlevleri, kapsayıcılı işlevlerinizi Azure Container Apps veya Azure İşlevleri içinde barındırmayı destekler. Azure İşlevleri, kapsayıcılarınızın doğrudan kubernetes kümesinde veya Azure Kubernetes Service (AKS) çalıştırılmasını resmi olarak desteklemez. Daha fazla bilgi için bkz. Azure İşlevleri Linux kapsayıcı desteği.

func kubernetes delete

Kubernetes kümesinden İşlevler dağıtımlarını siler.

func kubernetes delete --name <APP_NAME>

Komut func kubernetes delete şu seçenekleri destekler:

Seçenek Açıklama
--name Kubernetes'teki dağıtımın ve diğer yapıtların adı. (Gerekli)
--namespace Kubernetes ad alanını ayarlayın. Varsayılan olarak ad alanını default kullanır.
--registry Kapsayıcı kayıt defterinin adı.
--image-name Pod dağıtımı için kullanılacak görüntü.
--keda-version KEDA sürümünü ayarlayın. Geçerli seçenekler şunlardır v1 : ve v2 (varsayılan).

func kubernetes install

Kubernetes kümesine KEDA yükler

func kubernetes install

KEDA'yi kubectl config dosyasında tanımlanan kümeye yükler.

Komut func kubernetes install şu seçenekleri destekler:

Seçenek Açıklama
--dry-run Dağıtım şablonunu yürütme olmadan görüntüler.
--keda-version Yüklenecek KEDA sürümünü ayarlar. Geçerli seçenekler şunlardır: v1 ve v2 (varsayılan).
--namespace Belirli bir Kubernetes ad alanına yükler. Ayarlanmadığında, varsayılan ad alanı kullanılır.

Daha fazla bilgi için bkz. Kubernetes'te KEDA ve işlevleri yönetme.

func kubernetes remove

KeDA'yi yapılandırma dosyasında tanımlanan Kubernetes kümesinden kubectl kaldırır.

func kubernetes remove

KeDA'yi yapılandırma dosyasında tanımlanan kubectl kümeden kaldırır.

Komutu func kubernetes remove şu seçeneği destekler:

Seçenek Açıklama
--namespace Belirli bir Kubernetes ad alanından kaldırır. Ayarlanmadığında, varsayılan ad alanı kullanılır.

Daha fazla bilgi için bkz. Kubernetes'ten KEDA'yı kaldırma.

func settings add

local.settings.json dosyasındaki Valueskoleksiyona yeni bir ayar ekler.

func settings add <SETTING_NAME> <VALUE>

değerini uygulama ayarının adıyla değiştirin <SETTING_NAME> .

Komutu func settings add şu seçeneği destekler:

Seçenek Açıklama
--connectionString Ad-değer çiftini ConnectionStrings koleksiyon yerine koleksiyona Values ekler. ConnectionStrings Koleksiyonu yalnızca belirli çerçeveler gerektirdiğinde kullanın. Daha fazla bilgi için bkz. local.settings.json dosyası.

func settings decrypt

Values dosyasındaki koleksiyondaki şifrelenmiş değerlerin şifresini çözer.

func settings decrypt

Bu komut ayrıca ConnectionStrings koleksiyonundaki bağlantı dizesi değerlerin şifresini çözer. local.settings.json, komut olarak ayarlanırIsEncrypted.false Hassas bilgilerin açığa çıkması riskini azaltmak için yerel ayarları şifreleyinlocal.settings.json. Azure uygulama ayarları her zaman şifrelenmiş olarak depolanır.

func settings delete

local.settings.json dosyasındaki Valueskoleksiyondan var olan bir ayarı kaldırır.

func settings delete <SETTING_NAME>

değerini uygulama ayarının adıyla ve <SETTING_NAME> ayarın değeriyle değiştirin<VALUE>.

Komutu func settings delete şu seçeneği destekler:

Seçenek Açıklama
--connectionString Ad-değer çiftini ConnectionStrings koleksiyon yerine Values koleksiyondan kaldırır.

func settings encrypt

local.settings.json dosyasındaki koleksiyondaki Valuestek tek öğelerin değerlerini şifreler.

func settings encrypt

komutu, koleksiyondaki ConnectionStrings bağlantı dizesi değerlerini de şifreler. local.settings.json, komut , IsEncryptedolarak ayarlanır true ve bu da yerel çalışma zamanının ayarları kullanmadan önce şifre açtığını belirtir. Hassas bilgilerin açığa çıkması riskini azaltmak için yerel ayarları şifreleyinlocal.settings.json. Azure'da uygulama ayarları her zaman şifrelenmiş olarak depolanır.

func settings list

local.settings.json dosyasındaki Valueskoleksiyondaki ayarların listesini oluşturur.

func settings list

Çıkış, koleksiyondaki ConnectionStrings bağlantı dizelerini de içerir. Varsayılan olarak, komut güvenlik için değerleri maskeler. --showValue Gerçek değeri görüntülemek için seçeneğini kullanın.

Komutu func settings list şu seçeneği destekler:

Seçenek Açıklama
--showValue, -a Çıktıda gerçek maskelenmemiş değerleri gösterin.

func templates list

Kullanılabilir işlev (tetikleyici) şablonlarını listeler.

Komutu func templates list şu seçeneği destekler:

Seçenek Açıklama
--language, -l Döndürülen şablonların filtreleneceği dil. Varsayılan olarak tüm dilleri döndürür.

Genel seçenekler

Çoğu Core Tools komutu şu seçenekleri destekler:

Seçenek Açıklama
--script-root İşlev uygulamasının kök dizinini ayarlar ve komutun çalışma dizinini değiştirir.
--verbose Ayrıntılı günlük kaydı için ayrıntılı çıkışı etkinleştirir. Tüm komutlar bu seçeneği desteklemez.
--offline Dış ağ çağrıları yapmadan çevrimdışı modda çalışır. func start, func init, ve func new komutları bu seçeneği destekler. Ayrıca ortam değişkeni üzerinden FUNCTIONS_CORE_TOOLS_OFFLINE de ayarlayabilirsiniz.
--version, -v Azure İşlevleri Core Tools sürümünü görüntüler.
--help, -h Yardım bilgilerini görüntüler.
--pause-on-error İşlemden çıkmadan önce ek giriş için duraklatılır. Bu seçenek, entegre geliştirme ortamından (IDE) Core Tools başlattığınızda faydalıdır.

Çoğu komut bu seçenekleri destekler:

Seçenek Açıklama
--help, -h Komut için yardım gösterin.
--version Azure İşlevleri CLI sürümünü göster. Detaylı yapı bilgisi için birlikte --verbose kullanın--version.
--verbose Ayrıntılı çıkışı etkinleştirin. Tüm alt komutlara yayılır. Alt komut olmadan kökten geçildiğinde, ayrıntılı yapı, çalışma zamanı, işletim sistemi ve mimari bilgilerini yazdırır.

Mevcut iş yükleri

Mevcut kataloğa bakmak için koş func workload search . Şu anda aşağıdaki iş yükleri mevcuttur:

İsim Açıklama
host func run tarafından kullanılan Azure İşlevleri host çalışma zamanı.
bundles Tüm bağlama uzantılarını etkinleştiren uzantı paketlerini kurun. Bu iş yükünü .NET dışı herhangi bir yığın için kullanın. .NET projeleri bu iş yükünü kullanmaz. Bunun yerine, projelerinde doğrudan uzantılara referans veriyorlar.
dotnet Azure İşlevleri CLI tooling for .NET (C#, F#) projeleri. Ayrıca için func quickstartşablonlar da katkı sağlıyor. .NET ayrı bir işçi iş yükü gerektirmez, çünkü çalışan derlenmiş projenin kendisinin bir parçasıdır.
dotnet-templates .NET izole çalışan projeleri için fonksiyon-iskelet şablonları.
python Azure İşlevleri CLI tooling for Python projects. Ayrıca için func quickstartşablonlar da katkı sağlıyor.
python-worker Functions ana bilgisayarı tarafından kullanılan Python dil çalışanı.
python-templates Python için fonksiyon-iskelet şablonları (v1 ve v2 programlama modelleri).
node Azure İşlevleri Node.js projeleri için CLI araçları (JavaScript, TypeScript). Ayrıca için func quickstartşablonlar da katkı sağlıyor.
node-worker Functions sunucusu tarafından kullanılan Node.js dil çalışanı.
node-templates Function-scaffold şablonları for Node.js (JavaScript, TypeScript).
go Azure İşlevleri CLI tooling for Go projects. Ayrıca için func quickstartşablonlar da katkı sağlıyor.
go-worker Functions sunucusu tarafından kullanılan Go dil çalışanı.

Not

Tüm Fonksiyon dil yığınları şu anda iş yükü olarak mevcut değildir. Java ve PowerShell yığınları şu anda Azure İşlevleri CLI'da desteklenmiyor.

  • Last updated on