Работа с контейнерами и Функции Azure

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

В этой статье демонстрируется поддержка, которая Функции Azure обеспечивает работу с приложениями-функциями, работающими в контейнерах Linux.

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

Если вы хотите перейти прямо в систему, в следующей статье показано, как создать первую функцию, запущенную в контейнере Linux, и развернуть образ из реестра контейнеров в поддерживаемой службе размещения Azure:

Создание первого контейнерного Функции Azure в приложениях контейнеров Azure

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

Создание первого контейнеризованного Функции Azure

Создание первого контейнерного Функции Azure в Azure Arc (предварительная версия)

Создание контейнерных приложений-функций

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

Внимание

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

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

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

Создание Файла Dockerfile

Средства функций предоставляют параметр Docker, который создает Dockerfile с проектом кода функций. Этот файл можно использовать с Docker для создания функций в контейнере, наследуемом от правильного базового образа (языка и версии).

Способ создания Файла Dockerfile зависит от способа создания проекта.

Командная строка

• При создании проекта "Функции" с помощью Функции Azure Основных инструментов включите --docker параметр при выполнении func init команды, как показано в следующем примере:

  func init --docker
  

• Вы также можете добавить Dockerfile в существующий проект с помощью --docker-only параметра при выполнении func init команды в существующей папке проекта, как показано в следующем примере:

  func init --docker-only
  

Полный пример см. в разделе "Создание приложения-функции" в локальном контейнере.

Visual Studio Code

Расширение Функции Azure для Visual Studio Code создает Dockerfile при создании проекта кода. Чтобы создать контейнерный проект кода, выполните следующее:

1. В Visual Studio Code нажмите клавишу F1 , чтобы открыть палитру команд и выполнить поиск и выполнить команду Azure Functions: Create New Containerized Project....

2. Выберите папку для нового проекта кода, нажмите кнопку "Выбрать" и следуйте остальным запросам.

3. После создания проекта можно открыть и просмотреть Dockerfile в корневой папке, выбранной для проекта.

Visual Studio

• При создании проекта "Функции" обязательно проверьте параметр "Включить Docker " на странице "Дополнительные сведения " диалогового окна нового проекта.

• Вы всегда можете добавить Dockerfile в существующий проект с помощью --docker-only параметра при выполнении func init команды в окнах терминала существующей папки проекта, как показано в следующем примере:

  func init --docker-only
  

Создание приложения-функции в контейнере

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

docker build --tag <DOCKER_ID>/<IMAGE_NAME>:v1.0.0 .

Пример создания контейнера см. в статье о сборке образа контейнера и локальной проверке.

Обновление образа в реестре

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

Реестр контейнеров Azure

az acr build --registry <REGISTRY_NAME> --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.1 .

Замените <REGISTRY_NAME> экземпляр реестра контейнеров и <LOGIN_SERVER> именем сервера входа.

Концентратор Docker

docker build --tag <DOCKER_ID> azurefunctionsimage:v1.0.1 .
docker push <DOCKER_ID> azurefunctionsimage:v1.0.1

Замените <DOCKER_ID> идентификатором вашей учетной записи Docker Hub.

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

Azure CLI

az functionapp config container set --image <IMAGE_NAME> --registry-password <SECURE_PASSWORD>--registry-username <USER_NAME> --name <APP_NAME> --resource-group <RESOURCE_GROUP>

В этом примере <IMAGE_NAME> полное имя нового образа с версией. Частные реестры требуют предоставления имени пользователя и пароля. Безопасно храните эти учетные данные.

Портал Azure

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

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

Указанная версия образа развертывается в приложении.

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

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

Указанная версия образа развертывается в приложении.

Кроме того, следует рассмотреть возможность непрерывного развертывания.

портал Azure создавать с помощью контейнеров

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

Ниже описано, как создать и развернуть существующее контейнерное приложение-функцию из реестра контейнеров.

1. На домашней странице или в меню портала Azure выберите Создать ресурс.

2. На странице Создать щелкните Вычислительные ресурсы>Приложение-функция.

3. В разделе "Выбор варианта размещения" выберите "Премиум", чтобы выбрать план>"Премиум".

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

4. На странице Основные сведения используйте параметры приложения-функции как указано в таблице ниже:

   Параметр	Предлагаемое значение	Description
   Подписка	Ваша подписка	Подписка, в которой создается приложение-функция.
   Группа ресурсов	myResourceGroup	Имя новой группы ресурсов, в которой создается приложение-функция. Необходимо создать группу ресурсов, так как при создании приложений-функций в существующей группе ресурсов существуют известные ограничения.
   Имя приложения-функции	Уникальное имя*	Имя, которое идентифицирует ваше новое приложение-функцию. Допустимые символы: a-z (без учета регистра), 0-9 и -.
   Вы хотите развернуть код или образ контейнера?	Образ контейнера	Разверните контейнерное приложение-функцию из реестра. Сведения о создании приложения-функции в реестре см. в статье "Создание приложения-функции" в локальном контейнере.
   Регион	Предпочтительный регион	Выберите регион, ближайший к вам или к другим службам, к которым могут обращаться функции.
   План Linux	Новый план (по умолчанию)	Создает новый план Premium для размещения приложения. Вы также можете выбрать существующий план уровня "Премиум".
   Тарифный план	Эластичный Премиум EP1	EP1 является самым доступным планом. Если вам нужно выбрать более крупный план.
   Избыточность между зонами	Выключено	Эта функция не нужна в непроизводном приложении.

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

5. Примите параметры по умолчанию для создания новой учетной записи хранения на вкладке хранилища и нового экземпляра Application Insights на вкладке "Мониторинг ". Вы также можете использовать существующую учетную запись хранения или экземпляр Application Insights.

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

7. На странице "Просмотр и создание" просмотрите параметры и выберите "Создать", чтобы подготовить приложение-функцию с помощью базового образа по умолчанию.

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

9. В центре развертывания вы можете подключить реестр контейнеров в качестве источника образа. Вы также можете включить GitHub Actions или Azure Pipelines для более надежного непрерывного развертывания обновлений в контейнере в реестре.

портал Azure создавать с помощью контейнеров

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

Ниже описано, как создать и развернуть существующее контейнерное приложение-функцию из реестра контейнеров.

1. На домашней странице или в меню портала Azure выберите Создать ресурс.

2. На странице Создать щелкните Вычислительные ресурсы>Приложение-функция.

3. В разделе "Выбор варианта размещения" выберите среду> "Приложения контейнеров".

4. На странице Основные сведения используйте параметры приложения-функции как указано в таблице ниже:

   Параметр	Предлагаемое значение	Description
   Подписка	Ваша подписка	Подписка, в которой создается приложение-функция.
   Группа ресурсов	myResourceGroup	Имя новой группы ресурсов, в которой создается приложение-функция. Необходимо создать группу ресурсов, так как при создании приложений-функций в существующей группе ресурсов существуют известные ограничения.
   Имя приложения-функции	Уникальное имя*	Имя, которое идентифицирует ваше новое приложение-функцию. Допустимые символы: a-z (без учета регистра), 0-9 и -.
   Регион	Предпочтительный регион	Выберите регион, ближайший к вам или к другим службам, к которым могут обращаться функции.

   ^*Имя приложения должно быть уникальным в среде приложений контейнеров Azure.

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

   Вы также можете использовать существующую среду приложений контейнеров. Чтобы создать настраиваемую среду, выберите "Создать". На странице "Создание среды приложений контейнеров" можно добавить профили рабочих нагрузок, отличные от стандартных рабочих нагрузок, или включить избыточность зоны. Дополнительные сведения о средах см . в средах azure Container Apps.

6. Выберите вкладку "Развертывание" и снимите флажок "Использовать образ быстрого запуска". В противном случае приложение-функция развертывается из базового образа для языка приложения-функции.

7. Выберите тип изображения, общедоступный или закрытый. Выберите private, если вы используете Реестр контейнеров Azure или другой частный реестр. Укажите имя образа, включая префикс реестра. Если вы используете частный реестр, укажите учетные данные проверки подлинности реестра образов. Общедоступный параметр поддерживает только изображения, хранящиеся публично в Docker Hub.

8. В разделе "Выделение ресурсов контейнера" выберите требуемое количество ядер ЦП и доступной памяти. Если в вашей среде добавлены другие профили рабочей нагрузки, можно выбрать профиль рабочей нагрузки, отличный от него. Выбор на этой странице влияет на стоимость размещения приложения. Ознакомьтесь со страницей цен на приложения-контейнеры , чтобы оценить потенциальные затраты.

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

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

Работа с изображениями в Функции Azure

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

Azure CLI

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

• az functionapp config container show: возвращает сведения о образе, используемом для развертывания.

• az functionapp config container set: измените параметры реестра или обновите образ, используемый для развертывания, как показано в предыдущем примере.

Портал Azure

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

2. В разделе "Параметры образа" можно просмотреть сведения о развернутом в данный момент образе или изменить развертывание на другой образ. Вы также можете изменить параметры выделения среды контейнера.

3. Чтобы внести обновления, измените любой из параметров образа, например тег изображения или параметры выделения среды контейнера, и нажмите кнопку "Сохранить".

На основе изменений создается новый образ в приложении или новые выделения.

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

2. В разделе "Параметры" выберите реестр контейнеров для источника и просмотрите сведения о развернутом образе.

3. Чтобы сделать обновления, измените любой из параметров изображения, например полное имя изображения и тег , а затем нажмите кнопку "Сохранить".

Новый образ развертывается в приложении на основе новых параметров.

Профили рабочей нагрузки приложений контейнеров

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

Вы также можете задать объем ресурсов ЦП и памяти, выделенных вашему приложению.

Вы можете создавать профили рабочей нагрузки и выделения ресурсов и управлять ими с помощью Azure CLI или в портал Azure.

Azure CLI

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

В среде можно добавлять, изменять и удалять профили. Пример см. в разделе "Добавление профилей".

При создании контейнерного приложения-функции в среде с включенными профилями рабочей нагрузки также следует указать профиль, в котором выполняется выполнение. Профиль указывается с помощью --workload-profile-name параметра az functionapp create команды, как в следующем примере:

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime <LANGUAGE_STACK> --image <IMAGE_URI> --workload-profile-name <PROFILE_NAME> --cpu <CPU_COUNT> --memory <MEMORY_SIZE> 

В команде az functionapp create параметр указывает среду "Приложения контейнеров", --environment а --image параметр указывает образ, используемый для приложения-функции. В следующем примере замените <STORAGE_NAME> именем, использованным в предыдущем разделе для учетной записи хранения. Кроме того, замените <APP_NAME> глобально уникальное имя, соответствующее вам.

Чтобы задать ресурсы, выделенные вашему приложению, замените <CPU_COUNT> требуемым количеством виртуальных ЦП не менее 0,5 до максимального допустимого профиля. Для <MEMORY_SIZE>этого выберите объем выделенной памяти от 1 ГБ до максимального допустимого профиля.

С помощью az functionapp container set команды можно управлять выделенными ресурсами и профилем рабочей нагрузки, используемыми приложением.

az functionapp container set --name <APP_NAME> --resource-group AzureFunctionsContainers-rg --workload-profile-name  <PROFILE_NAME> --cpu <CPU_COUNT> --memory <MEMORY_SIZE> 

Портал Azure

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

В среде можно добавлять, изменять и удалять профили. Пример см. в разделе "Добавление профилей".

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

Параметры приложения

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

Включение непрерывного развертывания в Azure

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

• Azure Pipelines
• GitHub Actions

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

Включение непрерывного развертывания в Azure

Внимание

Развертывание на основе веб-перехватчика в настоящее время не поддерживается при запуске контейнера в плане Elastic Premium. Если необходимо использовать метод непрерывного развертывания, описанный в этом разделе, вместо этого разверните контейнер в плане Служба приложений. При запуске в плане Elastic Premium необходимо вручную перезапустить приложение при каждом обновлении контейнера в репозитории.

Вы также можете настроить непрерывное развертывание из репозитория исходного кода с помощью Azure Pipelines или GitHub Actions.

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

1. Используйте следующую команду, чтобы включить непрерывное развертывание и получить URL-адрес веб-перехватчика:

   Azure CLI

   az functionapp deployment container config --enable-cd --query CI_CD_URL --output tsv --name <APP_NAME> --resource-group AzureFunctionsContainers-rg
   

   Команда az functionapp deployment container config включает непрерывное развертывание и возвращает URL-адрес веб-перехватчика развертывания. Этот URL-адрес можно получить в любое время с помощью az functionapp deployment container show-cd-url команды.

   Azure PowerShell

   Update-AzFunctionAppSetting -Name <APP_NAME> -ResourceGroupName AzureFunctionsContainers-rg -AppSetting @{"DOCKER_ENABLE_CI" = "true"}
   Get-AzWebAppContainerContinuousDeploymentUrl -Name <APP_NAME> -ResourceGroupName AzureFunctionsContainers-rg
   

   Параметр приложения DOCKER_ENABLE_CI определяет, включено ли непрерывное развертывание из репозитория контейнеров. Командлет Get-AzWebAppContainerContinuousDeploymentUrl возвращает URL-адрес веб-перехватчика развертывания.

   Как и ранее, необходимо заменить <APP_NAME> на имя приложения-функции.

2. Скопируйте URL-адрес веб-перехватчика развертывания в буфер обмена.

3. Откройте Docker Hub, войдите и выберите Репозитории на панели навигации. Найдите и выберите образ, перейдите на вкладку Веб-перехватчики, укажите имя веб-перехватчика, вставьте URL-адрес в поле URL-адрес веб перехватчика, а затем выберите Создать.

   

4. С помощью набора веб-перехватчика служба Функции Azure повторно развертывает образ при каждом обновлении в Docker Hub.

Включение SSH-подключений

SSH обеспечивает безопасный обмен данными между клиентом и контейнером. При включенном протоколе SSH вы можете подключиться к контейнеру с помощью расширенных инструментов Службы приложений (KUDU). Чтобы упростить подключение к контейнеру по SSH, служба "Функции Azure" предоставляет базовый образ, в котором уже включен протокол SSH. Вам необходимо только изменить Dockerfile, а затем перестроить и повторно развернуть образ. Затем вы можете подключиться к контейнеру с помощью Дополнительных инструментов (Kudu).

1. В Dockerfile добавьте строку -appservice к базовому изображению в FROM инструкции, как показано в следующем примере:

   FROM mcr.microsoft.com/azure-functions/node:4-node18-appservice
   

   В этом примере используется версия SSH базового образа Node.js версии 18. Посетите репозиторий базовых образов Функции Azure, чтобы убедиться, что вы используете последнюю версию базового образа с поддержкой SSH.

2. Перестройте образ с помощью docker build команды, замените <DOCKER_ID> идентификатор учетной записи Docker Hub, как показано в следующем примере.

   docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
   

3. Отправьте обновленный образ в Docker Hub (это должно занять значительно меньше времени, чем первая принудительная отправка). Так будут отправлены только обновленные сегменты образа.

   docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0
   

4. Функции Azure автоматически повторно развертывает образ в приложении-функции; процесс выполняется менее чем за минуту.

5. В браузере откройте https://<app_name>.scm.azurewebsites.net/, заменив <app_name> уникальным именем. Это URL-адрес конечной точки Дополнительных инструментов (Kudu) для контейнера приложения-функции.

6. Войдите в свою учетную запись Azure, а затем выберите вкладку SSH, чтобы создать подключение к контейнеру. Если Azure все еще обновляет образ контейнера, подключение может занять некоторое время.

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

   

Связанные статьи

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

• Размещение Функции Azure приложений контейнеров Azure
• Azure Functions scale and hosting (Масштабирование и размещение Функций Azure)
• Azure Functions on Kubernetes with KEDA (Функции Azure на базе Kubernetes с KEDA)