Azure İşlevleri Core Tools başvurusu

  • Makale

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ğlamlara göre düzenlenir ve her biri benzersiz bir eylem kümesi sağlar.

Komut bağlamı Description
func Yerel bilgisayarınızda işlev oluşturmak ve çalıştırmak için kullanılan komutlar.
func azure Yayımlama 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ğıtma.
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 Açıklama
--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 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. belirtilmezse veya local.settings.json dosyasında 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 proje 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. Python ve V4V3 Node.js için ve seçenekleri desteklenir V1V2. Daha fazla bilgi için bkz. Sırasıyla Python geliştirici kılavuzu ve Node.js geliştirici kılavuzu.
--source-control Git deposunun oluşturulup oluşturulmadığını denetler. Varsayılan olarak bir depo oluşturulmaz. olduğunda true, bir 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.0ve net48 (.NET Framework 4,8).

Not

veya --dockerfile seçeneklerini kullandığınızda--docker, Core Tools 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 Açıklama
--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 şablonu temel alan 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 Açıklama
--authlevel BIR 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 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 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 giriş istemi yoktur.
--timeout Yerel İşlevler ana bilgisayarı 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 Açıklama
--cert Özel anahtar içeren bir .pfx dosyasının yolu. Yalnızca ile --useHttpsdesteklenir.
--cors Boşluk içermeyen, CORS çıkış noktalarının virgülle ayrılmış 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 ayarlandığında true, 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üklenemiyor 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 Bir .pfx dosyasının parolasını içeren parola veya 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} bağlayın http://localhost:{port}. 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. Ekrandaki değerler 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

Yerel komut istemini Azure'daki işlev uygulaması için akış günlüklerine 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ştirebilirsiniz. Tüketim planındaki 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 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 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 bağlı olarak aşağıdaki yayımlama seçenekleri geçerlidir:

Seçenek Açıklama
--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 Linux işlev uygulamasına dağıtım yaparken 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şlevlerini yayımlarken, temel 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ırlama doğrulamasını yoksayın.
--list-ignored-files Yayımlama sırasında yoksayılan ve dosyayı temel alan .funcignore dosyaların listesini görüntüler.
--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 bastırın.
--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ı isteyin. 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 yayımlama ayarları 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ı için bağlantı dizesini alır.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Daha fazla bilgi için bkz. Depolama bağlantı dizesini 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 Açıklama
--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 ayarlandığında true, yerel Docker derlemesini atlar.
--image-name Kapsayıcı kayıt defterindeki mevcut 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ı yönetilirken de kullanılır. Ad ortamda benzersiz olmalıdır.
--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 kayıt defterinden almak için kullanılan parola veya belirteç.
--registry-username Görüntüyü özel 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, powershell, ve custom (müşteri işleyicileri için).

Önemli

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

func dağıtımı

func deploy Komut 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 Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesini 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 Açıklama
--id Düzenleme örneğinin kimliğini belirtir (gerekli).
--connection-string-setting Kullanılacak depolama bağlantı dizesini 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 Açıklama
--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ı dizesini içeren uygulama ayarının isteğe bağlı adı.
--created-after İsteğe bağlı olarak, bu tarih/saat (UTC) sonrasında 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 Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesini 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 Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesini içeren ayarın isteğe bağlı adı.
--created-after İsteğe bağlı olarak, bu tarih/saat (UTC) sonrasında 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. dahil etmezseniz --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ı yükseltme olayı

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 Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesini içeren ayarın isteğe bağlı adı.
--event-data Olaya satır içi veya JSON dosyasından (gerekli) geçirecek veriler. Dosyalar için, dosya yolunun önüne ve işareti ()@ ekleyin, örneğin @path/to/file.json.
--event-name Yükseltecek 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 Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesini 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 Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesini içeren ayarın isteğe bağlı adı.
--function-name Başlatacak düzenleyici 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, dosya yolunun önüne 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 Açıklama
--connection-string-setting Kullanılacak depolama bağlantı dizesini 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 Açıklama
--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, ile olduğu gibi func extensions syncbaşvuruda bulunan tüm uzantılar yü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:

    • 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 Core Tools, 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 Açıklama
--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 kubernetes kümesinde yayımlar. Özel kapsayıcılar bir Dockerfile'a sahip 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 Açıklama
--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 nesneye Values göre 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 eder. Varsayılan davranış, hatada durdurmaktı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 maksimum ç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. 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ındakiValues 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üler.
--service-type Kubernetes Service'in 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 Secret bir nesne (v1) kullanın. Harita adı kullanılarak --config-map-nameayarlanır.

Core Tools, görüntüyü derlemek ve yayımlamak için yerel Docker CLI'yı 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 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ü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 yapılandırma dosyasında tanımlanan kümeden kaldırır.

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

Seçenek Açıklama
--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 settings add

local.settings.json dosyasındaki koleksiyona Values yeni bir ayar ekler.

func settings add <SETTING_NAME> <VALUE>

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

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

Seçenek Açıklama
--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 edinmek için bkz . local.settings.json dosyası.

func ayarları şifre çözme

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

func settings decrypt

Koleksiyondaki bağlantı 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ındakiValues koleksiyondan var olan bir ayarı kaldırır.

func settings delete <SETTING_NAME>

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

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

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

func ayarları şifreleme

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

func settings encrypt

Koleksiyondaki ConnectionStrings bağlantı dizesi değerleri de şifrelenir. local.settings.json dosyasında, IsEncrypted 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 ayarların Values listesini oluşturur.

func settings list

Koleksiyondaki ConnectionStrings bağlantı 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 Açıklama
--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 Açıklama
--language Döndürülen şablonların filtreleneceği dil. Varsayılan değer tüm dilleri döndürmektir.