Обновление версий стека языков в Функции Azure

В Функциях Azure поддержка языкового стека ограничена определенными версиями. По мере того как новые версии становятся доступными, вы можете обновить приложения, чтобы воспользоваться преимуществами своих функций. Поддержка функций также может прекращаться для более старых версий, обычно согласованных со сроками окончания поддержки сообщества. Дополнительные сведения см. в политике поддержки среды выполнения языка.

Чтобы ваши приложения продолжали получать поддержку, следуйте инструкциям в этой статье, чтобы обновить их до последних доступных версий. Способ обновления приложения-функции зависит от:

• Язык, используемый для создания функций. Обязательно выберите язык программирования в верхней части этой статьи.
• Операционная система, в которой работает ваше приложение в Azure: Windows или Linux.
• План размещения.

Примечание.

В этой статье показано, как обновить версию приложения .NET с помощью изолированной рабочей модели. Приложения, которые работают в более ранних версиях .NET с моделью внутрипроцессного процесса , могут обновляться до целевой платформы .NET 8 или переноситься из модели внутрипроцессной в изолированную рабочую модель.

Предпосылки

Перед обновлением конфигурации стека для приложения-функции в Azure выполните следующие задачи:

Проверьте функции локально

Проверьте и проверьте код функции локально в новой целевой версии.

Чтобы обновить проект на локальном компьютере, выполните следующие действия.

1. Убедитесь , что вы установили целевую версию пакета SDK для .NET.

   Если вы используете предварительную версию, ознакомьтесь с рекомендациями по функциям для предварительной версии .NET, чтобы убедиться, что эта версия поддерживается. Для использования предварительных версий .NET могут потребоваться дополнительные действия.

2. Обновите ссылки на последние версии Microsoft.Azure.Functions.Worker и Microsoft.Azure.Functions.Worker.Sdk.

3. Обновите целевую платформу проекта до новой версии. Для проектов C# необходимо обновить <TargetFramework> элемент в .csproj файле. Дополнительные сведения о вашей версии см. в разделе "Целевые платформы".

   Изменение целевой платформы проекта также может потребовать изменений в частях цепочки инструментов за пределами кода проекта. Например, в Visual Studio Code может потребоваться обновить настройку расширения azureFunctions.deploySubpath с помощью пользовательских параметров или файла вашего проекта .vscode/settings.json. Проверьте наличие зависимостей от версии платформы, существующей вне кода проекта, в рамках шагов сборки или конвейера CI/CD.

4. Внесите все обновления в код проекта, необходимый новой версии .NET. Проверьте заметки о выпуске версии для конкретных особенностей. Помощник по обновлению .NET также позволяет обновить код в ответ на изменения в основных версиях.

После внесения этих изменений перестройте проект и протестируйте его, чтобы убедиться, что приложение работает должным образом.

Переход к последней среде выполнения функций

Убедитесь, что приложение-функция работает в последней версии среды выполнения функций (версия 4.x). Вы можете определить версию среды выполнения в портал Azure или с помощью Azure CLI.

Портал Azure

Чтобы определить версию среды выполнения функций, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>".

2. Перейдите на вкладку "Параметры среды выполнения функции " и проверьте значение версии среды выполнения . Приложение-функция должно работать в среде выполнения функций версии 4.x (~4).

   

Azure CLI

Используйте команду az functionapp config appsettings list , чтобы проверить версию среды выполнения:

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"  

Параметр FUNCTIONS_EXTENSION_VERSION задает версию среды выполнения. Значение ~4 означает, что приложение-функция уже работает на последней дополнительной версии последней основной версии (4.x).

Если необходимо сначала обновить приложение-функцию до версии 4.x, см. статью "Миграция приложений с Функции Azure версии 1.x на версию 4.x" или "Миграция приложений из Функции Azure версии 3.x на версию 4.x". Следуйте инструкциям в этих статьях, а не просто измените параметр FUNCTIONS_EXTENSION_VERSION.

Публикация обновлений приложений

Если вы обновили приложение, чтобы правильно работать в новой версии, опубликуйте обновления приложения перед обновлением конфигурации стека для приложения-функции.

Совет

Чтобы упростить процесс обновления, свести к минимуму время простоя для функций и предоставить возможность отката, следует опубликовать обновленное приложение в промежуточном слоте. Дополнительные сведения см. в разделе Функции Azure слотов развертывания.

При публикации обновленного приложения в промежуточный слот обязательно следуйте инструкциям по обновлению для конкретного слота в остальной части этой статьи. Позже вы переключите обновленный промежуточный слот в рабочую среду.

Обновление конфигурации стека

Способ обновления конфигурации стека зависит от того, работаете ли вы в Windows или Linux в Azure.

При использовании промежуточного слота обязательно направляйте обновления в нужный слот.

Виндоус

Чтобы обновить версию Java, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть тестовый слот, выберите нужный слот.

2. На вкладке "Общие параметры" обновите версию Java до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Чтобы обновить версию .NET, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть инсценировочный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию .NET до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Чтобы обновить версию Node.js, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть промежуточный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию Node.js до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить". Это изменение обновляет WEBSITE_NODE_DEFAULT_VERSION параметр приложения.

Чтобы обновить версию PowerShell, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть промежуточный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию .NET до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Приложения Python не поддерживаются в Windows. Выберите вкладку Linux .

Линукс

Примечание.

Вы можете использовать только портал Azure для обновления приложений-функций в Linux, размещенных в плане Premium или выделенном (Служба приложений) плане. Для приложений в Linux, размещенных в плане потребления, используйте Azure CLI.

Чтобы обновить версию Java, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть промежуточный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию Java до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Чтобы обновить версию .NET, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть промежуточный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию .NET до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Чтобы обновить версию Node.js, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть промежуточный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию Node.js до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить". Это изменение обновляет WEBSITE_NODE_DEFAULT_VERSION параметр приложения.

Чтобы обновить версию PowerShell, выполните следующие действия.

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть промежуточный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию .NET до требуемой версии.

   

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Приложения Python не поддерживаются в Windows. Выберите вкладку Linux .

1. На портале Azure найдите и выберите приложение-функцию. В меню слева выберите "Конфигурация параметров>". Если у вас есть промежуточный слот, выберите конкретный слот.

2. На вкладке "Общие параметры" обновите версию Python до требуемой версии.

   

   Примечание.

   Вы не можете изменить версию Python при выполнении в плане потребления.

3. Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Виндоус

Приложения Python не поддерживаются в Windows. Выберите вкладку Linux .

Выполните команду az functionapp list-runtimes , чтобы просмотреть поддерживаемые значения версий для вашего языка. Затем выполните команду az functionapp config set , чтобы обновить языковую версию приложения-функции:

Выполните команду az functionapp list-runtimes , чтобы просмотреть поддерживаемые значения версий для .NET в изолированной рабочей модели:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

Выполните команду az functionapp config set, чтобы обновить версию .NET вашего приложения-функции.

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

Используйте команду az functionapp list-runtimes для просмотра поддерживаемых значений версий для стека языка (Node.js). Затем выполните команду az functionapp config set, чтобы обновить версию вашего приложения-функции Node.js:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"  

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

В этом примере замените и <APP_NAME> назовите <RESOURCE_GROUP> приложение-функцию и группу ресурсов соответственно. Кроме того, замените <VERSION> поддерживаемую языковую версию, на которую выполняется обновление. Если вы не используете промежуточный слот, удалите --slot этот параметр.

Линукс

Примечание.

Вы не можете изменить версию Python при выполнении в плане потребления.

Выполните команду az functionapp list-runtimes , чтобы просмотреть поддерживаемый параметр сайта linuxFxVersion для версии языка:

Выполните команду az functionapp list-runtimes, чтобы просмотреть поддерживаемый параметр сайта linuxFxVersion для версии стека языка.

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

Выполните команду az functionapp config set , чтобы обновить параметр сайта для новой языковой версии приложения-функции:

Выполните команду az functionapp config set, чтобы обновить настройку сайта для нового стека вашего приложения функций.

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

В этом примере замените и <APP_NAME> назовите <RESOURCE_GROUP> приложение-функцию и группу ресурсов соответственно. Кроме того, замените <LANGUAGE|VERSION>linuxFxVersion его на обновление. Если вы не используете промежуточный слот, удалите --slot этот параметр.

Приложение-функция перезапускается после обновления версии.

Переключение слотов

Если вы выполнили развертывание и обновление параметров проекта кода в промежуточном слоте, переключите промежуточный слот в рабочую среду. Дополнительные сведения см. в разделе "Переключение слотов".

Связанный контент

Руководство разработчика Java

Руководство по изолированному рабочему процессу C#

руководство разработчика Node.js

Руководство разработчика Python

Руководство разработчика PowerShell