Создание первой функции Java в Azure с помощью IntelliJ
В этой статье показано, как использовать Java и IntelliJ для создания функции Azure.
В частности, в этой статье показано следующее:
- Как создать функцию Java, активируемую по HTTP, в проекте IntelliJ IDEA.
- Шаги, которые необходимо выполнить для проверки и отладки проекта в интегрированной среде разработки (IDE) на вашем компьютере.
- Инструкция для развертывания проекта функции в Функциях Azure.
Необходимые компоненты
- Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
- Поддержка Azure пакет средств разработки Java (JDK) версии 8, 11, 17 или 21. (Java 21 в настоящее время поддерживается только в предварительной версии только в Linux)
- Установленный IntelliJ IDEA Ultimate Edition или Community Edition.
- Maven 3.5.0+
- Последняя версия Function Core Tools
Установка подключаемого модуля и вход
Чтобы установить набор средств Azure для IntelliJ, а затем выполнить вход, сделайте следующее:
В диалоговом окне IntelliJ IDEA Параметры и предпочтения (CTRL+ALT+S) выберите Подключаемые модули. Затем найдите модуль Azure Toolkit for IntelliJ в Marketplace и щелкните Install (Установить). После установки щелкните Перезапуск, чтобы активировать подключаемый модуль.
Чтобы войти в учетную запись Azure, откройте боковую панель Azure Explorer, а затем щелкните значок Вход в Azure в верхней строке (или в меню IDEA Инструменты/Azure/Вход в Azure> (Средства/Azure/>Вход в Azure)).
В окне Вход в Azure выберите OAuth 2.0 и щелкните Войти. Другие варианты входа см. в инструкциях по входу в Набор средств Azure для IntelliJ.
В браузере войдите с помощью учетной записи и вернитесь в IntelliJ. В диалоговом окне Выбор подписок укажите нужные подписки и щелкните Выбрать.
Создание локального проекта
В этом разделе вы используете набор средств Azure для IntelliJ, чтобы создать локальный проект Функций Azure по шагам:
Откройте диалоговое окно приветствия IntelliJ, выберите Создать новый проект, чтобы открыть мастер создания проекта, выберите Функции Azure.
Выберите Триггер Http, затем щелкните Далее и следуйте подсказкам мастера установки при настройке всех последующих страниц. Подтвердите расположение проекта, затем щелкните Завершить. Затем Intellj IDEA откроет новый проект.
Локальный запуск проекта
Чтобы запустить проект локально, выполните следующие действия:
Важно!
Необходимо правильно установить переменную среды JAVA_HOME в каталог JDK, используемый во время компиляции кода с помощью Maven. Убедитесь, что версия JDK не ниже Java.version.
Перейдите к src/main/java/org/example/functions/HttpTriggerFunction.java, чтобы просмотреть созданный код. Рядом со строкой 24 вы заметите зеленую кнопку Выполнить. Щелкните его и выберите Запуск "функции-azur...".. Вы увидите, что приложение-функция работает локально с несколькими журналами.
Вы можете попробовать выполнить функцию, обратившись к конечной точке из браузера, например
http://localhost:7071/api/HttpExample?name=Azure.
Журнал также отображается в вашей IDEA. Остановите приложение-функцию, нажав кнопку Остановить.
Локальная отладка проекта
Чтобы запустить проект локально, выполните следующие действия:
Нажмите кнопку Отладка на панели инструментов. Если панель инструментов не видна, включите ее, выбрав Вид>Представление>Панель инструментов.
Щелкните строку 20 файла src/main/java/org/example/functions/HttpTriggerFunction.java , чтобы добавить точку останова. Снова получите доступ к конечной точке
http://localhost:7071/api/HttpTrigger-Java?name=Azure, и вы обнаружите, что точка останова будет достигнута. Затем можно попробовать дополнительные функции отладки, такие как шаг, контрольные значения и оценка. Чтобы отключить сеанс отладки, нажмите кнопку Остановить.
Развертывание проекта в Azure
Чтобы развернуть проект в Azure, выполните следующие действия:
Щелкните и разверните значок Azure в обозревателе проектов IntelliJ, а затем выберите "Развернуть в Azure-> Развернуть в Функции Azure".
Если у вас еще нет приложения-функции, щелкните + в строке Функция. Введите имя приложения-функции и выберите соответствующую платформу. Вы можете принять значения по умолчанию. Нажмите кнопку ОК, и вновь созданное приложение-функция будет выбрано автоматически. Щелкните Запустить, чтобы развернуть функции.
Управление приложениями-функциями из IDEA
Чтобы управлять приложениями-функциями с помощью Azure Explorer в IDEA, выполните следующие действия:
Щелкните Приложение-функция, и вы увидите все перечисленные приложения-функции.
Щелкните, чтобы выбрать одно из своих приложений-функций, и щелчком правой кнопкой мыши выберите Показать свойства, чтобы открыть страницу сведений.
Щелкните правой кнопкой мыши приложение-функцию HttpTrigger-Java, а затем выберите Активировать функцию в браузере. Вы увидите, что браузер открыт с URL-адресом триггера.
Добавление дополнительных функций в проект
Чтобы добавить в проект больше функций, выполните следующие действия:
Щелкните правой кнопкой мыши пакет org.example.functions и выберите Создать > >Классс Функций Azure.
Заполните поля имени класса HttpTest, выберите Триггер Http в мастере создания классов функций, а затем нажмите ОК, чтобы создать. Таким образом, вы можете создавать новые функции по своему желанию.
Очистка функций
Выберите одно из приложений-функций с помощью Azure Explorer в IDEA, а затем щелкните правой кнопкой мыши и выберите Удалить. Выполнение этой команды может занять несколько минут. По завершении состояние будет обновлено в Azure Explorer.
Следующие шаги
Итак, вы создали проект Java для функции, активируемой по HTTP-запросу, запустили эту функцию на своем локальном компьютере и развернули ее в Azure. Теперь расширьте функцию, перейдя к следующей статье: