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

Мақала
02/06/2024

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

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

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

Примечание.

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

Подготовка к обновлению

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

1. Проверка функций локально

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

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

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

Если вы используете предварительную версию, ознакомьтесь с рекомендациями по функциям для предварительной версии .NET , чтобы убедиться, что эта версия поддерживается. Дополнительные шаги могут потребоваться для предварительной версии .NET.
Обновите ссылки на последние версии: Microsoft.Azure.Functions.Worker и Microsoft.Azure.Functions.Worker.Sdk.
Обновите целевую платформу проекта до новой версии. Для проектов C# необходимо обновить <TargetFramework> элемент в .csproj файле. Сведения о конкретных платформах, связанных с выбранной версией, см . в разделе "Целевые платформы ".

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

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

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

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

Портал Azure
Azure CLI

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

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

Используйте эту 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, выполните следующие действия.

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию Java до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию .NET до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию Node.js до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить". Это изменение обновляет WEBSITE_NODE_DEFAULT_VERSION параметр приложения.

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию .NET до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

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

Примечание.

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

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию Java до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию .NET до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию Node.js до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить". Это изменение обновляет WEBSITE_NODE_DEFAULT_VERSION параметр приложения.

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию .NET до требуемой версии.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

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

В портал Azure найдите приложение-функцию и выберите "Конфигурация" слева. При использовании промежуточного слота сначала выберите конкретный слот.
На вкладке "Общие параметры" обновите версию Python до требуемой версии.

Примечание.

Вы не можете изменить версию Python при выполнении в плане потребления.
Нажмите кнопку "Сохранить " и при уведомлении о перезапуске нажмите кнопку "Продолжить".

Приложения 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"

В этом примере замените и <RESOURCE_GROUP> назовите <APP_NAME> приложение-функцию и группу ресурсов соответственно. Кроме того, замените <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"

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

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

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

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