Технологии развертывания в Azure Functions

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

Методы развертывания

Технология развертывания, используемая для публикации кода в приложении-функции в Azure, зависит от конкретных потребностей и точки в цикле разработки. Например, во время разработки и тестирования можно развертывать непосредственно с помощью средства разработки, такого как Visual Studio Code. Когда приложение работает в рабочей среде, вы, скорее всего, будете постоянно публиковать данные из системы управления версиями или с помощью конвейера автоматической публикации, который может включать проверку и тестирование.

В следующей таблице описаны доступные методы развертывания для проекта кода.

Используйте лучшую технологию для конкретного сценария. Многие методы развертывания основаны на zip-развертывании, которое рекомендуется для развертывания.

Доступность технологии развертывания

Метод развертывания также зависит от плана размещения и операционной системы, на которой выполняется ваше приложение функции.

В настоящее время Функции предлагают пять вариантов размещения приложений-функций:

• План потребления Flex
• План Elastic Premium
• План категории "Выделенный" (Служба приложений)
• Приложения контейнеров Azure
• План потребления (устаревшая версия)

Каждый план имеет разные особенности. Не все технологии развертывания доступны для каждого плана размещения и операционной системы. Эта диаграмма содержит сведения о поддерживаемых технологиях развертывания:

¹ Технологии развертывания, требующие ручной синхронизации триггеров , не рекомендуется.
² Редактирование на портале отключено при развертывании кода в приложении-функции за пределами портала. Дополнительные сведения, включая сведения о поддержке языка для редактирования на портале, см . в разделе "Сведения о поддержке языка".

Основные понятия

Некоторые ключевые понятия, важные для понимания работы развертываний в Функциях Azure.

Синхронизация триггеров

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

При использовании этих параметров развертывания всегда необходимо синхронизировать триггеры вручную:

• URL-адрес внешнего пакета
• Локальный репозиторий Git
• FTPS

Триггеры синхронизации можно синхронизировать вручную одним из следующих способов:

• Перезапустите функциональное приложение в портале Azure. Хост функций выполняет фоновую синхронизацию триггера после запуска приложения.

• az rest Используйте команду для отправки HTTP-запроса POST, вызывающего syncfunctiontriggers API, как в следующем примере:

  az rest --method post --url https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.Web/sites/<APP_NAME>/syncfunctiontriggers?api-version=2016-08-01
  

Имейте в виду эти рекомендации для операции триггеров синхронизации:

• Вы должны вручную перезапустить функциональное приложение каждый раз при развертывании обновленной версии пакета развертывания с использованием того же URL-адреса внешнего пакета.
• Для приложений, работающих в плане "Потребление" или "Эластичные премиум", необходимо также вручную синхронизировать триггеры в следующих сценариях:
  • При развертывании используется URL-адрес внешнего пакета с развертыванием на основе диспетчера ресурсов с помощью шаблонов ARM или Bicep или Terraform-файлов.
  • При обновлении пакета развертывания на месте, используя тот же URL внешнего пакета.
• При добавлении сетевых ограничений в существующее функциональное приложение необходимо обеспечить подключение к учетной записи хранения узла по умолчанию, установленной в параметре приложения AzureWebJobsStorage. Дополнительные сведения см. в статье "Использование защищенной учетной записи хранения с функциями Azure".

Удаленная сборка

Во время развертывания можно запросить Функции Azure выполнить удаленную сборку проекта кода. В этих сценариях запросите удаленную сборку вместо локального создания:

• Вы развертываете приложение в функциональном приложении на основе Linux, разработанного на компьютере с Windows. Эта ситуация обычно относится к разработке приложений Python. При сборке пакета развертывания локально в Windows можно получить неправильные библиотеки.
• Ваш проект имеет зависимости от индекса пользовательских пакетов.
• Вы хотите уменьшить размер пакета развертывания.

Запрос удаленной сборки зависит от того, работает ли ваше приложение в Azure в Windows или Linux.

При использовании удаленных сборок во время развертывания применяются следующие рекомендации.

• Удаленные сборки поддерживаются для функциональных приложений, работающих на Linux в тарифе Consumption. Однако варианты развертывания ограничены для этих приложений, так как у них нет scm сайта Kudu.
• Функциональные приложения, работающие на Linux в плане "Премиум" или в выделенном (Служба приложений) плане, имеют scm сайт (Kudu), но он ограничен по сравнению с Windows.
• Удаленные сборки не происходят, когда приложение использует запуск из пакета. Чтобы узнать, как использовать удаленную сборку в этих случаях, см. Zip deploy.
• У вас могут возникнуть проблемы с удаленной сборкой, когда приложение было создано до того, как эта функция была доступна (1 августа 2019 г.). Для старых приложений создайте новое приложение-функцию или запустите az functionapp update --resource-group <RESOURCE_GROUP_NAME> --name <APP_NAME> для обновления приложения-функции. Для выполнения этой команды может потребоваться две попытки.

Хранилище содержимого приложения

Методы развертывания на основе пакетов хранят пакет в учетной записи хранения, связанной с приложением-функцией, которое определяет параметр AzureWebJobsStorage . При наличии приложения тарифного плана "Потребление и Эластичная Премиум" стараются использовать общий доступ к содержимому файлов Azure из этой учетной записи, но пакет также можно хранить в другом месте. Приложения плана потребления Flex используют контейнер хранилища в учетной записи хранения по умолчанию, если для развертывания не настроена другая учетная запись хранения. Для получения дополнительной информации ознакомьтесь с разделом "Где содержимое приложения хранится в каждой технологии развертывания", которые рассматриваются в следующем разделе.

Подробное описание технологии развертывания

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

Одно развертывание

Технология единого развертывания — это единственная технология развертывания, поддерживаемая для приложений в плане потребления Flex. Конечный результат — это готовый пакет .zip, на котором работает приложение-функция.

Как использовать его: Развертывание с помощью функции публикации Visual Studio Code или из командной строки с помощью основных средств Функций Azure или Azure CLI. Задача Azure Dev Ops и действия GitHub аналогично используют одно развертывание при обнаружении, что приложение Flex Consumption развертывается.

При создании приложения Flex Consumption необходимо указать контейнер для хранения объектов blob для развертывания, а также метод аутентификации к нему. По умолчанию используется та же учетная запись хранения, что и AzureWebJobsStorage подключение, с использованием строки подключения в качестве метода проверки подлинности. Таким образом, параметры развертывания настраиваются во время создания приложения без каких-либо параметров приложения.

Когда его следует использовать: Одно развертывание — это единственная технология развертывания, доступная для приложений-функций, работающих в плане потребления Flex.

Где хранится содержимое приложения: при создании приложения-функции Flex Consumption необходимо указать контейнер хранилища развертывания. В этом контейнере блобов ваши инструменты загружают контент приложения, который вы развернули. Чтобы изменить расположение, перейдите в колонку "Параметры развертывания" в портал Azure или с помощью Azure CLI.

Развертывание из ZIP-файла

Zip-развертывание — это стандартная и рекомендуемая технология развертывания для приложений-функций в планах Потребление, Эластичный Premium и Служба приложений (выделенные). Конечный результат — это готовый пакет .zip, на котором работает приложение-функция. Он отличается от URL-адреса внешнего пакета в том, что платформа отвечает за удаленное построение и хранение содержимого приложения.

Практическое руководство. Развертывание с помощью любимого клиентского средства: Visual Studio Code, Visual Studio или из командной строки с помощью Функции Azure основных средств или Azure CLI. Задача Azure Dev Ops и GitHub Action аналогично используют zip-развертывание.

При развертывании из ZIP-файла можно настроить приложение для запуска из пакета. Для выполнения запуска из пакета необходимо установить параметр приложения WEBSITE_RUN_FROM_PACKAGE в значение 1. Рекомендуется использовать развертывание из ZIP-файла. Это позволяет ускорить загрузку приложений, и это метод по умолчанию для VS Code, Visual Studio и Azure CLI.

Когда использовать: Zip-развертывание — это стандартная и рекомендуемая технология развертывания для приложений-функций в планах потребления Windows, Windows и Linux Elastic Premium, а также в планах Windows и Linux App Service (Выделенные).

Где хранится содержимое приложения: Содержимое приложения из ZIP-развертывания по умолчанию хранится в файловой системе, которую Azure может поддержать с помощью файлов Azure из учетной записи хранения, указанной при создании приложения-функции. В среде потребления Linux содержимое приложения сохраняется в блобе в учетной записи хранения, указанной с помощью AzureWebJobsStorage параметра приложения, а параметр WEBSITE_RUN_FROM_PACKAGE приложения принимает значение URL-адреса блоба.

URL-адрес внешнего пакета

URL-адрес внешнего пакета — это параметр, если вы хотите вручную управлять выполнением развертываний. Вы несете ответственность за загрузку готового для запуска пакета .zip, содержащего построенное содержимое приложения в хранилище BLOB-объектов и использование этого внешнего URL-адреса в качестве настройки приложения в вашем приложении-функции. При перезапуске приложения он извлекает пакет, подключает его и запускается в режиме запуска из пакета .

Как использовать. Добавьте WEBSITE_RUN_FROM_PACKAGE в параметры приложения. Значение этого параметра должно быть URL-адресом blob, указывающим на расположение конкретного пакета, который нужно запустить в приложении. Параметры можно добавить либо на портале, либо с использованием Azure CLI.

Если вы используете Хранилище BLOB-объектов Azure, приложение-функция может получить доступ к контейнеру с помощью подключения на основе управляемой идентификации или подписанного общего ключа доступа (SAS). Выбор параметра влияет на тип URL-адреса, который вы используете в качестве значения для WEBSITE_RUN_FROM_PACKAGE. Управляемое удостоверение рекомендуется для общей безопасности, так как срок действия маркеров SAS истекает и должен поддерживаться вручную.

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

Когда его использовать: URL-адрес внешнего пакета является единственным поддерживаемым методом развертывания для приложений, работающих в плане потребления Linux, если вы не хотите выполнять удаленную сборку . Этот метод также является рекомендуемой технологией развертывания при создании приложения без Файлы Azure. Для масштабируемых приложений, работающих на Linux, следует рассмотреть размещение на тарифном плане Flex Consumption.

Где хранится содержимое приложения: вы несете ответственность за загрузку содержимого вашего приложения в хранилище объектов BLOB. Вы можете использовать любое хранилище BLOB-объектов, хотя рекомендуется Хранилище BLOB-объектов Azure.

Контейнер Docker

Вы можете развернуть функциональное приложение, запущенное в контейнере Linux.

Как использовать:Создайте функции в контейнере Linux, а затем разверните контейнер на тарифном плане 'Премиум' или 'Выделенный' в Azure Functions или у другого провайдера контейнеров. Используйте инструменты Azure Functions Core для создания настраиваемого файла Dockerfile для вашего проекта, чтобы создать функциональное приложение в контейнере. Контейнер можно использовать в следующих развертываниях:

• Развертывание в Функции Azure ресурсов, которые вы создаете в портале Azure. Для получения дополнительной информации см. создание в Azure Portal с использованием контейнеров.
• Развертывайте на Azure Functions ресурсы, создаваемые из командной строки. Требуется план "Премиум" или "Выделенный" (план Службы приложений). Дополнительные сведения см. в статье Создание первых контейнеризованных функций Azure.
• Развертывание в приложениях контейнеров Azure. Чтобы узнать, как это сделать, см. Создание первой контейнеризованной функции Azure в Azure Container Apps.
• Развертывание в кластере Kubernetes. Вы можете развернуть в кластер, используя Основные инструменты Azure Functions. Используйте команду func kubernetes deploy.

Когда его использовать: используйте параметр контейнера Docker, если требуется более контроль над средой Linux, в которой выполняется приложение-функция и где размещен контейнер. Этот механизм развертывания доступен только для функций, работающих в Linux.

Где хранится содержимое приложения: Содержимое приложения хранится в указанном реестре контейнеров в составе образа.

Управление исходным кодом

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

Практическое руководство. Самый простой способ настройки публикации из системы управления версиями — из Центра развертывания в области "Функции" портала. Дополнительные сведения см. в статье Непрерывное развертывание для функций Azure.

Когда использовать: Использование системы управления версиями — это лучшая методика для команд, которые совместно работают над функциональными приложениями. Контроль версий — хороший вариант развертывания, который позволяет использовать более сложные конвейеры развертывания. Обычно вы включаете систему управления версиями в промежуточном слоте, который можно переключить в продакшн после проверки обновлений из репозитория. Дополнительные сведения см. в разделе слоты развертывания Azure Functions.

Где хранится содержимое приложения: Система контроля версий хранит содержимое приложения. Файловая система приложения сохраняет локально клонированное и построенное содержимое приложения, которое может поддерживаться файлами Azure из учетной записи хранения, указанной при создании приложения-функции.

Локальный репозиторий Git

Используйте локальный Git для отправки кода с локального компьютера в Функции Azure с помощью Git.

Как использовать. Следуйте инструкциям в статье Развертывание локального репозитория Git в Службе приложений Azure.

Когда его следует использовать: Чтобы снизить вероятность ошибок, не используйте методы развертывания, требующие дополнительного шага синхронизации триггеров вручную. Используйте zip-развертывание по возможности.

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

FTP/S

Вы можете использовать FTP/S для прямого передачи файлов в Функции Azure, но не используйте этот метод развертывания. Если вы не планируете использовать FTP, отключите его. Если вы решили использовать FTP, примените FTPS. Чтобы узнать, как это сделать в портале Azure, см. раздел Принудительное применение FTPS.

Как использовать его: Следуйте инструкциям в параметрах развертывания FTPS , чтобы получить URL-адрес и учетные данные, которые можно использовать для развертывания в приложении-функции с помощью FTPS.

Когда его следует использовать: Чтобы снизить вероятность ошибок, не используйте методы развертывания, требующие дополнительного шага синхронизации триггеров вручную. Используйте ZIP-развертывание по возможности.

Где хранится содержимое приложения: Содержимое приложения хранится в файловой системе. Развертывания FTP/FTPS завершаются сбоем, если файловая система вашего приложения поддерживается файлами Azure в учетной записи хранения узла по умолчанию. FTP/FTPS завершается сбоем при использовании файлов Azure в качестве подключенного хранилища из-за ограничений FTP.

Редактирование на портале

В редакторе на портале вы можете непосредственно изменять файлы, которые находятся в вашем функциональном приложении (по сути, каждый раз развёртывая заново при сохранении изменений).

Как использовать его: Чтобы изменить функции на портале Azure, необходимо создать свои функции на портале. С целью сохранения единого источника достоверного кода, использование любого другого метода развертывания сделает функцию доступной только для чтения и не позволит продолжить редактирование на портале. Чтобы вернуться к состоянию, в котором вы можете редактировать файлы в портале Azure, можно вручную включить режим редактирования в Read/Write и удалить все параметры приложения, связанные с развертыванием (например, WEBSITE_RUN_FROM_PACKAGE).

Когда использовать. Портал — хороший способ начать работу с Функциями Azure. Из-за ограничений разработки на портале Azure следует использовать один из следующих клиентских средств для более расширенной работы по разработке:

• Visual Studio Code
• Azure Functions Core Tools (командная строка)
• Visual Studio

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

Поведение развертывания

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

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

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

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

Слоты развертывания

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

Способ развертывания в слоте зависит от используемого средства развертывания. Например, при использовании основных средств Функций Azure можно указать --slot имя определенного слота для func azure functionapp publish команды.

Дополнительные сведения о слотах развертывания см. в документации по слотам развертывания функций Azure .

Следующие шаги

Ознакомьтесь со следующими статьями, чтобы узнать больше о развертывании приложений-функций.

• Непрерывное развертывание для функций Azure
• Непрерывная доставка с помощью Azure Pipelines
• ZIP-развертывания для Функций Azure
• Запуск Функции Azure из файла пакета
• Автоматизация развертывания ресурсов для вашего приложения в Azure Functions
• Настройка развертываний с нулевым временем простоя в Flex Consumption