Azure İşlevleri uzantı paketleri

Bu makalede, uzantı paketlerinin işlev kodunuzun Azure İşlevleri'nin desteklediği tüm tetikleyicileri ve bağlamaları kullanmasını nasıl sağladığı açıklanmaktadır. Uzantı paketlerini kullanırken uygulamalarınıza yönelik destek düzeyleri ve ilkeleri hakkında da bilgi edinebilirsiniz.

Bu makale yalnızca non-.NET dilleri kullanan Azure İşlevleri geliştiricileri için geçerlidir. Bağlama uzantılarını doğrudan C# işlev uygulamalarınıza eklemeyi öğrenmek için bkz. Azure İşlevleri bağlama uzantılarını kaydetme.

Overview

Uzantı paketleri, işlev uygulamanıza önceden tanımlanmış bir uyumlu bağlama uzantıları kümesi ekler. Paket, şu anda İşlevler tarafından desteklenen tüm bağlama uzantılarını içerir. Uzantı paketleri sürümü oluşturulur. Her sürüm, birlikte çalıştığı doğrulanmış belirli bir bağlama uzantısı sürümleri kümesi içerir.

Mümkün olduğunda uygulamanızda her zaman en son paket sürümünü kullanmanız gerekir.

bir non-.NET şablonundan Azure İşlevleri projesi oluşturduğunuzda, uzantı paketleri uygulamanın host.json dosyasında zaten etkinleştirilir.

Uzantı paketi referansı tanımlama

Proje dosyasına bir host.json ek paketi referansı eklemek için aşağıdaki örnek gibi bir bölüm eklersiniz:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

Bu örnekte, version değeri [4.0.0, 5.0.0) İşlevler konağına en az 4.0.0 ama daha küçük 5.0.0olan ve 4.x'in tüm olası sürümlerini içeren bir paket sürümü kullanma talimatı verir. Bu gösterim, uygulamanızı v4.x uzantı paketinin mevcut en son küçük sürümünde etkili bir şekilde güncel tutar.

Aşağıdaki özellikler extensionBundle öğesinde kullanıma sunuldu:

Property Description
id Azure İşlevleri uzantısı paketleri için ad alanı.
version Yüklenecek paketin sürüm aralığı. Azure İşlevleri çalışma zamanı her zaman sürüm aralığının veya aralığın tanımladığı izin verilen en yüksek sürümü seçer. Örneğin, version değer aralığı [4.0.0, 5.0.0), 4.0.0'dan 5.0.0'a kadar (5.0.0 hariç) tüm paket sürümlerine izin verir. Daha fazla bilgi için bkz. sürüm aralıklarını belirtmeye yönelik aralık gösterimi.

Tavsiye

host.jsonolarak [4.*, 5.0.0)tanımlanan sürüm aralığını da görebilirsiniz. Bu, ile aynı şekilde [4.0.0, 5.0.0)yorumlanır.

Paket sürümleri

Bu tabloda tüm Microsoft.Azure.Functions.ExtensionBundle sürümler ve geçerli destek durumu listelenmektedir:

Paket sürümü host.json sürümü Destek durumu*
4.x [4.0.0, 5.0.0)
[4.*, 5.0.0)		 Active
3.x [3.3.0, 4.0.0) Önerilmiyor
2.x [2.*, 3.0.0) Önerilmiyor
1.x [1.*, 2.0.0) Önerilmiyor

* Kullanım dışı bırakılan paket sürümleri, kullanım dışı bağlama uzantısı sürümlerini içerebilir. En iyi desteklenebilirlik ve güvenilirlik için paket 4.x sürümüne yükseltmeniz gerekir.

Varsayılan olarak, uzantı paketleri sürüm aralıkları aracılığıyla tanımlanır ve bu da en son ikincil paket sürümünün kullanılmasını garanti eder. Bu ana sürüm için en son paketi tanımlayan dosyayı gözden geçirmek extensions.json için tablodan bir sürüm bağlantısı seçin.

Uzantı paketleri için dikkat edilmesi gerekenler

Uzantı paketleriyle çalışırken şu noktaları göz önünde bulundurun:

  • Mümkün olduğunda, özel bir version aralık tanımlamak yerine yukarıdaki tablodan host.jsoniçinde gibi bir aralık değeri [4.0.0, 5.0.0) ayarlamanız gerekir.
  • En iyi uygulama performansını elde etmek ve en son özelliklere erişmek için en son sürüm aralığını kullanın.
  • Bir uzantı paketini kullanamama olasılığı düşük bir durumda, bunun yerine uzantıları açıkça yüklemeniz gerekir.
  • Dağıtılan bir uygulama tarafından kullanılan uzantıları güncelleştirirken İşlevler uç noktadan yeni uzantı sürümlerini cdn.functions.azure.com indirir. Uzantı güncelleştirmelerinin başarılı olması için uç noktanın cdn.functions.azure.com işlev uygulamanız tarafından erişilebilir olması gerekir.

Uzantı paketlerini yükseltme

Uygulamalarınızın yeni özellikler, güvenlik düzeltme ekleri ve performans iyileştirmeleri için uygun olmaya devam edebilmesi için paket sürümünüzü up-togüncel tutmanız önemlidir.

Uygulamanızı en son pakete yükseltmek için uygulama projenizin kökündeki host.json dosyasını düzenleyin. değerini extensionBundle.version[4.0.0,5.0.0)olarak ayarlayın; bu, host.json dosyanızda şöyle görünmelidir:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

Uygulamanız tarafından kullanılan uzantı paketi sürümünü yükseltirken şu noktaları göz önünde bulundurun:

  • En son 4.x paketinin içeriği her zaman depodaki bu sürüm sayfasında bulunabilir.
  • Sürümler arasında hataya neden olan değişiklikleri aramak için uygulamanız tarafından kullanılan uzantıların başvuru belgelerini gözden geçirin. Varsayılan pakette yer alan uzantı sürümlerinin listesi için extension.json bağlanan proje dosyasına bakın. Belirli paket sürümü etiketleri için paket deposundaki paket sürümleri sayfasını gözden geçirebilirsiniz.
  • Güncelleştirilmiş uzantılarla uyumluluğu sağlamak için paket sürümünü yükselttikten sonra uygulamanızı her zaman yerel olarak doğrulayın. İşlev uygulamanızı yerel olarak çalıştırmak için Azure İşlevleri Çekirdek Araçları'nda func start komutunu veya Visual Studio veya Visual Studio Code'da F5'i kullanabilirsiniz.
  • host.json dosyasındaki paket sürümünde yapılan değişikliklere göre güncelleştirilecek uzantıları tetikleme yönteminiz uygulama ortamınıza bağlıdır:
    • Yerel proje: Uzantılar, Core Tools başlatıldığında, func start komutu aracılığıyla veya geliştirme araçlarınızda hata ayıklarken yerel olarak güncellenir.
    • İşlev uygulaması: Güncelleştirilmiş host.json dosyasını Azure'daki işlev uygulamanıza dağıttığınızda uzantılar güncelleştirilir.

Uzantı paketleri destek ilkesi

Uzantı paketinin ana sürüm sürümleri, kapsanan bağlama uzantılarından birinde hataya neden olan değişiklik güncelleştirmeleri olduğunda ortaya çıkabilir. Bu uzantı hataya neden olan değişiklikler, temel alınan Azure SDK'larıyla uyumlu kalmak için paket güncelleştirmelerini gerektirir. Paketi yükseltmek, uygulamalarınızın yeni özellikler, performans iyileştirmeleri ve tam ürün desteği almaya devam etmesini sağlar.

Uyarı

Uzantı paketi güncelleştirmeleri, temel alınan Azure SDK'larındaki güncelleştirmelerle yönlendirildiğinden, uzantı paketleri için destek döngüsü genellikle temel alınan Azure SDK'larının destek ilkelerini izler.

Microsoft, bir uzantı paketi veya bağlama uzantısı sürümü kullanım dışı bırakıldığında size bildirir. Bu bildirimler konak günlükleri, Application Insights tabloları veya Azure portalı gibi İşlevler deneyiminizin farklı bölümlerinde görünebilir. Bu bildirimlerle karşılaştığınızda, işlev uygulamalarınızı planlama ve desteklenen en son uzantı paketi sürümüne yükseltme işlemini başlatmanız gerekir.

Uzantı paketlerinin destek döngüsü şu ayrı aşamaları izler:

Phase Description
Önizleme Belirli bağlama uzantılarının yayın öncesi sürümleri bir önizleme uzantısı paketinde (Microsoft.Azure.Functions.ExtensionBundle.Preview ) tutulur. Bu önizleme uzantısı paketini, genel kullanıma (GA) ulaşmadan önce mevcut uzantılardaki önizleme uzantılarından ve yeni davranışlardan yararlanmak için kullanabilirsiniz. Daha fazla bilgi için bkz. Önizleme uzantısı paketleriyle çalışma.
Etkin Uzantı paketlerinin en son ana sürümü, etkin sürüm olarak kabul edilir. İşlev uygulamalarınız için bu sürümü öneririz.
Kaldırılması Paket sürümü, daha yeni bir sürümle değiştirilir ve artık kullanım dışıdır. Bir paket kullanım dışı bırakıldıktan sonra, yalnızca sınırlı bir çakışma süresi için kritik hata düzeltmeleri ve güvenlik güncelleştirmeleri alır. Bu çakışma genellikle en az 12 aydır ve bu da uygulamalarınızı planlama, test etme ve en son paket sürümüne yükseltme zamanı verir.

Kullanım dışı bırakılmış bir paketi kullanmaya devam eden işlev uygulamaları platformda çalışmaya devam edebilir. Ancak yeni özelliklere, performans iyileştirmelerine, güvenlik düzeltme eklerine ve tam desteğe erişim sağlamak için işlev uygulamalarınızı desteklenen bir paket sürümüne yükseltmeniz gerekir.

Uzantı paketi sürümlerini ve bunların dahil edilen uzantılarını Azure İşlevleri uzantı paketleri deposunda görüntüleyebilirsiniz. Tüm İşlev uzantılarının envanteri için Azure SDK yayınları sayfasını da görüntüleyebilirsiniz. tek tek .NET paketlerini NuGet.org bulabilirsiniz.

Önizleme uzantısı paketleriyle çalışma

GA dışı bir uzantı paketi kullanmayı seçtiğinizde şu noktaları göz önünde bulundurun:

  • Önizleme paketleri, hala geliştirme aşamasında olan ve henüz üretim kullanımına hazır olmayan özellikler içerebilir. Üretim dışı ortamlarda değerlendirme ve test için tasarlanmıştır.
  • Önizleme sürümleri arasında önceden bildirimde bulunmadan uyumsuz değişiklikler meydana gelebilir. Bunlar şu değişikliklere yer verebilir:
    • Tetikleyici ve bağlama tanımları.
    • Önizlemeye dahil edilen uzantılar.
    • Performans özellikleri ve kararlılık.
  • Güvenlik güncelleştirmeleri, sürümleri yükseltmenizi gerektirebilir.
  • Üretim dışı ortamlarda önizleme paketlerini tamamen test etmeniz ve önizleme paketlerini üretim ortamında kullanmaktan kaçınmanız gerekir. Üretimde bir önizleme paketi kullanmanız gerektiğinde şu ek önlemleri alın:
    • Paketinizi bir aralık yerine belirli, iyi test edilmiş bir paket sürümüne sabitleyin. Sabitleme, üretim dışı bir ortamda güncelleştirmeyi doğrulama fırsatınız olmadan önce paket sürümünüzün otomatik olarak yükseltilmesine engel olur.
    • İşlev tam olarak desteklenen bir paket sürümünde kullanılabilir duruma gelir gelmez uygulamanızı GA paket sürümünü kullanmaya taşıyın.
  • Önizlemeden GA'ya geçiş de dahil olmak üzere paket güncelleştirmeleri hakkında bilgi sahibi olmak için şunları yapmalısınız:

İlgili içerik

  • Last updated on