Azure İşlevleri Core Tools 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ğ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 dotnet geçerlidir. |
--docker |
Seçilen --worker-runtime öğesini temel alan bir temel görüntü kullanarak kapsayıcı için bir Dockerfile oluşturur. Kapsayıcılı işlev uygulaması dağıtmayı planlarken bu seçeneği kullanın. |
--docker-only |
Var olan bir projeye Dockerfile ekler. 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 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. Python ve V4 V3 Node.js için ve seçenekleri desteklenir V1 V2 . 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 , 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 ve 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 --useHttps desteklenir. |
--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 --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} 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 --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 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-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ı 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 , 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 | 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 , 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. 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 sync baş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 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:
- 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-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ı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 , NodePort ve 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-name ayarlanı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 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ı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. |