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ü hataya neden olan değişiklikler de dahil olmak üzere ana sürümler arasındaki hataya neden olan değişiklikleri ayrıntılı olarak açıklar. Ayrıca, mevcut işlev uygulamanızın başarılı bir şekilde geçirilmesi için size adım adım yönergeler sağlar.

• Çalışma zamanı sürümü 3.x'ten 4.x'e geçiş
• Çalışma zamanı sürümü 1.x'ten 4.x'e geçiş

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:

Azure portalı

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 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.

   

Azure CLI

Uygulama ayarını Azure CLI'dan görüntüleyebilirsiniz FUNCTIONS_EXTENSION_VERSION .

Azure CLI'yı kullanarak şu komutla az functionapp config appsettings list geçerli çalışma zamanı sürümünü görüntüleyin:

az functionapp config appsettings list --name <function_app> \
--resource-group <my_resource_group>

Bu kodda değerini işlev uygulamanızın adıyla değiştirin <function_app> . değerini de işlev uygulamanızın kaynak grubunun adıyla değiştirin <my_resource_group> .

Aşağıdaki kısmi çıktıda öğesini FUNCTIONS_EXTENSION_VERSION görürsünüz:

[
  {
    "name": "FUNCTIONS_EXTENSION_VERSION",
    "slotSetting": false,
    "value": "~4"
  },
  {
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "slotSetting": false,
    "value": "dotnet"
  },
  
  ...
]

Azure Cloud Shell'de komutunu çalıştırmak için yukarıdaki kod örneğinde Cloud Shell'i Aç'ı seçin. Bu komutu yürütmek için Azure CLI'yi yerel olarak da çalıştırabilirsiniz. Yerel olarak çalışırken, önce oturum açmak için komutunu çalıştırmanız az login gerekir.

Azure PowerShell

Azure İşlevleri çalışma zamanını denetlemek için aşağıdaki cmdlet'i kullanın:

Get-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>"

yerine işlev uygulamanızın ve <FUNCTION_APP>adını yazın<RESOURCE_GROUP>. Ayarın FUNCTIONS_EXTENSION_VERSION geçerli değeri karma tabloda döndürülür.

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ıldığı doğru Linux temel görüntüsünü belirlemek için site ayarını ve birlikte kullanırlinuxFxVersion 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 ikincil sürümü kullanmanız gerektiğinde bu denetimi önlemek için, özelliğini dosyanıza <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> ekleyin.csproj.

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:

Azure portalı

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 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.

   

3. 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.

4. 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.

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

Azure CLI

İşlev uygulamasındaki FUNCTIONS_EXTENSION_VERSION uygulama ayarını, az functionapp config appsettings set komutunu kullanarak güncelleştirin.

az functionapp config appsettings set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--settings FUNCTIONS_EXTENSION_VERSION=<VERSION>

değerini işlev uygulamanızın adıyla ve <FUNCTION_APP> işlev uygulamanızın kaynak grubunun adıyla değiştirin<RESOURCE_GROUP>. Ayrıca değerini geçici olarak hedeflemeniz gereken belirli bir ikincil sürümle değiştirin <VERSION> .

Azure Cloud Shell'de komutunu çalıştırmak için yukarıdaki kod örneğinde Cloud Shell'i Aç'ı seçin. Bu komutu yürütmek için Azure CLI'yi yerel olarak da çalıştırabilirsiniz. Yerel olarak çalışırken, önce oturum açmak için komutunu çalıştırmanız az login gerekir.

Azure PowerShell

İşlevler çalışma zamanını sabitlemek için bu betiği kullanın:

Update-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>" -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "<VERSION>"} -Force

değerini işlev uygulamanızın adıyla ve <FUNCTION_APP> işlev uygulamanızın kaynak grubunun adıyla değiştirin<RESOURCE_GROUP>. Ayrıca değerini geçici olarak hedeflemeniz gereken belirli bir ikincil sürümle değiştirin <VERSION> . Döndürülen karma tablosunda ayarın FUNCTIONS_EXTENSION_VERSION güncelleştirilmiş değerini doğrulayabilirsiniz.

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, ayarını ve diliniz ve sürümünüz için standart FUNCTIONS_EXTENSION_VERSION bir değer (gibi) linuxFxVersionkullanınPython|3.12. 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 16 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-node16

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

öğesini görüntülemek ve ayarlamak linuxFxVersioniç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 değerini işlev uygulamanızın adıyla değiştirin <function_app> . Ayrıca değerini işlev uygulamanızın kaynak grubunun adıyla değiştirin <my_resource_group> . geçerli değeri linuxFxVersion döndürülür.

• İşlev uygulamasındaki linuxFxVersion ayarı 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>
  

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

Önceki kod örneklerinde Cloud Shell'i Aç'ı seçerek bu komutları Azure Cloud Shell'den çalıştırabilirsiniz. Oturum açmak için yürüttkten 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

Çalışma zamanı sürümleri için sürüm notları