Руководство. Создание веб-приложения Tomcat с Azure App Service в Linux и MySQL

• Учетная запись Azure с активной подпиской. Если у вас нет учетной записи Azure, ее можно создать бесплатно.
• Учетная запись GitHub. Вы также можете получить его бесплатно.
• Знание Java и опыт разработки с использованием Tomcat.
• (Необязательно) Чтобы попробовать GitHub Copilot, необходима учетная запись GitHub Copilot. Доступна 30-дневная бесплатная пробная версия.

• Учетная запись Azure с активной подпиской. Если у вас нет учетной записи Azure, ее можно создать бесплатно.
• Установлен интерфейс командной строки разработчика Azure. Вы можете выполнить действия в Azure Cloud Shell, так как в ней уже установлен Интерфейс командной строки разработчика Azure.
• Знание Java и опыт разработки с использованием Tomcat.
• (Необязательно) Чтобы попробовать GitHub Copilot, необходима учетная запись GitHub Copilot. Доступна 30-дневная бесплатная пробная версия.

2. Создайте App Service и MySQL

Сначала вы создадите ресурсы Azure. Действия, используемые в этом руководстве, создают набор безопасных ресурсов по умолчанию, включающих Служба приложений и База данных Azure для MySQL. Для процесса создания укажите:

• Название для веб-приложения. Он используется в качестве части DNS-имени.
• Регион для физического запуска приложения в мире. Он также используется в качестве части DNS-имени приложения.
• Стек среды выполнения для приложения. Здесь вы выбираете версию Java, используемую для вашего приложения.
• План размещения для приложения. Это ценовая категория, которая включает набор функций и емкость масштабирования для вашего приложения.
• Группа ресурсов для приложения. Группа ресурсов позволяет группировать (в логическом контейнере) все ресурсы Azure, необходимые для приложения.

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

1. На портале Azure:

   • В строке поиска в верхней части введите службу приложений.
   • В разделе " Службы" выберите "Служба приложений".
   • Выберите "Создать>веб-приложение".

   Вы также можете сразу перейти к мастеру создания.

2. На вкладке "Основные сведения" на странице "Создание веб-приложения" заполните форму следующим образом:

   • Группа ресурсов: выберите "Создать" и используйте имя msdocs-tomcat-mysql-tutorial.
   • Имя: msdocs-tomcat-mysql-XYZ, где XYZ - это любые три случайные символа.
   • Стек среды выполнения: Java 25.
   • Стек веб-сервера Java: Apache Tomcat 11.0.
   • Операционная система: Linux.
   • Регион: любой регион Azure рядом с вами.
   • Тарифный план: Базовый. Когда вы будете готовы, вы можете перейти на производственный ценовой уровень.

3. Выберите вкладку "База данных " и настройте базу данных:

   • Выберите "Создать базу данных".
   • В обработчике выберите MySQL — гибкий сервер. База данных Azure для MySQL. Гибкий сервер — это полностью управляемая база данных MySQL как услуга в Azure, совместимая с последними выпусками сообщества.
   • Не нажимайте кнопку "Создать Кэш Azure для Redis".

4. Выберите "Рецензирование и создание". После завершения проверки нажмите кнопку "Создать".

5. После завершения развертывания нажмите кнопку "Перейти к ресурсу ". Вы перейдете непосредственно в приложение Службы приложений.

Создаются следующие ресурсы:

• Группа ресурсов: контейнер для всех созданных ресурсов.
• План службы приложений: определяет вычислительные ресурсы для службы приложений. Создается план Linux на уровне "Базовый ".
• App Service: представляет ваше приложение и выполняется в плане App Service.
• Виртуальная сеть: интегрирована с приложением службы приложений и изолирует внутренний сетевой трафик.
• Гибкий сервер Базы данных Azure для MySQL: доступен только из виртуальной сети. База данных и пользователь создаются на этом сервере.
• Частные зоны DNS: Включите разрешение DNS для сервера базы данных в виртуальной сети.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

3. Безопасные секреты подключения

Мастер создания создал строку подключения к базе данных для вас уже в качестве параметра приложения. Однако с точки зрения безопасности лучше всего вообще не хранить секреты в App Service. Вы перемещаете секреты в хранилище ключей и изменяете параметр приложения на ссылку Key Vault с помощью соединителей служб.

Подводя итог, процесс включал получение строки подключения MySQL из переменных среды App Service, создание Azure Key Vault для безопасного управления секретами с закрытым доступом и обновление соединителя службы для хранения пароля в Azure Key Vault. Безопасное подключение между приложением Служба приложений и хранилищем ключей было установлено с помощью управляемого удостоверения, назначаемого системой, и программа установки была проверена путем подтверждения того, что строка подключения использует ссылку Key Vault.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

4. Подтверждение источника данных JNDI

Если параметры приложения содержат допустимую строку подключения JDBC для Oracle, SQL Server, PostgreSQL или MySQL, и для параметра приложения WEBSITE_AUTOCONFIGURE_DATABASE задано значение true, служба приложений добавляет для него источник данных Java Naming and Directory Interface (JNDI) в файл context.xml сервера Tomcat. На этом шаге вы добавите этот параметр приложения, а затем используйте подключение SSH к контейнеру приложения для проверки источника данных JNDI. В этом процессе вы узнаете, как получить доступ к оболочке SSH для контейнера Tomcat.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

5. Развертывание примера кода

На этом шаге вы настроите развертывание GitHub с помощью GitHub Actions. Это всего лишь один из множества способов развертывания в Службе приложений, но это также отличный способ обеспечения непрерывной интеграции в процессе развертывания. По умолчанию каждый git push из репозитория GitHub запускает действие сборки и развертывания.

Как и соглашение Tomcat, если вы хотите развернуть в корневом контексте Tomcat, назовите созданный артефакт ROOT.war.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

6. Перейдите к приложению

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

7. Передача диагностических журналов в режиме реального времени

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

@WebServlet(urlPatterns = "/")
public class ViewServlet extends HttpServlet {
    private static Logger logger = LogManager.getLogger(ViewServlet.class.getName());
    
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        logger.info("GET /");

        EntityManagerFactory emf = (EntityManagerFactory) req.getServletContext().getAttribute("EMFactory");

Узнайте больше о ведении журналов в приложениях Java в серии «Включите Azure Monitor OpenTelemetry для приложений .NET, Node.js, Python и Java».

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

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

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

2. Создание ресурсов Azure и развертывание примера приложения

На этом шаге вы создадите ресурсы Azure и развернете пример приложения в Службе приложений Linux. Действия, используемые в этом руководстве, создают набор безопасных ресурсов по умолчанию, включающих Служба приложений и База данных Azure для MySQL.

Контейнер разработки уже имеет интерфейс командной строки разработчика Azure (AZD).

1. Из корня репозитория выполните команду azd init.

   azd init --template tomcat-app-service-mysql-infra .
   

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

   Вопрос	Ответ
   Текущий каталог не пуст. Вы хотите инициализировать проект здесь, в каталоге '<your-directory>'?	Y
   Что вы хотите сделать с этими файлами?	Сохранение существующих файлов без изменений
   Введите новое имя среды	Введите уникальное имя. Шаблон AZD использует это имя как часть DNS-имени веб-приложения в Azure (<app-name>-<hash>.azurewebsites.net). Разрешены буквенно-цифровые символы и дефисы.

3. Войдите в Azure, выполнив команду azd auth login и следуя указаниям:

   azd auth login
   

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

   azd up
   

   Выполнение azd up команды занимает около 10 минут. Он также компилирует и развертывает код вашего приложения, но позже вы изменяете свой код, чтобы он работал с App Service. Во время выполнения команда предоставляет сообщения о процессе подготовки и развертывания, включая ссылку на развертывание в Azure. По завершении команда также отображает ссылку на приложение развертывания.

   Этот шаблон AZD содержит файлы (azure.yaml и инфраструктурный каталог), создающие архитектуру с безопасностью по умолчанию со следующими ресурсами Azure:

   • Группа ресурсов: контейнер для всех созданных ресурсов.
   • План службы приложений: определяет вычислительные ресурсы для службы приложений. Создается план Linux на уровне B1 .
   • App Service: представляет ваше приложение и выполняется в плане App Service.
   • Виртуальная сеть: интегрирована с приложением службы приложений и изолирует внутренний сетевой трафик.
   • Гибкий сервер Базы данных Azure для MySQL: доступен только из виртуальной сети с помощью интеграции зоны DNS. База данных создается для вас на сервере.
   • Azure Managed Redis: доступен только из виртуальной сети.
   • Частные конечные точки: доступ к конечным точкам для хранилища ключей и экземпляра Managed Redis в виртуальной сети.
   • Частные зоны DNS: обеспечивают разрешение DNS для хранилища ключей, сервера базы данных и управляемого экземпляра Redis в виртуальной сети.
   • Рабочая область Log Analytics: выступает в качестве целевого контейнера для вашего приложения для отправки журналов, где можно также запрашивать журналы.
   • Хранилище ключей. Используется для сохранения пароля базы данных при повторном развертывании с помощью AZD.

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

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

3. Проверьте строки подключения

Используемый вами шаблон AZD создал переменные подключения для вас уже как параметры приложения и выводит их в терминал для удобства. Параметры приложения — один из способов не хранить секреты подключения в репозитории кода.

1. В выходных данных AZD найдите параметр приложения AZURE_MYSQL_CONNECTIONSTRING. Отображаются только имена параметров. Они выглядят следующим образом в выходных данных AZD:

    App Service app has the following connection strings:
            - AZURE_MYSQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
    

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

2. Для удобства шаблон AZD отображает прямую ссылку на страницу параметров приложения. Найдите ссылку и откройте ее на новой вкладке браузера.

   Если вы добавляете параметр приложения, содержащий допустимую строку подключения Oracle, SQL Server, PostgreSQL или MySQL, служба приложений добавляет ее в качестве источника данных Java Naming and Directory Interface (JNDI) в context.xml файле сервера Tomcat.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

4. Подтверждение источника данных JNDI

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

1. В выходных данных AZD найдите URL-адрес сеанса SSH и перейдите к нему в браузере. Это выглядит следующим образом в выходных данных:

    Open SSH session to App Service container at: <URL>
    

2. В терминале SSH выполните команду cat /usr/local/tomcat/conf/context.xml. Вы должны увидеть, что был добавлен ресурс JNDI с именем jdbc/AZURE_MYSQL_CONNECTIONSTRING_DS. Позже вы используете этот источник данных. Служба приложений автоматически создает этот источник данных, так как шаблон AZD устанавливает параметр приложения WEBSITE_AUTOCONFIGURE_DATABASE в значение true.

   

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

5. Изменение примера кода и повторное развертывание

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

6. Перейдите к приложению

1. В выходных данных AZD найдите URL-адрес приложения и перейдите к нему в браузере. URL-адрес выглядит следующим образом в выходных данных AZD:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: <URL>
    

2. Добавьте несколько задач в список.

   

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

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

7. Передача диагностических журналов в режиме реального времени

Служба приложений Azure может собирать журналы консоли, чтобы помочь вам диагностировать проблемы в приложении. Для удобства шаблон AZD уже включил ведение журнала в локальную файловую систему и отправляет журналы в рабочую область Log Analytics.

Пример приложения включает стандартные инструкции ведения журнала Log4j для демонстрации этой возможности, как показано в следующем фрагменте кода:

@WebServlet(urlPatterns = "/")
public class ViewServlet extends HttpServlet {
    private static Logger logger = LogManager.getLogger(ViewServlet.class.getName());
    
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        logger.info("GET /");

        EntityManagerFactory emf = (EntityManagerFactory) req.getServletContext().getAttribute("EMFactory");

В выводе AZD найдите ссылку для потоковой передачи журналов App Service и перейдите по ней в браузере. Ссылка выглядит следующим образом в выходных данных AZD:

Stream App Service logs at: <URL>

Узнайте больше о ведении журналов в приложениях Java в серии «Включите Azure Monitor OpenTelemetry для приложений .NET, Node.js, Python и Java».

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

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

Чтобы удалить все ресурсы Azure в текущей среде развертывания, выполните azd down и следуйте инструкциям.

azd down