Развертывание в Функции Azure с помощью интерфейса командной строки разработчика Azure

Azure Developer CLI (azd) поддерживает развертывание кода и контейнеров для Функции Azure. Используйте выделенный function узел в azure.yaml для обоих режимов:

  • Развертывание кода упаковывает созданный код функции в zip-архив и отправляет его в Function App.
  • Развертывание контейнера создает или определяет образ контейнера, публикует его в Реестр контейнеров Azure (ACR) при необходимости и обновляет приложение-функцию для запуска образа.

Функции Azure и Служба приложений Azure используют поставщика ресурсов Microsoft.Web/sites, а их потоки развертывания контейнеров имеют некоторые общие внутренние механизмы. Однако это не один и тот же azd узел. Functions использует host: function, имеет специфическую для Functions упаковку и поведение удаленной сборки, а также не использует рабочий процесс слотов развертывания App Service.

Выберите режим развертывания

azd выбирает режим развертывания из конфигурации службы:

Конфигурация Режим развертывания
Источник project с поддерживаемым не-Docker language и без docker.path Развертывание кода
language: docker Развертывание контейнера
docker.path Значение с исходным языком Развертывание контейнера
Предварительно созданная image Развертывание контейнера

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

Развернуть код функции

Настройте службу функций на основе кода с исходным проектом, поддерживаемым языком программирования и host: function:

services:
  api:
    project: ./src/api
    language: ts
    host: function

Во время azdazd deploy собирает проект, применяет .funcignore исключения, создает zip-архив и отправляет пакет через API развертывания Функции Azure.

Bicep или Terraform должны подготовить приложение-функцию на основе кода и добавить тег azd-service-name со значением имени службы, если вы не определите ресурс с помощью resourceName в azure.yaml. Настройте план размещения, среду выполнения, хранилище, удостоверения, параметры сети и приложений с помощью инфраструктуры в качестве кода.

Настройка удаленных сборок для развертываний кода

Свойство службы remoteBuild верхнего уровня применяется только к приложениям-функций на основе кода в плане потребления Flex. Он определяет, использует ли Функции Azure Oryx для сборки загруженного пакета:

services:
  api:
    project: ./src/api
    language: python
    host: function
    remoteBuild: true

Если опустить remoteBuild в режиме Flex Consumption, azd выбирается значение по умолчанию на основе языка и содержимого пакета:

Language Поведение по умолчанию
JavaScript или TypeScript Использует удаленную сборку, когда .funcignore исключает node_modules, или когда файл .funcignore отсутствует. В противном случае используется локально созданный пакет.
Python Использует удаленную сборку.
Go Выполняет сборку локально. Function Apps Go не поддерживают удаленную сборку.
Другие поддерживаемые языки Использует локально созданный пакет.

Для JavaScript и TypeScript явно заданное значение remoteBuild должно совпадать с .funcignore, если этот файл существует. Установите remoteBuild: true, если .funcignore исключает node_modules. Установите remoteBuild: false, если .funcignore включает node_modules в пакет.

Не устанавливайте свойство remoteBuild верхнего уровня для планов, отличных от Flex. Чтобы включить сборку Oryx на другом поддерживаемом плане, настройте ENABLE_ORYX_BUILD=true и SCM_DO_BUILD_DURING_DEPLOYMENT=true в качестве параметров Function App в инфраструктуре.

Разверните контейнеризованную функцию

Для исходного проекта с Dockerfile, задайте language: dockerили сохраните исходный язык и укажите docker.path.

В следующем примере используется проект TypeScript с Dockerfile:

services:
  api:
    project: ./src/api
    language: ts
    host: function
    docker:
      path: ./Dockerfile

Вы также можете развернуть предварительно созданный образ без локального проекта:

services:
  api:
    host: function
    image: myregistry.azurecr.io/functions/api:1.0

Для предварительно созданного образа не указывайте language или задайте для него значение docker. Не сочетайте image с project.

Во время развертывания контейнера: azd

  1. Создает образ локально или удаленно или определяет настроенный готовый образ.
  2. Публикует изображение в экземпляр ACR, настроенный для проекта, при необходимости публикации.
  3. Обновляет linuxFxVersion приложения-функции до DOCKER|<image>.
  4. Развертывается на главном сайте Function App.

Свойство службы remoteBuild верхнего уровня не применяется к контейнерам. Чтобы собрать образ контейнера с помощью задач ACR, используйте docker.remoteBuild:

services:
  api:
    project: ./src/api
    language: docker
    host: function
    docker:
      path: ./Dockerfile
      remoteBuild: true

Подготовьте приложение-функцию, готовое к контейнеру

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

Requirement Сведения
Приложение-функция для Linux Создайте приложение-функцию Linux в плане Функции Azure Premium или выделенной (службы приложений). Flex Consumption не поддерживает пользовательские контейнеры. Этот host: function рабочий процесс предназначен для Microsoft.Web/sites, а не для Функции Azure, размещенных в Контейнеры приложений Azure.
Конфигурация сайта контейнеров Задайте тип сайта, включающий functionapp, linux и container. Инициализируйте linuxFxVersion значением DOCKER\|<image>. Достаточно изображения-заполнителя, так как azd deploy заменяет его.
Реестр контейнеров Для исходных сборок подготовьте экземпляр ACR и сделайте доступным его сервер входа в реестр через выходные данные инфраструктуры AZURE_CONTAINER_REGISTRY_ENDPOINT, или настройте docker.registry для службы. Полностью квалифицированную готовую сборку image можно использовать непосредственно без отдельного реестра для публикации.
Доступ к реестру Предоставьте идентификатору, который публикует образ, разрешение на отправку в целевой реестр, если требуется публикация. Отдельно настройте Function App для извлечения развернутого образа. Для частных образов ACR предоставьте управляемому удостоверению приложения-функции доступ на извлечение и настройте сайт для использования учетных данных управляемого удостоверения. Для другого частного реестра настройте соответствующие учетные данные для загрузки в своей инфраструктуре.
Параметры функции Настройте необходимые параметры, такие как FUNCTIONS_EXTENSION_VERSION, FUNCTIONS_WORKER_RUNTIMEи AzureWebJobsStorage с помощью Bicep или Terraform.
Обнаружение ресурсов Примените тег azd-service-name, значение которого соответствует имени службы в azure.yaml, или явно задайте resourceName.

Параметры уровня env обслуживания не поддерживаются для function узла. Вместо этого определите параметры Function App в инфраструктуре.

Понимание слотов развертывания

azd всегда развертывает function службу на основном сайте Function App. Не обнаруживает, не запрашивает и не развертывает слоты Function App. Параметры слота службы приложений, такие как AZD_DEPLOY_{SERVICE}_SLOT_NAME, не влияют на развертывание Function App Azure.

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

Сравнение Functions и узлов размещения App Service

Функции и служба приложений совместно используют тип ресурса Microsoft.Web/sites, но выберите хост, соответствующий рабочей нагрузке:

Behavior function хост appservice хост
Рабочая нагрузка Функции Azure на основе событий Веб-приложения и API
Развертывание кода Использует поток Функции Azure zip-развертывания Использует поток развертывания App Service
Развертывание контейнера Обновляет образ приложения-функции после проверки того, что сайт основан на контейнере Обновляет образ веб-приложения после проверки готовности сайта к работе в контейнере
Удаленная сборка кода Поддерживает параметр уровня remoteBuild службы для приложений-функций Flex Consumption Не используется параметр «Функции» remoteBuild
Слоты развертывания Всегда развертывается на главном сайте Поддерживает рабочий процесс слота App Service azd
Уровень обслуживания env Не поддерживается; используйте параметры Function App в инфраструктуре Настройте параметры приложения в инфраструктуре