Краткое руководство. Создание и развертывание кода функции в Azure с помощью Visual Studio Code

Используйте Visual Studio Code для создания функции, которая отвечает на HTTP-запросы из шаблона. Используйте GitHub Copilot, чтобы улучшить созданный код функции, проверить обновления кода локально, а затем развернуть его в бессерверном плане размещения Flex Consumption в Функциях Azure.

Завершение этого быстрого старта влечет за собой небольшие расходы в несколько центов США или меньше в вашей учетной записи Azure.

Выберите предпочитаемый язык разработки в верхней части статьи.

Предпосылки

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .

• Visual Studio Code на одной из поддерживаемых платформ.

• Расширение "Функции Azure" для Visual Studio Code.

Установка или обновление основных средств

Расширение Функции Azure для Visual Studio Code интегрируется с Функции Azure core Tools, чтобы вы могли выполнять и отлаживать функции локально в Visual Studio Code с помощью среды выполнения Функции Azure. Прежде чем приступить к работе, рекомендуется установить Core Tools локально или обновить существующую установку, чтобы использовать последнюю версию.

В Visual Studio Code выберите F1, чтобы открыть палитру команд, а затем выполните поиск и выполните команду Функции Azure: установка или обновление основных инструментов.

Эта команда пытается запустить установку на основе пакета последней версии Core Tools или обновить существующую установку на основе пакетов. Если на локальном компьютере не установлено npm или Homebrew, необходимо вручную установить или обновить основные средства.

Создание локального проекта

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

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

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

3. Введите следующие сведения в соответствии с запросами.

   Подсказка	Отбор
   Выбор языка	Выберите C#.
   Выберите среду выполнения .NET	Выберите .NET 8.0 LTS.
   Выбор шаблона для первой функции проекта	Выберите HTTP trigger.
   Укажите имя функции	Введите HttpExample.
   Укажите пространство имен	Введите My.Functions.
   Уровень авторизации	выберите Anonymous, что позволит любому пользователю вызывать конечную точку функции. Для получения дополнительной информации см. Уровень авторизации.
   Выбор способа открытия проекта	Выберите Open in current window.

   Подсказка	Отбор
   Выбор языка	Выберите Java.
   Выберите версию Java	Выберите Java 8или Java 11Java 17Java 21версию Java, в которой работают функции в Azure. Выберите версию Java, которую вы проверили локально.
   Укажите идентификатор группы	Выберите com.function.
   Укажите идентификатор артефакта	Выберите myFunction.
   Укажите версию	Выберите 1.0-SNAPSHOT.
   Укажите имя пакета	Выберите com.function.
   Укажите имя приложения	Выберите myFunction-12345.
   Выбор шаблона для первой функции проекта	Выберите HTTP trigger.
   Выберите средство сборки для проекта Java	Выберите Maven.
   Выбор способа открытия проекта	Выберите Open in current window.

   Подсказка	Отбор
   Выбор языка	Выберите JavaScript.
   Выбор модели программирования JavaScript	Выберите Model V4.
   Выбор шаблона для первой функции проекта	Выберите HTTP trigger.
   Укажите имя функции	Введите HttpExample.
   Уровень авторизации	выберите Anonymous, что позволит любому пользователю вызывать конечную точку функции. Для получения дополнительной информации см. Уровень авторизации.
   Выбор способа открытия проекта	Выберите Open in current window.

   Подсказка	Отбор
   Выбор языка	Выберите TypeScript.
   Выбор модели программирования JavaScript	Выберите Model V4.
   Выбор шаблона для первой функции проекта	Выберите HTTP trigger.
   Укажите имя функции	Введите HttpExample.
   Уровень авторизации	выберите Anonymous, что позволит любому пользователю вызывать конечную точку функции. Для получения дополнительной информации см. Уровень авторизации.
   Выбор способа открытия проекта	Выберите Open in current window.

   Подсказка	Отбор
   Выбор языка	Выберите Python.
   Выберите интерпретатор Python для создания виртуальной среды	Выберите предпочтительный интерпретатор Python. Если нужный вариант не отображается, введите полный путь к двоичному файлу Python.
   Выбор шаблона для первой функции проекта	Выберите HTTP trigger.
   Имя создаваемой функции	Введите HttpExample.
   Уровень авторизации	Выберите ANONYMOUS, что позволит любому пользователю вызывать конечную точку функции. Для получения дополнительной информации см. Уровень авторизации.
   Выбор способа открытия проекта	Выберите Open in current window.

   Подсказка	Отбор
   Выбор язык для проекта приложения-функции	Выберите PowerShell.
   Выбор шаблона для первой функции проекта	Выберите HTTP trigger.
   Укажите имя функции	Введите HttpExample.
   Уровень авторизации	выберите Anonymous, что позволит любому пользователю вызывать конечную точку функции. Для получения дополнительной информации см. Уровень авторизации.
   Выбор способа открытия проекта	Выберите Open in current window.

   Используя эти сведения, Visual Studio Code создает проект кода для функций Azure с конечной точкой функции триггера HTTP. Файлы локального проекта можно просмотреть в Explorer. Дополнительные сведения см. в разделе Generated project files (Созданные файлы проекта).

Локальное выполнение функции

Visual Studio Code интегрируется с Azure Functions Core Tools, чтобы перед публикацией в Azure можно было запустить этот проект на локальном компьютере разработки.

1. Чтобы запустить функцию локально, нажмите клавишу F5 или значок запуска и отладки на панели действий слева. На панели Терминал отобразятся выходные данные из Core Tools. Ваше приложение запускается в панели Терминал. Отобразится URL-адрес конечной точки активируемой HTTP-запросом функции, которая выполняется локально.

   

   При возникновении проблем с запуском в Windows убедитесь, что в качестве терминала по умолчанию для Visual Studio Code не используется WSL Bash.

2. Во время выполнения Core Tools в Терминале щелкните значок Azure на панели действий. В области Рабочая область разверните узел Локальный проект>Функции. Щелкните правой кнопкой мыши (Windows) или CTRL - щелкните новую функцию (macOS) и выберите "Выполнить функцию сейчас...".

   

3. В поле Введите текст запроса отображается текст сообщения запроса { "name": "Azure" }. Нажмите клавишу ВВОД, чтобы отправить это сообщение запроса в вашу функцию.

4. При выполнении функции локально и возврате ответа в Visual Studio Code отобразится уведомление. Сведения о выполнении функции отображаются на панели Терминал.

5. Откройте панель терминала и нажмите клавиши CTRL+C, чтобы остановить основные инструменты и отключить отладчик.

Убедившись, что функция работает правильно на локальном компьютере, можно дополнительно использовать средства ИИ, такие как GitHub Copilot в Visual Studio Code, для обновления кода функции, созданного шаблоном.

Использование ИИ для нормализации и проверки входных данных

Это пример запроса для Copilot Chat, который обновляет существующий код функции для получения параметров из строки запроса или текста JSON, применения форматирования или преобразования типов и возврата их в виде JSON в ответе:

Modify the function to accept name, email, and age from the JSON body of the
request. If any of these parameters are missing from the query string, read
them from the JSON body. Return all three parameters in the JSON response, 
applying these rules:
Title-case the name
Lowercase the email
Convert age to an integer if possible, otherwise return "not provided"
Use sensible defaults if any parameter is missing

Modify the function to accept name, email, and age from the JSON body of the
request. If any of these parameters are missing from the query string, read
them from the JSON body. Return all three parameters in the JSON response, 
applying these rules:
Title-case the name
Lowercase the email
Convert age to an integer if possible, otherwise return "not provided"
Use sensible defaults if any parameter is missing
Update the FunctionTest.java file to test the new logic. 

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

{ "name": "devon torres", "email": "[email protected]", "age": "34" }

Если вы сатируете приложение, вы можете использовать Visual Studio Code для публикации проекта непосредственно в Azure.

Вход в Azure

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

1. Если вы еще не вошли, на панели действий выберите значок Azure. Затем в разделе "Ресурсы" выберите вход в Azure.

   

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

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

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

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

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

1. В Visual Studio Code нажмите клавишу F1, чтобы открыть палитру команд. В командной строке (>), введите и выберите Функции Azure: создание приложения-функции в Azure.

2. В запросах укажите следующие сведения:

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

   На панели "Журнал действий" расширение Azure отображает состояние отдельных ресурсов, созданных в Azure.

   

3. При создании приложения-функции в подписке Azure создаются следующие связанные ресурсы. Ресурсы именуются на основе имени, введенного для приложения-функции.

   • группу ресурсов — логический контейнер связанных ресурсов;
   • Приложение-функция, которое предоставляет окружение для выполнения кода вашей функции. Приложение-функция позволяет группировать функции в логические единицы и упростить развертывание, масштабирование и совместное использование ресурсов, а также управление ими в рамках единого плана размещения.
   • План службы приложение Azure, определяющий базовый узел приложения-функции.
   • Стандартная учетная запись хранения Azure, которая используется узлом функций для поддержания состояния и других сведений о приложении-функции.
   • Экземпляр Application Insights, подключенный к приложению-функции, и который отслеживает использование функций в приложении.
   • Управляемое удостоверение, назначенное пользователем, которое добавляется в роль участника данных объектного хранилища Blob в новой учетной записи хранилища узла по умолчанию.

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

   Подсказка

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

Развертывание проекта в Azure

1. В командной палитре введите и выберите Функции Azure: Развернуть в функциональном приложении.

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

3. После завершения развертывания выберите "Просмотреть выходные данные ", чтобы просмотреть результаты создания и развертывания, включая созданные ресурсы Azure. Если вы пропустили уведомление, выберите значок колокольчика в правом нижнем углу, чтобы увидеть его снова.

   

Запуск функции в Azure

1. Нажмите клавишу F1 , чтобы отобразить палитру команд, а затем выполните команду Azure Functions:Execute Function Now.... Если появится запрос, выберите подписку.

2. Выберите новый ресурс приложения-функции и HttpExample в качестве функции.

3. Введите запроса, а затем нажмите клавишу ВВОД, чтобы отправить это сообщение в функцию.

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

Устранение неполадок

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

Очистите ресурсы

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

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

1. В Visual Studio Code выберите значок Azure, чтобы открыть обозреватель Azure.
2. В разделе "Группы ресурсов" найдите группу ресурсов.
3. Щелкните группу ресурсов правой кнопкой мыши и выберите Удалить.

Дополнительные сведения о затратах на использование Функций см. в статье Estimating Consumption plan costs (Оценка затрат на план потребления).

Дальнейшие шаги

С помощью Visual Studio Code вы создали приложение-функцию с простой функцией, активируемой HTTP-запросом. В следующих статьях вы разверните эту функцию, подключився к Azure Cosmos DB или службе хранилища Azure. Дополнительные сведения о подключении к другим службам Azure см. в статье Подключение функций к службам Azure с помощью привязок. Если вы хотите узнать больше о безопасности, см. статью Защита Функций Azure.