Azure İşlevleri CLI kullanarak yerel olarak Azure İşlevleri geliştirme (önizleme)

Azure İşlevleri CLI, Azure İşlevleri için yerel geliştirme çalışma zamanı ve araç setinin bir sonraki ana sürümüdür (v5). bu func.exe sürümü iş yükü tabanlı bir mimariye sahiptir, bu nedenle yalnızca geliştirdiğiniz yığın için gerekenleri indirirsiniz.

Important

Azure İşlevleri CLI (v5) şu anda önizleme aşamasında. Bu önizleme sürümü henüz Java ve PowerShell'i desteklemez. Şu anda desteklenmeyen dillerle çalışmak için Azure İşlevleri Core Tools v4 kullanmaya devam edin.

Azure İşlevleri için sunulan func.exe adlı iki komut satırı aracı vardır:

Azure İşlevleri Temel Araçları Azure İşlevleri CLI
func.exe sürümü v4 v5
Destek düzeyi Genel kullanılabilirlik (GA) Preview
Ayak izini yükleme Tüm yerel diller için tüm komutları ve özellikleri içeren tam ikili. Küçük temel yüklemenin yanı sıra dil başına iş yükleri ve gerektiğinde eklediğiniz diğer özellikler. Barındırıcı ayrı bir iş yükü olarak dağıtılır, böylece CLI’yi yeniden indirmeden en son barındırıcı sürümünü edinirsiniz.
Kullanılacağı durum Tüm geliştirme iş akışları için tam GA desteğine ihtiyacınız vardır. Yerel ortamınızı Azure barındırma planı yapılandırmanızla eşitlenmiş durumda tutan hızlı başlangıç şablonları ve profilleri gibi yeni özelliklerle hafif, iş yükü tabanlı bir deneyim istiyorsunuz.

Komut başvurusu hakkında bilgi için Azure İşlevleri CLI başvurusuna bakın.

Dil yığını desteğinin olmaması nedeniyle örnekler şu anda kullanılamıyor.

Azure İşlevleri CLI'yi yükleme

Azure İşlevleri CLI, küçük bir temel yükleme ve içinde geliştirdiğiniz yığınlar için eklediğiniz iş yükleri olarak dağıtılır. Kurulumdan sonra, func ikili dosyası PATH konumunda bulunur.

Note

Yükleme yöntemi önizleme ve genel kullanılabilirlik arasında değişebilir.

iex "& { $(irm https://aka.ms/func-cli/install.ps1) } -Prerelease"

Önceki bir kurulumdan yükseltiyorsanız, komuta -Force (PowerShell) veya --force (Bash) ekleyin.

Yüklemeyi doğrulayın:

func --version

Temel CLI'yı yükledikten sonra yığınınızın iş yüklerini yükleyin. En hızlı yol func setup, tek adımda konağı, dil çalışanını, uzantı paketlerini (gerektiğinde), yığın iş yükünü ve şablon iş yükünü yükleyen yöntemidir.

Örneğin:

func setup --features dotnet

func setup --features node

func setup --features python

func setup --features go

Ayrıca, func workload install kullanarak iş yüklerini ayrı ayrı yükleyebilirsiniz. Her iki durumda da, gerekli iş yükleri yüklü değilken func init, func new veya func run komutunu ilk kez çalıştırdığınızda CLI bunları yüklemeniz için sizi uyarır.

Workloads

Azure İşlevleri CLI, workload modeli kullanır. Temel func yükleme küçük ve dilden bağımsızdır. İş yüklerini isteğe bağlı olarak yükleyerek yığına özgü araçları, İşlevler ana bilgisayarını, dil çalışanlarını, uzantı paketlerini ve şablonları alırsınız.

İş yükleri şu kategorilere ayrılır:

  • Host: func run tarafından kullanılan Azure İşlevleri ana bilgisayar çalışma zamanı.
  • Paketler: Tetikleyicilerin ve bağlantıların ek yapılandırma gerektirmeden çalışması için önceden oluşturulmuş uzantı paketi çıktıları (.NET dışındaki yığınlar için gereklidir).
  • Stack: Dile özel proje araçları (örneğin, python, node, dotnet).
  • Çalışan: Konağın çalışma zamanında kullandığı dil çalışanı (örneğin, , python-workernode-worker).
  • Şablonlar: tarafından ortaya çıkarılmış func new işlev şablonları (örneğin, python-templates, node-templates).

Kullanılabilir iş yüklerinin tam listesi ve açıklamaları için CLI başvurusundaki Kullanılabilir iş yükleri bölümüne bakın.

İlk kullanım deneyimi

func init, func new veya func run öğesini ilk kez çalıştırdığınızda, CLI senaryonuz için gerekli iş yüklerinin yüklü olup olmadığını kontrol eder. Yüklü değillerse, CLI bunları yüklemenizi ister. İstemi kabul etmek, seçtiğiniz yığın için önerilen kümeyi yükler. İstemi geri çevirebilir ve iş yüklerini func workload install kullanarak el ile yükleyebilir ya da standart bileşenleri etkileşimsiz olarak kurmak için func setup komutunu çalıştırabilirsiniz.

İş yükü güncelleştirmeleri

Yeni kullanılabilir iş yüklerini denetlemek için düzenli aralıklarla çalıştırın func workload search . Desteklenmeyen yığınlar için veya Temel Araçlar'ın belirli GA özelliklerine ihtiyacınız olduğunda Çekirdek Araçları'nı (v4) kullanmaya devam edin.

Yerel proje oluşturma

Yeni bir İşlevler projesi oluşturmak için komutunu kullanın func init .

func init MyProjFolder --stack dotnet

func init MyProjFolder --stack node --language javascript

func init MyProjFolder --stack node --language typescript

func init MyProjFolder --stack python

func init MyProjFolder --stack go

--stack seçeneği, hangi dil yığınının kullanılacağını belirtir. Bu yığın için yüklenen iş yükü, iskelet yapısını sağlar.

İşlev oluşturma

Şablondan işlev eklemek için komutunu kullanın func new .

func new --template "HTTP trigger" --name MyHttpTrigger

İşlevleri yerel olarak çalıştırma

İşlevler ana bilgisayarını başlatmak ve projenizi çalıştırmak için kullanın func run:

func run

func start geriye dönük uyumlu bir diğer ad olarak korunur. Konak, --no-azurite parametresini geçmediğiniz sürece Azurite'yi (yerel depolama öykünücüsü) otomatik olarak yönetir.

Hızlı başlangıç şablonlarından iskele

Tam örnek uygulamalara (HTTP API'leri, kuyruk çalışanları, Dayanıklı İşlevler düzenlemeleri) göz atmak ve bunların iskelesini yapmak için func quickstart kullanın:

func quickstart --stack dotnet --resource http

func quickstart --stack node --resource http

func quickstart --stack python --resource http

func quickstart --stack go --resource http

İş yüklerini yönetme

İş yüklerini yüklemek, güncelleştirmek ve kaldırmak için kullanın func workload . Alt komutların ve seçeneklerin tam listesi için CLI başvurusuna bakın func workload .

Profiles

Profiller konak, uzantı paketleri ve çalışanlar için sürüm kısıtlamalarını kodlar. Çalışma zamanında, func run --profile <name> kullanarak bir profil uygulayın. Alt komutların ve seçeneklerin tam listesi için CLI başvurusuna bakın func profile .

İlgili içerik

  • Last updated on