Azure Functions Temel Araçlar başvurusu

Bu makalede, yerel bilgisayarınızdan Azure Functions projeleri geliştirmenize, yönetmenize ve dağıtmanıza olanak tanıyan Azure Functions Temel Araçları için başvuru belgeleri sağlanır. Temel Araçları kullanma hakkında daha fazla bilgi edinmek için bkz. Azure Functions 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 Durable Functions ile çalışacak komutlar.
func extensions Uzantıları yüklemek ve yönetmek için komutlar.
func kubernetes Kubernetes ve Azure Functions 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.

func init

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

func init [<PROJECT_FOLDER>]

sağladığınızda <PROJECT_FOLDER>, proje bu ada sahip yeni bir klasörde oluşturulur. Aksi takdirde geçerli klasör kullanılır.

Komut func init , aksi belirtilmedikçe sürüm 1.x'te desteklenmeyen ş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 sürüm 1.x davranışı olan C# betiği olarak .NET işlevleri oluşturur. Yalnızca --worker-runtime dotnet ile geçerlidir.
--docker Seçilen --worker-runtimeöğesini temel alan bir temel görüntü kullanarak kapsayıcı için bir 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ın. 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.

seçeneğini kullandığınızda --configuration-profile , önceden tanımlanmış bir proje yapılandırmaları ve ayarları kümesi oluşturulur. 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 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 Functions.

func new

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

func new

seçeneği olmadan çalıştırdığınızda func new--template , bir şablon seçmeniz istenir. Sürüm 1.x'te dili de seçmeniz gerekir.

Komut func new ş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 2.x ve sonraki sürümler.) 1.x sürümünde ve portalda kullanılan aynı C# betiği (.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.
--language, -l C# veya JavaScript gibi şablon programlama dili. Bu seçenek 1.x sürümünde gereklidir. Sürüm 2.x ve sonraki sürümlerde, dil çalışan çalışma zamanı tarafından tanımlandığından bu seçeneği kullanmayın.
--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 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.

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.
--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

Yalnızca sürüm 1.x.

Azure portalındaki Test sekmesini kullanarak işlevi çalıştırmaya benzer bir işlevi doğrudan çağırmanızı sağlar. Bu eylem yalnızca 1.x sürümünde desteklenir. Sonraki sürümler için işlev uç noktasını doğrudan kullanın func start ve çağırın.

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 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.

Ayarlar projenin local.settings.json dosyasına indirilir. Ekran değerleri güvenlik için maskelenir. Yerel şifrelemeyi etkinleştirerek local.settings.json dosyasındaki ayarları 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 Application Insights Canlı Akışı'nı açın.

Daha fazla bilgi için bkz. Azure Functions'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 Storage hesabı için connection string alır.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Daha fazla bilgi için bkz. >connection string depolamayı indirme.

func azurecontainerapps deploy

Kapsayıcılı işlev uygulamasını Azure Container Apps bir ortama dağıtır. İşlev uygulaması ve ortam tarafından kullanılan depolama hesabı zaten mevcut olmalıdır. Daha fazla bilgi için bkz. Azure Container Apps barındırma Azure Functions.

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 connection string.
--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 kullanın func kubernetes deploy.

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

Durable Functions 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 connection string içeren ayarın adı.
--task-hub-name Kullanılacak Dayanıklı görev hub'ının adı.

Daha fazla bilgi için Durable Functions 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 connection string olan ayarın adı.
--task-hub-name Kullanılacak Dayanıklı görev hub'ının adı.

Daha fazla bilgi için Durable Functions belgelerine bakın.

func durable get-instances

Tüm düzenleme örneklerinin durumunu döndürür. Bu komut parametresiyle disk belleğini top 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 connection string 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 Durable Functions görev hub'ının adı.

Daha fazla bilgi için bkz. Durable Functions 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 connection string 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 Durable Functions görev hub'ının adı.

Daha fazla bilgi için bkz. Durable Functions 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 connection string 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 Durable Functions görev hub'ının adı.

Daha fazla bilgi için Durable Functions 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 connection string 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 Durable Functions görev hub'ının adı.

Daha fazla bilgi için bkz. Durable Functions 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 connection string 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 Durable Functions görev hub'ının adı.

Daha fazla bilgi için bkz. Durable Functions 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 connection string 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 Durable Functions görev hub'ının adı.

Daha fazla bilgi için bkz. Durable Functions 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 connection string 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 Durable Functions görev hub'ının adı.

Daha fazla bilgi için Durable Functions 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

İşlev uygulamasına eklenen tüm uzantıları yükler.

Komut func extensions sync ş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 destekler.
--output, -o Uzantılar için çıkış yolu.

Eksik bir extensions.csproj dosyasını yeniden oluşturur. host.json dosyanızda bir uzantı paketi tanımlandığında hiçbir işlem gerçekleştirmez.

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 --dockerfile 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 Functions, kapsayıcılı işlevlerinizi Azure Container Apps veya Azure Functions içinde barındırmayı destekler. Azure Functions, 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 Functions 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 connection string değerlerin şifresini çözer. local.settings.json'da da IsEncrypted olarak falseayarlanır. Local.settings.json değerli bilgilerin sızma riskini azaltmak için yerel ayarları şifreleyin. 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

Koleksiyondaki ConnectionStrings bağlantı dizesi değerleri de şifrelenir. local.settings.json'de, IsEncrypted yerel çalışma zamanının ayarları kullanmadan önce şifresini çözdüğünü belirten olarak da ayarlanır true. Local.settings.json değerli bilgilerin sızma riskini azaltmak için yerel ayarları şifreleyin. 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, değerler güvenlik için maskelenir. Gerçek değeri görüntülemek için seçeneğini kullanabilirsiniz --showValue .

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

Bu seçenekler çoğu Temel Araçlar komutu için kullanılabilir:

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 tarafından desteklenmez.
--offline Dış ağ çağrıları yapmadan çevrimdışı modda çalışır. , , func startve func inittarafından func newdesteklenir. Ortam değişkeni aracılığıyla FUNCTIONS_CORE_TOOLS_OFFLINE da ayarlanabilir.
--version, -v Azure Functions 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. Tümleşik bir geliştirme ortamından (IDE) Core Tools'ı başlattığınızda kullanışlıdır.
  • Last updated on