Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
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
- Создает образ локально или удаленно или определяет настроенный готовый образ.
- Публикует изображение в экземпляр ACR, настроенный для проекта, при необходимости публикации.
- Обновляет
linuxFxVersionприложения-функции доDOCKER|<image>. - Развертывается на главном сайте 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 в инфраструктуре | Настройте параметры приложения в инфраструктуре |