Поделиться через


Создание функции, активируемой хранилищем очередей Azure

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

Примечание.

Редактирование на портале поддерживается только для функций скрипта JavaScript, PowerShell и C#. Редактирование Python на портале поддерживается только при выполнении в плане потребления. По возможности следует разрабатывать функции локально.

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

Необходимые компоненты

  • Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начать работу.

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

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

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

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

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

    Параметр Предлагаемое значение Description
    Подписка Ваша подписка Подписка, в которой создается новое приложение-функцию.
    Группа ресурсов myResourceGroup Имя новой группы ресурсов, в которой создается приложение-функция. Необходимо создать новую группу ресурсов, так как при создании приложений-функций в существующей группе ресурсов существуют известные ограничения.
    Имя приложения-функции Глобально уникальное имя Имя, которое идентифицирует ваше новое приложение-функцию. Допустимые символы: a-z (без учета регистра), 0-9 и -.
    Стек среды выполнения Предпочитаемый язык Выберите среду выполнения, которая поддерживает нужный функциональный язык программирования. Редактирование на портале доступно только для скрипта JavaScript, PowerShell, Python, TypeScript и C#. Библиотека классов C# и функции Java должны быть разработаны локально.
    Версия Номер версии Выберите версию установленной среды выполнения.
    Регион Предпочтительный регион Выберите регион, ближайший к вам или к другим службам, к которым могут обращаться функции.
    Операционная система Windows Операционная система предварительно выбирается на основе выбора стека среды выполнения, но при необходимости можно изменить этот параметр. Редактирование на портале поддерживается только в Windows.
  5. Примите параметры по умолчанию на оставшихся вкладках, включая поведение по умолчанию для создания новой учетной записи хранения на вкладке служба хранилища и нового экземпляра Application Insights на вкладке "Мониторинг". Вы также можете использовать существующую учетную запись хранения или экземпляр приложения Аналитика.

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

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

  8. Выберите Перейти к ресурсу для просмотра нового приложения-функции. Можно также установить флажок Закрепить на панели мониторинга. Это упростит возвращение к этому ресурсу приложения-функции из панели мониторинга.

    Снимок экрана: уведомление о развертывании.

Приложение-функция успешно создана.

Затем создайте функцию в новом приложении-функции.

Создание функции, активируемой очередью

  1. В приложении-функции выберите "Обзор" и нажмите кнопку "Создать " в разделе "Функции".

  2. В разделе "Выбор шаблона" прокрутите вниз и выберите шаблон триггера очереди Azure служба хранилища.

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

    Параметр Предлагаемое значение Описание:
    Имя Уникальное для вашего приложения-функции Имя функции, активируемой очередью.
    Имя очереди myqueue-items Имя очереди для подключения к вашей учетной записи хранения.
    Подключение к учетной записи хранения AzureWebJobsStorage Вы можете использовать подключение к учетной записи хранения, которое уже используется вашим приложением-функцией, или создать его.

    Azure создает функцию служба хранилища очереди, активированную на основе предоставленных значений

Затем необходимо подключиться к своей учетной записи хранения Azure и создать очередь службы хранилища myqueue-items.

Создание очереди

  1. В функции на странице Обзор выберите группу ресурсов.

    Выберите группу ресурсов портала Azure.

  2. Найдите и выберите учетную запись хранения своей группы ресурсов.

    Перейдите к учетной записи хранения.

  3. Выберите Очереди, а затем нажмите + Очередь.

    Добавьте очередь в свою учетную запись хранения на портале Azure.

  4. В поле Имя введите myqueue-items и нажмите кнопку Создать.

    Присвойте имя контейнеру хранилища очередей.

Теперь, когда вы создали очередь хранилища, испытайте функцию, добавив сообщение в очередь.

Проверка функции

  1. На портале Azure перейдите к вашей функции, в нижней части страницы разверните Журналы и убедитесь, что потоковая передача журналов не остановлена.

    Разверните журнал на портале Azure.

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

  3. Нажмите Очереди, а затем выберите контейнер myqueue-items.

    Перейдите к очереди myqueue-items на портале Azure.

  4. Выберите Добавить сообщение и введите "Hello World!" в Текстовом сообщении. Нажмите ОК.

    Снимок экрана: выделенная кнопка Add message (Добавить сообщение) и текстовое поле Message (Сообщение).

  5. Подождите несколько секунд, а затем вернитесь в журналы функции и убедитесь, что новое сообщение было считано из очереди.

    Просмотр сообщения в журналах.

  6. Вернитесь к очереди хранилища, щелкните Обновить и убедитесь, что сообщение было обработано и больше не находится в очереди.

Очистка ресурсов

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

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

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

  1. На портале Azure перейдите на страницу Resource group (Группа ресурсов).

    Чтобы перейти на эту страницу со страницы приложения-функции, перейдите на вкладку Обзор,и щелкните ссылку в разделе Группа ресурсов.

    Снимок экрана: выбор группы ресурсов, которую требуется удалить со страницы приложения-функции.

    Чтобы перейти на эту страницу с панели управления, выберите Resource groups (Группы ресурсов), а затем выберите группу ресурсов, которая использовалась в этой статье.

  2. На странице Группа ресурсов просмотрите список включенных ресурсов и убедитесь, что именно их нужно удалить.

  3. Выберите Удалить группу ресурсов и следуйте инструкциям.

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

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

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

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