Упражнение. Создание функции Azure, активируемой веб-перехватчиком

Завершено

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

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

  1. Войдите на портал Azure, используя свою учетную запись Microsoft Learn.

  2. Выберите Создать ресурс. Откроется панель Создание ресурса.

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

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

  5. На вкладке Основные сведения введите указанные ниже значения для каждого параметра.

    Примечание.

    Имя приложения-функции должно быть уникальным. Предлагаем использовать такой формат: <ваше имя или инициалы>triggerapp. Используйте это имя вместо <имя_приложения-функции> в этом упражнении.

    Параметр Значение
    Сведения о проекте
    Отток подписок Подписка Concierge
    Группа ресурсов В раскрывающемся списке выберите группу ресурсов песочницы [имя группы ресурсов песочницы].
    Сведения об экземпляре
    Имя приложения-функции <имя_вашего_приложения-функции>
    Публикация Код
    Стек среды выполнения Node.js
    Версия Примите значение по умолчанию
    Регион Выберите ближайший к вам регион, который также является одним из допустимых регионов песочницы.
    Операционная система
    Операционная система Windows
    Размещение
    Варианты размещения и планы Потребление (бессерверный)

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

    • Западная часть США 2
    • Центрально-южная часть США
    • Центральная часть США
    • Восточная часть США
    • Западная Европа
    • Southeast Asia
    • Восточная Япония
    • Южная Бразилия
    • Юго-Восточная часть Австралии
    • Центральная Индия
  6. Нажмите кнопку Далее: служба хранилища, чтобы открыть вкладку служба хранилища. Введите следующие значения для каждого параметра.

    Параметр Значение
    Память
    Storage account (Создать) и примите имя по умолчанию.
  7. Выберите Review + create (Просмотреть и создать).

  8. Azure проверит указанные значения. После проверки нажмите Создать.

Создание функции, активируемой веб-перехватчиком

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

  2. В разделе "Функции" выберите "Создать" в портал Azure.

  3. Откроется панель Создание функции.

  4. В разделе Выбрать шаблон выберите Триггер HTTP, а затем нажмите кнопку Создать. Появится панель HttpTrigger1 вашей функции, на которой отображаются основные компоненты для нового триггера.

  5. В меню навигации слева в разделе Разработчик выберите Код и тестирование. Появится панель Код и тестирование вашей функции с файлом JavaScript, созданным на основе шаблона. Код функции должен выглядеть следующим образом.

    module.exports = async function (context, req) {
        context.log('JavaScript HTTP trigger function processed a request.');
    
        const name = (req.query.name || (req.body && req.body.name));
        const responseMessage = name
            ? "Hello, " + name + ". This HTTP triggered function executed successfully."
            : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";
    
        context.res = {
            // status: 200, /* Defaults to 200 */
            body: responseMessage
        };
    }
    

    Файл index.js — это функция JavaScript, созданная с помощью портала. Запрос считывает имя, передаваемое как строка запроса или как часть текста запроса, и выдает сообщение "Hello".

  6. Над кодом указан путь с раскрывающимся списком, в котором отображается имя файла. В раскрывающемся списке выберите файл function.json. Появится файл JSON, созданный шаблоном. Код функции должен выглядеть следующим образом.

    {
        "bindings": [
            {
                "authLevel": "function",
                "type": "httpTrigger",
                "direction": "in",
                "name": "req",
                "methods": [
                    "get",
                    "post"
                ]
            },
            {
                "type": "http",
                "direction": "out",
                "name": "res"
            }
        ]
    }
    

    Привязки JSON указывают, что функция активируется с помощью запросов HTTP GET и POST, направляемых непосредственно на URL-адрес приложения-функции.

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

  1. В верхней строке меню выберите Получить URL-адрес функции.

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

    https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==
    
  3. Вставьте этот URL-адрес в браузер и в конце URL-адреса добавьте параметр строки запроса: &name=<yourname>, например &name=Dick и Jane.

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

    Hello Dick and Jane. This HTTP triggered function executed successfully.
    

Поздравляем! Теперь у вас есть функция, которую можно активировать по URL-адресу.