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 dotnet geç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 node desteklenir--worker-runtime . Seçenekler ve javascript şeklindedirtypescript . veya --worker-runtime typescript de 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 V2 V3 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 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 , python ve 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-isolated geçerlidir. Desteklenen değerler şunlardır: net6.0 (varsayılan), net7.0 , net8.0 ve 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:
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 --useHttps desteklenir. |
--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 true ayarlandığı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 --cert kullanı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 true ayarlandığı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 --registry ayarlanan kayıt defterine gönderilir. ile --image-name kullanamazsı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-build ile --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ı 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 , completed ve failed gibi running belirli 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 , canceled ve failed gibi completd belirli 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 sync 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 install
aş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 package
standart 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 Values nesneye 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-name kullanamazsı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 Values nesneye 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 , NodePort ve 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-name ayarlanı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 Values
yeni 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 Values
koleksiyondaki ö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 false
ayarlanı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 Values
koleksiyondan 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 Values
koleksiyondaki 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. |