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

Завершено

В этом первом упражнении вы создадите код для синтаксического анализа сообщений о событиях вики на GitHub в Azure Functions. Вы настроите функцию для запуска при получении сообщения webhook.

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

  1. Войдите на портал Azure с помощью учетной записи MS Learn.

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

  3. В области меню слева в разделе категориивыберите Compute, а в поле поиска служб и marketplace найдите и выберите Function App. Появится окно функции приложения.

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

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

    Заметка

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

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

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

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

    Настройка Ценность
    Хранилища
    Учетная запись хранения (Новое) и примите имя по умолчанию.
  7. Выберите Проверка и создание.

  8. Azure проверяет свои записи. После проверки выберите Создать.

Создайте функцию, вызываемую вебхуком

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

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

  3. Появится панель создания функции.

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

  5. В меню слева в разделе Разработчиквыберите Code + Test. Откроется панель кода и теста для функции, отображающей файл 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=<имя>, например &name=Dick и Jane.

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

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

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