Azure İşlevleri Temel Araçlar başvurusu

Bu makalede, yerel bilgisayarınızdan Azure İşlevleri projeleri geliştirmenize, yönetmenize ve dağıtmanıza olanak tanıyan Azure İşlevleri 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 İşlevleri Core Tools ile çalışma.

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

Komut bağlamı Tanım
func Yerel bilgisayarınızda işlev oluşturmak ve çalıştırmak için kullanılan komutlar.
func azure Yayımlama da dahil olmak üzere Azure kaynaklarıyla çalışmaya yönelik komutlar.
func azurecontainerapps Kapsayıcılı işlev uygulamasını Azure Container Apps'e dağıtın.
func durable Dayanıklı İşlevler ile çalışmaya yönelik komutlar.
func extensions Uzantıları yükleme ve yönetme 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ı listelemeye yönelik komutlar.

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

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.

func init aksi belirtilmedikçe 1.x sürümünü desteklemeyen aşağıdaki seçenekleri destekler:

Seçenek Tanım
--csx Sürüm 1.x davranışı olan C# betiği olarak .NET işlevleri oluşturur. Yalnızca ile --worker-runtime dotnetgeçerlidir.
--docker Seçilen --worker-runtimeöğesini temel alan bir temel görüntü kullanarak kapsayıcı 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.json dosyasında belirtilmezse 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 Dile özgü bir projeyi başlatır. şu anda olarak ayarlandığında nodedesteklenir--worker-runtime. Seçenekler ve javascriptşeklindedirtypescript. veya --worker-runtime typescriptde kullanabilirsiniz--worker-runtime javascript.
--managed-dependencies Yönetilen bağımlılıkları yükler. Şu anda bu işlevi yalnızca PowerShell çalışan çalışma zamanı desteklemektedir.
--model Birden fazla model kullanılabilir olduğunda hedef dil için istenen programlama modelini ayarlar. Desteklenen seçenekler Python V1 ve V2V3 Node.js için ve V4 seçenekleridir. Daha fazla bilgi için sırasıyla Python geliştirici kılavuzunave Node.js geliştirici kılavuzuna bakın.
--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 ile --worker-runtime dotnet-isolatedgeçerlidir. Desteklenen değerler şunlardır: net6.0 (varsayılan), net7.0, net8.0ve net48 (.NET Framework 4.8).

Dekont

Veya --dockerfile seçeneklerinden birini --docker kullandığınızda, Çekirdek Araçlar C#, JavaScript, Python ve PowerShell işlevleri için Dockerfile'ı otomatik olarak 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.

func günlükleri

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

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

Eylem func logs aşağıdaki seçenekleri destekler:

Seçenek Tanım
--platform İşlev uygulaması için barındırma platformu. Desteklenen seçenekler: kubernetes.
--name Azure'da işlev uygulaması adı.

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

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.

Eylem func new aşağıdaki seçenekleri destekler:

Seçenek Tanım
--authlevel HTTP tetikleyicisi için yetkilendirme düzeyini ayarlamanıza olanak tanır. Desteklenen değerler şunlardır: function, anonymous, admin. Yerel olarak çalıştırılırken yetkilendirme uygulanmaz. Daha fazla bilgi için HTTP bağlama makalesine bakın.
--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.
--language, -l C#, F# 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 kullanmazsınız.
--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 edinmek için bkz . İşlev oluşturma.

func run

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

Bir işlevi doğrudan çağırmanızı sağlar. Bu, Azure portalındaki Test sekmesini kullanarak bir işlevi çalıştırmaya benzer. 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

Eylem func run aşağıdaki seçenekleri destekler:

Seçenek Tanım
--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 aşağıdaki 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

func start aşağıdaki seçenekleri destekler:

Seçenek Tanım
--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 kullanarak çıkış noktaları arası kimliği doğrulanmış isteklere izin verin.
--dotnet-isolated-debug olarak trueayarlandığında, hata ayıklanan .NET yalıtılmış projesinden 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 gereksinimleriyle birlikte tam kimlik doğrulama işleme işlem hattını etkinleştirin.
--functions Yüklenecek işlevlerin boşlukla ayrılmış listesi.
--language-worker Dil çalışanını yapılandırmak için bağımsız değişkenler. Örneğin, hata ayıklama 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 değer: false.
--password Parola veya .pfx dosyasının parolasını içeren bir dosya. Yalnızca ile --certkullanılır.
--port Dinlenecek yerel bağlantı noktası. Varsayılan değer: 7071.
--timeout İş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.

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

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şlevlerin listesini döndürür.

func azure functionapp list-functions <APP_NAME>

func azure functionapp logstream

azure'da işlev uygulaması için akış günlüklerine yerel komut istemini Bağlan.

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ştirebilirsiniz. Tüketim planında Linux uygulamaları için henüz desteklenmiyor. Bu uygulamalar için portalda --browser günlükleri görüntüleme seçeneğini kullanın.

Eylem deploy aşağıdaki seçenekleri destekler:

Seçenek Tanım
--browser İşlev uygulaması için Azure Uygulaması Analizler Live Stream'i varsayılan tarayıcıda açın.

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

func azure functionapp publish

İş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 Tanım
--access-token Kimliği doğrulanmış Azure eylemleri gerçekleştirirken belirli bir erişim belirtecini kullanmanıza olanak tanır.
--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 bunu kullanın.
--additional-packages Yerel bağımlılıklar oluştururken yüklenecek paketlerin listesi. Örneğin: python3-dev libevent-dev.
--build, -b Bir Linux işlev uygulamasına dağıtırken derleme eylemi gerçekleştirir. Kabul eder: remote ve local.
--build-native-deps Python işlev uygulamalarını yayımlarken klasörü oluşturma .wheels işlemini atlar.
--csx C# betiği (.csx) projesi yayımlama.
--dotnet-cli-params Derlenmiş C# (.csproj) işlevleri yayımlandığında, çekirdek araçlar öğesini çağırır dotnet build --output bin/publish. Buna geçirilen tüm parametreler komut satırına eklenir.
--force Bazı senaryolarda hazırlık doğrulamasını yoksayın.
--list-ignored-files Yayımlama sırasında yoksayılan dosyaların listesini görüntüler. Bu liste, dosyayı temel alır .funcignore .
--list-included-files Yayımlanan ve dosyayı temel alan .funcignore dosyaların listesini görüntüler.
--management-url Bulutunuzun yönetim URL'sini ayarlar. Bağımsız bir bulutta çalışırken bunu kullanın.
--no-build Project yayımlama sırasında oluşturulmaz. Python pip install için gerçekleştirilmez.
--nozip Varsayılan Run-From-Package modu kapatır.
--overwrite-settings -y Kullanıldığında uygulama ayarlarının --publish-local-settings -i üzerine yazma istemini gizleme.
--publish-local-settings -i local.settings.json dosyasındaki ayarları Azure'da yayımlayarak ayarın zaten mevcut olup olmadığının üzerine yazılmasını istemde bulunun. 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ımlayın ve içeriği atlayın. Varsayılan istemdir.
--slot Yayımlanması gereken belirli bir yuvanın isteğe bağlı adı.
--subscription Kullanılacak varsayılan aboneliği ayarlar.

func azure storage fetch-connection-string

Belirtilen Azure Depolama hesabının bağlantı dizesi alır.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

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

func azurecontainerapps deploy

Kapsayıcılı işlev uygulamasını Azure Container Apps ortamına dağıtır. hem işlev uygulaması hem de ortam tarafından kullanılan depolama hesabı zaten mevcut olmalıdır. Daha fazla bilgi için bkz. Azure İşlevleri barındıran Azure Container Apps.

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 Tanım
--access-token Kimliği doğrulanmış Azure eylemleri gerçekleştirirken belirli bir erişim belirtecini kullanmanıza olanak tanır.
--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 bunu kullanın.
--environment Mevcut Container Apps ortamının adı.
--image-build olarak trueayarlandığında, yerel Docker derlemesini atlar.
--image-name Kapsayıcı kayıt defterindeki mevcut bir kapsayıcının görüntü adı. Resim adı etiket adını içerir.
--location Dağıtımın bölgesi. İdeal olarak, burası ortam ve depolama hesabı kaynaklarıyla aynı bölgedir.
--management-url Bulutunuzun yönetim URL'sini ayarlar. Bağımsız bulutta çalışırken bunu kullanın.
--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 kullanılı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 --image-namekullanamazsınız--registry. Docker Hub için de kullanın --registry-username.
--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.
--subscription Kullanılacak varsayılan aboneliği ayarlar.
--worker-runtime İşlev uygulamasının çalışma zamanı dilini ayarlar. Bu parametre yalnızca ve --image-buildile --image-name kullanılır, aksi takdirde dil yerel derleme sırasında belirlenir. Desteklenen değerler şunlardır: dotnet, dotnetIsolated, node, python, , powershellve custom (müşteri işleyicileri için).

Önemli

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

func dağıtımı

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

func dayanıklı delete-task-hub

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

func durable delete-task-hub

Eylem delete-task-hub aşağıdaki seçenekleri destekler:

Seçenek Tanım
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın isteğe bağlı adı.
--task-hub-name Kullanılacak Dayanıklı Görev Hub'ının isteğe bağlı adı.

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

func dayanıklı get-history

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

func durable get-history --id <INSTANCE_ID>

Eylem get-history aşağıdaki seçenekleri destekler:

Seçenek Tanım
--id Düzenleme örneğinin kimliğini belirtir (gerekli).
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın isteğe bağlı adı.
--task-hub-name Kullanılacak Dayanıklı Görev Hub'ının isteğe bağlı adı.

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

func dayanıklı get-instances

Tüm düzenleme örneklerinin durumunu döndürür. parametresini kullanarak disk belleğini top destekler.

func durable get-instances

Eylem get-instances aşağıdaki seçenekleri destekler:

Seçenek Tanım
--continuation-token döndürülecek isteklerin belirli bir sayfasını/bölümünü gösteren isteğe bağlı belirteç.
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren uygulama ayarının isteğe bağlı adı.
--created-after İsteğe bağlı olarak, bu tarih/saat (UTC) tarihinden sonra oluşturulan örnekleri alın. Tüm ISO 8601 biçimlendirilmiş tarih saatleri kabul edilir.
--created-before İsteğe bağlı olarak, belirli bir tarih/saat (UTC) öncesinde oluşturulan örnekleri alın. Tüm ISO 8601 biçimlendirilmiş tarih saatleri kabul edilir.
--runtime-status İsteğe bağlı olarak, durumu , completedve failedgibi runningbelirli bir durumla eşleşen örnekleri alın. Bir veya daha fazla boşlukla ayrılmış heykel sağlayabilirsiniz.
--top İsteğe bağlı olarak, 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 isteğe bağlı adı.

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

func dayanıklı get-runtime-status

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

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

Eylem get-runtime-status aşağıdaki seçenekleri destekler:

Seçenek Tanım
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın isteğe bağlı adı.
--id Düzenleme örneğinin kimliğini belirtir (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 isteğe bağlı adı.

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

func dayanıklı temizleme geçmişi

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

func durable purge-history

Eylem purge-history aşağıdaki seçenekleri destekler:

Seçenek Tanım
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın isteğe bağlı adı.
--created-after İsteğe bağlı olarak, 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 İsteğe bağlı olarak, bu tarih/saat (UTC) öncesinde oluşturulan örneklerin geçmişini silin. Tüm ISO 8601 biçimlendirilmiş tarih saat değerleri kabul edilir.
--runtime-status İsteğe bağlı olarak, durumu , terminated, canceledve failedgibi completdbelirli bir durumla eşleşen örneklerin geçmişini silin. Bir veya daha fazla boşlukla ayrılmış heykel sağlayabilirsiniz. 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 isteğe bağlı adı.

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

func dayanıklı raise-event

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

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

Eylem raise-event aşağıdaki seçenekleri destekler:

Seçenek Tanım
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın isteğe bağlı adı.
--event-data Olaya satır içi veya JSON dosyasından geçirecek veriler (gerekli). Dosyalar için, yoluna bir ve işareti ()@ ekleyin; örneğin @path/to/file.json.
--event-name Yükseltilmesi gereken olayın adı (gerekli).
--id Düzenleme örneğinin kimliğini belirtir (gerekli).
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının isteğe bağlı adı.

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

func dayanıklı geri sarma

Belirtilen düzenleme örneğini geri sarmalar.

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

Eylem rewind aşağıdaki seçenekleri destekler:

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

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

func dayanıklı başlangıç-yeni

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

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

Eylem start-new aşağıdaki seçenekleri destekler:

Seçenek Tanım
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın isteğe bağlı 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ş (gerekli). Dosyalar için, yoluna bir ve işareti ()@ ekleyin; örneğin @path/to/file.json.
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının isteğe bağlı adı.

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

func dayanıklı sonlandırma

Belirtilen düzenleme örneğini durdurur.

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

Eylem terminate aşağıdaki seçenekleri destekler:

Seçenek Tanım
--connection-string-setting Kullanılacak depolama bağlantı dizesi içeren ayarın isteğe bağlı adı.
--id Düzenleme örneğinin kimliğini belirtir (gerekli).
--reason Düzenlemeyi durdurma nedeni (gerekli).
--task-hub-name Kullanılacak Dayanıklı İşlevler görev hub'ının isteğe bağlı adı.

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

func uzantıları yükleme

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

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

Eylem install aşağıdaki seçenekleri destekler:

Seçenek Tanım
--configPath extensions.csproj dosyasını içeren dizinin yolu.
--csx C# betik oluşturma (.csx) projelerini destekler.
--force Mevcut uzantıların sürümlerini güncelleştirin.
--output Uzantılar için çıkış yolu.
--package Belirli bir uzantı paketinin tanımlayıcısı. Belirtilmediğinde, başvuruda bulunan tüm uzantılar gibi func extensions syncyüklenir.
--source NuGet.org kullanmadığında NuGet akış kaynağı.
--version 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 func extensions installaşağıdaki noktalar geçerlidir:

  • 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 6.0 SDK'sının yüklü olması gerekir.

  • 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 host.json dosyasından nesneyi kaldırmanız extensionBundle 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 uzantıları eşitleme

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

Eylem sync aşağıdaki seçenekleri destekler:

Seçenek Tanım
--configPath extensions.csproj dosyasını içeren dizinin yolu.
--csx C# betik oluşturma (.csx) projelerini destekler.
--output 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 yapılmaz.

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 func init seçeneğini kullanın--dockerfile.

Aşağıdaki Kubernetes dağıtım seçenekleri kullanılabilir:

Seçenek Tanım
--dry-run İsteğe bağlı olarak 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 isteğe bağlı adı. gerektirir --use-config-map. Varsayılan davranış, local.settings.json dosyasındaki Valuesnesneye göre ayarlar oluşturmaktır.
--cooldown-period Dağıtım yeniden sıfıra ö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 eder. 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ü ayarlar. Geçerli seçenekler şunlardır: v1 ve v2 (varsayılan).
--keys-secret-name İşlev 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 en yüksek çoğaltma sayısını ayarlar.
--min-replicas HPA'nın ölçeklenmeyeceği en düşük çoğaltma sayısını ayarlar.
--mount-funckeys-as-containervolume İşlev erişim anahtarlarını kapsayıcı birimi olarak bağlar.
--name Kubernetes'teki dağıtım ve diğer yapıtlar için kullanılan ad.
--namespace Dağıtılacak Kubernetes ad alanını ayarlar ve bu ad alanı varsayılan ad alanıdır.
--no-docker İşlevler bir görüntü yerine geçerli dizinden okunur. 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 --image-namekullanamazsınız--registry. 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ını içeren mevcut Kubernetes Gizli Dizileri koleksiyonunun adı. Varsayılan davranış, local.settings.json dosyasındaki Valuesnesneye göre 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üler.
--service-type Kubernetes Service türünü ayarlar. Desteklenen değerler şunlardır: ClusterIP, NodePortve LoadBalancer (varsayılan).
--use-config-map ConfigMap İşlev uygulaması ayarlarını yapılandırmak için nesne (v1) yerine bir Secret nesne (v1) kullanın. Harita adı kullanılarak --config-map-nameayarlanır.

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

Daha fazla bilgi edinmek için bkz . Kubernetes'e işlev uygulaması dağıtma.

func kubernetes install

KeDA'yi bir Kubernetes kümesine yükler.

func kubernetes install 

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

Eylem install aşağıdaki seçenekleri destekler:

Seçenek Tanım
--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üklemeyi destekler. Ayarlanmadığında, varsayılan ad alanı kullanılır.

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

func kubernetes remove

KEDA'yi kubectl config dosyasında tanımlanan Kubernetes kümesinden kaldırır.

func kubernetes remove 

KEDA'yi kubectl config dosyasında tanımlanan kümeden kaldırır.

Eylem remove aşağıdaki seçenekleri destekler:

Seçenek Tanım
--namespace Belirli bir Kubernetes ad alanından kaldırmayı destekler. Ayarlanmadığında, varsayılan ad alanı kullanılır.

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

func ayarları ekleme

local.settings.json dosyasındaki koleksiyona Valuesyeni bir ayar ekler.

func settings add <SETTING_NAME> <VALUE>

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

Eylem add aşağıdaki seçeneği destekler:

Seçenek Tanım
--connectionString Ad-değer çiftini ConnectionStrings koleksiyon yerine koleksiyona Values ekler. Koleksiyonu yalnızca belirli çerçeveler için gerekli olduğunda kullanın ConnectionStrings . Daha fazla bilgi için bkz . local.settings.json dosyası.

func ayarlarının şifresi çözülür

Local.settings.json dosyasındaki Valueskoleksiyondaki önceden şifrelenmiş değerlerin şifresini çözer.

func settings decrypt

Koleksiyondaki Bağlan ion dizesi değerlerinin ConnectionStrings şifresi de çözülür. local.settings.json IsEncrypted dosyasında da olarak falseayarlanır. Local.settings.json dosyasından değerli bilgilerin sızma riskini azaltmak için yerel ayarları şifreleyin. Azure'da uygulama ayarları her zaman şifrelenmiş olarak depolanır.

func ayarları silme

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 <VALUE> ayarın değeriyle değiştirin<SETTING_NAME>.

Eylem delete aşağıdaki seçeneği destekler:

Seçenek Tanım
--connectionString Ad-değer çiftini koleksiyondan ConnectionStrings değil koleksiyondan Values kaldırır.

func ayarları şifreleme

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

func settings encrypt

Koleksiyondaki ConnectionStrings Bağlan ion dizesi değerleri de şifrelenir. local.settings.json IsEncrypted dosyasında, yerel çalışma zamanının ayarları kullanmadan önce şifresini çözdüğünü belirten olarak da ayarlanır true. Local.settings.json dosyasından değerli bilgilerin sızma riskini azaltmak için yerel ayarları şifreleyin. Azure'da uygulama ayarları her zaman şifrelenmiş olarak depolanır.

func ayarları listesi

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

func settings list

Koleksiyondaki ConnectionStrings Bağlan ion dizeleri de çıkıştır. 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 .

Eylem list aşağıdaki seçeneği destekler:

Seçenek Tanım
--showValue Çıktıdaki gerçek maskelenmemiş değerleri gösterir.

func şablonları listesi

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

Eylem list aşağıdaki seçeneği destekler:

Seçenek Tanım
--language Döndürülen şablonların filtreleneceği dil. Varsayılan değer tüm dilleri döndürmektir.