Azure İşlevleri çalışma zamanı sürümlerinin hedefini belirleme

İşlev uygulaması, Azure İşlevleri çalışma zamanının belirli bir sürümünde çalışır. Varsayılan olarak, İşlevler çalışma zamanının en son 4.x sürümünde işlev uygulamaları oluşturursunuz. İşlev uygulamalarınız yalnızca desteklenen bir ana sürümde çalıştırıldığında desteklenir. Bu makalede, gerektiğinde İşlevler çalışma zamanının belirli bir sürümünü hedeflemek veya sabitlemek için Azure'da bir işlev uygulamasını yapılandırma adımları açıklanmaktadır.

Değerlendirmeler

Belirli bir çalışma zamanı sürümünü hedeflerken şu noktaları göz önünde bulundurun:

  • Esnek Tüketim planı yalnızca çalışma zamanının 4.x sürümünde çalışır. Flex Consumption planı uygulama ayarını desteklemediğinden FUNCTIONS_EXTENSION_VERSION , uygulamanız bu planda çalışırken belirli bir çalışma zamanı sürümünü hedefleyemez.
  • Belirli bir sürümü hedefleme şekliniz, Windows veya Linux kullanıp çalıştırmadığınıza bağlıdır.
  • Bu makale Windows veya Linux'a özgüdür. Makalenin üst kısmından işletim sisteminizi seçin.
  • Mümkün olduğunda uygulamanızı her zaman desteklenen en son çalışma zamanı sürümünde çalıştırın. Uygulamanızı yalnızca en son sürümle ilgili bir sorun nedeniyle talimat verildiğinde belirli bir sürüme sabitleyin. İşlevleriniz doğru şekilde çalıştırıldığında her zaman en son çalışma zamanı sürümüne geçin.
  • Yerel geliştirme sırasında, yüklü Azure İşlevleri Core Tools sürümünüz Azure'daki işlev uygulaması tarafından kullanılan ana çalışma zamanı sürümüyle eşleşmelidir. Daha fazla bilgi için bkz . Temel Araçlar sürümleri.

Çalışma zamanı sürümünüzü güncelleştirme

Mümkün olduğunda, işlev uygulamalarınızı her zaman Azure İşlevleri çalışma zamanının desteklenen en son sürümünde çalıştırın. İşlev uygulamanız şu anda çalışma zamanının eski bir sürümünde çalışıyorsa uygulamanızı 4.x sürümüne geçirin.

Uygulamanızın mevcut işlevleri olduğunda, daha sonraki bir ana çalışma zamanı sürümüne geçmeden önce önlem almanız gerekir. Aşağıdaki makaleler, dile özgü uyumluluğu bozan değişiklikler de dahil olmak üzere, ana sürümler arasındaki uyumluluğu bozan değişiklikleri ayrıntılı olarak açıklar. Ayrıca, mevcut işlev uygulamanızı başarıyla taşımak için size adım adım yönergeler sunarlar.

Geçerli çalışma zamanı sürümünüzü belirlemek için bkz . Geçerli çalışma zamanı sürümünü görüntüleme.

Geçerli çalışma zamanı sürümünü görüntüleme

İşlev uygulamanızın geçerli çalışma zamanı sürümünü şu yollardan biriyle görüntüleyebilirsiniz:

Bir işlev uygulaması tarafından kullanılmakta olan çalışma zamanı sürümünü görüntülemek ve güncelleştirmek için şu adımları izleyin:

  1. Azure portalında işlev uygulamanıza göz atın.

  2. Ayarlar öğesini genişletin ve ardından Yapılandırma öğesini seçin.

  3. İşlev çalışma zamanı ayarları sekmesinde Çalışma Zamanı sürümüne dikkat edin. Bu örnekte, sürüm olarak ~4ayarlanır.

    Çalışma zamanı sürümünün nasıl görüntülendiğini gösteren ekran görüntüsü.

Belirli bir sürüme sabitleme

Azure İşlevleri, belirli bir işlev uygulaması tarafından kullanılan çalışma zamanı sürümünü hedeflemek için uygulama ayarını kullanmanıza FUNCTIONS_EXTENSION_VERSION olanak tanır. Yalnızca ana sürümü ()~4 belirtirseniz, işlev uygulaması kullanılabilir duruma geldikçe çalışma zamanının yeni ikincil sürümlerine otomatik olarak güncelleştirilir. İkincil sürüm güncelleştirmeleri otomatiktir çünkü yeni ikincil sürümler işlevlerinizi bozan değişikliklere neden olmaz.

Linux uygulamaları, işlevlerinizin çalıştırılacağı doğru Linux temel görüntüsünü belirlemek için linuxFxVersion site ayarınıFUNCTIONS_EXTENSION_VERSION ile birlikte kullanır. Linux'ta yeni bir işlev uygulaması oluşturduğunuzda çalışma zamanı, dil yığınınızın çalışma zamanı sürümüne göre sizin için doğru temel görüntüyü otomatik olarak seçer.

Belirli bir çalışma zamanı sürümüne sabitlemek işlev uygulamanızı yeniden başlatır.

Belirli bir ikincil sürüm (örneğin 4.0.12345) belirttiğinizde FUNCTIONS_EXTENSION_VERSION içinde, otomatik sürüm güncellemelerine geri dönmeyi açıkça seçene kadar işlev uygulamasını çalışma zamanının o belirli sürümüne sabitlersiniz. İşlev uygulamanızla ilgili ana sürümü hedeflemenizi engelleyen sorunları çözmek için yalnızca belirli bir ikincil sürüme sabitleyin. Eski ikincil sürümler üretim ortamından düzenli olarak kaldırılır. İşlev uygulamanız, kaldırılmış küçük bir sürüme sabitlendiğinde,FUNCTIONS_EXTENSION_VERSION içinde ayarlanan sürüm yerine mevcut en yakın sürümde çalışır. App Service duyuruları minör versiyon kaldırmalarını bildirir.

Not

Visual Studio'dan çalışma zamanının belirli bir ikincil sürümüne sabitlenmiş bir uygulamaya yayımlamayı denediğinizde, bir iletişim kutusu sizden en son sürüme güncelleştirmenizi veya yayımlamayı iptal etmenizi ister. Belirli bir alt sürümü kullanmanız gerektiğinde bu denetimi önlemek için `<DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate>` özelliğini `.csproj` dosyanıza ekleyin.

Uygulamanızı çalışma zamanının belirli bir sürümüne geçici olarak sabitlemek için şu yöntemlerden birini kullanın:

Bir işlev uygulaması tarafından kullanılmakta olan çalışma zamanı sürümünü görüntülemek ve güncelleştirmek için şu adımları izleyin:

  1. Azure portalında işlev uygulamanıza göz atın.

  2. Ayarlar'ı genişletin ve ardından Yapılandırma'yı seçin.

  3. İşlev çalışma zamanı ayarları sekmesinde Çalışma Zamanı sürümüne dikkat edin. Bu örnekte, sürüm olarak ~4ayarlanır.

    Çalışma zamanı sürümünün nasıl görüntülendiğini gösteren ekran görüntüsü.

  1. Uygulamanızı belirli bir ikincil sürüme sabitlemek için sol bölmede Ayarlar'ı genişletin ve ortam değişkenleri'ni seçin.

  2. Uygulama ayarları sekmesinden FUNCTIONS_EXTENSION_VERSION'ı seçin, Değer'i gerekli ikincil sürümünüzle değiştirin ve uygula'yı seçin.

  3. Uygula'yı seçin ve ardından değişiklikleri uygulamak ve uygulamayı yeniden başlatmak için Onayla'yı seçin.

Uygulama ayarında değişiklik yapıldıktan sonra işlev uygulaması yeniden başlatılır.

İşlev uygulamanızı Linux'ta belirli bir çalışma zamanı sürümüne sabitlemek için, biçiminde site ayarındalinuxFxVersion sürüme özgü bir temel görüntü URL'si DOCKER|<PINNED_VERSION_IMAGE_URI>ayarlayın.

Önemli

Linux'ta sabitlenmiş işlev uygulamaları düzenli güvenlik ve konak işlev güncelleştirmeleri almaz. Bir destek uzmanı tarafından önerilmediği sürece, FUNCTIONS_EXTENSION_VERSION ayarını ve diliniz ile sürümünüz için standart bir linuxFxVersion değerini, örneğin Python|3.12 gibi, kullanın. Geçerli değerler için başvuru makalesine linuxFxVersionbakın.

Tüketim planında çalışan Linux işlev uygulamaları için belirli bir çalışma zamanına sabitleme şu anda desteklenmiyor.

Aşağıdaki örnek, Node.js 22 işlev uygulamasını belirli bir 4.14.0.3 çalışma zamanı sürümüne sabitlemek için gereken değeri gösterir linuxFxVersion :

DOCKER|mcr.microsoft.com/azure-functions/node:4.14.0.3-node22

Gerektiğinde, bir destek uzmanı uygulamanız için geçerli bir temel görüntü URI'sini sağlayabilir.

linuxFxVersion öğesini görüntülemek ve ayarlamak için aşağıdaki Azure CLI komutlarını kullanın. Şu anda portalda veya Azure PowerShell kullanarak ayarlayamazsınız linuxFxVersion :

  • Geçerli çalışma zamanı sürümünü görüntülemek için az functionapp config show komutunu kullanın:

    az functionapp config show --name <function_app> \
    --resource-group <my_resource_group> --query 'linuxFxVersion' -o tsv
    

    Bu kodda, <function_app> ifadesini işlev uygulamanızın adıyla değiştirin. Ayrıca, <my_resource_group> ifadesini işlev uygulamanızın kaynak grubunun adıyla değiştirin. linuxFxVersion geçerli değeri döndürülür.

  • İşlev uygulamasındaki linuxFxVersion ayarını güncelleştirmek için az functionapp config set komutunu kullanın:

    az functionapp config set --name <FUNCTION_APP> \
    --resource-group <RESOURCE_GROUP> \
    --linux-fx-version <LINUX_FX_VERSION>
    

    <FUNCTION_APP> öğesini işlev uygulamanızın adıyla değiştirin. Ayrıca, <RESOURCE_GROUP> ifadesini işlev uygulamanızın kaynak grubunun adıyla değiştirin. Son olarak, <LINUX_FX_VERSION> öğesini bir destek uzmanı tarafından size sağlanan belirli bir görüntünün değeriyle değiştirin.

Önceki kod örneklerinde Cloud Shell’i Aç seçeneğini belirleyerek bu komutları Azure Cloud Shell üzerinden çalıştırabilirsiniz. Bu komutu çalıştırmak için, oturum açmak üzere az login komutunu çalıştırdıktan sonra Azure CLI’yi yerel olarak da kullanabilirsiniz.

site yapılandırmasında değişiklik yapıldıktan sonra işlev uygulaması yeniden başlatılır.

Sonraki adımlar