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ı | Açıklama |
---|---|
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 | Açıklama |
---|---|
--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 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 ve V2 V3 Node.js için ve V4 seçenekleridirV1 . Daha fazla bilgi için sırasıyla Python geliştirici kılavuzuna ve 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: net9.0 (önizleme), net8.0 (varsayılan), net6.0 ve net48 (.NET Framework 4.8). |
Not
Veya --docker-only
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 logs
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 ş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 | Açıklama |
---|---|
--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 bkz . Yetkilendirme düzeyi. |
--csx |
(Sürüm 2.x ve sonraki sürümler.) 1.x sürümünde ve portalda kullanılan aynı C# betiği (.csx) şablonlarını oluşturur. |
--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 | Açıklama |
---|---|
--content |
İşleve satır içi içerik geçirildi. |
--debug |
İşlevi çalıştırmadan önce konak işlemine bir hata ayıklayıcısı ekleyin. |
--file |
İçerik olarak kullanılacak dosya adı. |
--no-interactive |
Otomasyon senaryoları için yararlı olan girdileri sormaz. |
--timeout |
Yerel İşlevler konağı hazır olana kadar bekleme süresi (saniye cinsinden). |
Örneğin, HTTP ile tetiklenen bir işlevi çağırmak ve içerik gövdesini geçirmek için 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 --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
Yerel komut istemini Azure'daki işlev uygulamasının 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ı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 | Açıklama |
---|---|
--browser |
varsayılan tarayıcıda işlev uygulaması için Azure Uygulaması Lication Insights Canlı Akışı'nı açın. |
Daha fazla bilgi için bkz. Azure İşlevleri'da akış yürütme günlüklerini etkinleştirme.
func azure functionapp publish
İşlevler projesini Azure'daki mevcut bir işlev uygulaması kaynağına dağıtır.
func azure functionapp publish <APP_NAME>
Daha fazla bilgi için bkz . Proje dosyalarını dağıtma.
Sürüme göre aşağıdaki yayımlama seçenekleri geçerlidir:
Seçenek | Açıklama |
---|---|
--access-token |
Kimliği doğrulanmış eylemler gerçekleştirirken belirli bir erişim belirtecini kullanmanıza azure 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'daki ayarları Azure'da yayımlayın ve 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ı için 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 | Açıklama |
---|---|
--access-token |
Kimliği doğrulanmış eylemler gerçekleştirirken belirli bir erişim belirtecini kullanmanıza azure 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 deploy
Komut func deploy
kullanım dışıdır. Bunun yerine kullanın func kubernetes deploy
.
func durable 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ı 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 durable 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ı 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 durable 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ı 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 durable 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ı 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 durable purge-history
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ı 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 durable 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 | Açıklama |
---|---|
--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 durable rewind
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ı 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 durable start-new
Belirtilen orchestrator işlevinin yeni bir örneğini başlatır.
func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>
Eylem start-new
aşağıdaki seçenekleri destekler:
Seçenek | Açıklama |
---|---|
--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 durable terminate
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ı 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 extensions install
İş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, 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 extensions sync
İş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 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 | 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 Values nesneyi temel alan 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 |
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 |
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 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 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 | 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 config 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 Values
koleksiyona 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 | 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 settings decrypt
local.settings.json dosyasındaki Values
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'da da IsEncrypted
olarak false
ayarlanır. Local.settings.json değerli bilgilerin sızma riskini azaltmak için yerel ayarları şifreleyin. Azure'da uygulama ayarları her zaman şifrelenmiş olarak depolanır.
func settings delete
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 | Açıklama |
---|---|
--connectionString |
Ad-değer çiftini koleksiyondan ConnectionStrings değil koleksiyondan Values kaldırır. |
func settings encrypt
local.settings.json dosyasındaki koleksiyondaki Values
tek tek öğelerin değerlerini şifreler.
func settings encrypt
Koleksiyondaki ConnectionStrings
bağlantı dizesi değerleri de şifrelenir. local.settings.json'de, IsEncrypted
yerel çalışma zamanının ayarları kullanmadan önce şifresini çözdüğünü belirten olarak da ayarlanır true
. Local.settings.json değerli bilgilerin sızma riskini azaltmak için yerel ayarları şifreleyin. Azure'da uygulama ayarları her zaman şifrelenmiş olarak depolanır.
func settings list
local.settings.json dosyasındaki Values
koleksiyondaki ayarların 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 templates list
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. |