Краткое руководство. Развертывание кластера JBoss EAP в Azure Виртуальные машины (виртуальных машинах)

Статья
2024-08-24

В этой статье показано, как быстро развернуть кластер платформы приложений JBoss Enterprise (EAP) в Azure Виртуальные машины (виртуальных машинах) с помощью портал Azure.

В этой статье используется предложение Azure Marketplace для кластера JBoss EAP для ускорения перехода на виртуальные машины Azure. Предложение автоматически подготавливает ряд ресурсов, включая виртуальные машины Azure Red Hat Enterprise Linux (RHEL), экземпляры JBoss EAP на каждой виртуальной машине, сборку Red Hat OpenJDK на каждой виртуальной машине, консоль управления JBoss EAP и при необходимости экземпляр шлюза приложение Azure. Чтобы просмотреть предложение, посетите кластер JBoss EAP на виртуальных машинах RHEL с помощью портал Azure.

Если вы предпочитаете вручную пошаговое руководство по установке кластера Red Hat JBoss EAP на виртуальных машинах Azure, которые не используют автоматизацию, включенную предложением Azure Marketplace, см. руководство по установке Red Hat JBoss EAP в Azure Виртуальные машины вручную.

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

Необходимые компоненты

Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
Убедитесь, что удостоверение Azure, используемое для входа, имеет роль участника или роль владельца в текущей подписке. Общие сведения о ролях Azure см. в статье "Что такое управление доступом на основе ролей Azure" (Azure RBAC)?
Пакет средств разработки Java (JDK) версии 17. В этом руководстве мы рекомендуем использовать Red Hat Build of OpenJDK. Убедитесь, что JAVA_HOME переменная среды правильно задана в оболочках, в которых выполняются команды.
Git. Используется git --version для проверки того, работает ли git работа. Это руководство было протестировано с версией 2.34.1.
Maven. Используется mvn -version для проверки того, работает ли mvn работа. Это руководство было протестировано с версией 3.8.6.

Примечание.

Предложение Azure Marketplace, используемое в этой статье, включает поддержку Red Hat Satellite для управления лицензиями. Использование Red Hat Satellite выходит за рамки этого краткого руководства. Общие сведения о Red Hat Satellite см. в разделе Red Hat Satellite. Дополнительные сведения о переносе подписок Red Hat JBoss EAP и Red Hat Enterprise Linux в Azure см . в программе Red Hat Cloud Access.

Настройка гибкого сервера База данных Azure для PostgreSQL

В этом разделе описано, как развернуть гибкий сервер База данных Azure для PostgreSQL, который используется для настройки подключения к базе данных при настройке кластера JBoss EAP в следующем разделе.

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

export RG_NAME=<db-resource-group-name>
export SERVER_NAME=<database-server-name>
export ADMIN_PASSWORD=<postgresql-admin-password>

Замените заполнители следующими значениями, которые используются во всей статье:

<db-resource-group-name>: имя группы ресурсов, используемой для гибкого сервера PostgreSQL, например ejb040323postgresrg.
<database-server-name>: имя сервера PostgreSQL, который должен быть уникальным в Azure, например ejb040323postgresqlserver.
<postgresql-admin-password>: пароль сервера PostgreSQL. Этот пароль должен быть не менее восьми символов и не более 128 символов. Символы должны быть из трех из трех следующих категорий: английские прописные буквы, строчные буквы английского языка, цифры (0–9) и нефазные цифры (!, $, #, %, и т. д.).

Затем выполните следующие действия, чтобы создать гибкий сервер База данных Azure для PostgreSQL:

Чтобы создать гибкий сервер База данных Azure для PostgreSQL, используйте следующую команду:

az postgres flexible-server create \
    --resource-group ${RG_NAME} \
    --name ${SERVER_NAME} \
    --database-name testdb \
    --public-access 0.0.0.0  \
    --admin-user testuser \
    --admin-password ${ADMIN_PASSWORD} \
    --yes

Чтобы получить узел сервера PostgreSQL, выполните следующую команду:

export DB_HOST=$(az postgres flexible-server show \
    --resource-group ${RG_NAME} \
    --name ${SERVER_NAME} \
    --query "fullyQualifiedDomainName" \
    --output tsv)

Используйте следующую команду, чтобы получить URL-адрес подключения к базе данных Java (JDBC) сервера PostgreSQL:
```
echo jdbc:postgresql://${DB_HOST}:5432/testdb
```
Запишите выходные данные, которые вы используете в качестве источника данных строка подключения сервера PostgreSQL далее в этой статье.

Развертывание кластера JBoss EAP на виртуальных машинах Azure

В этом разделе описано, как развернуть кластер JBoss EAP на виртуальных машинах Azure.

Чтобы найти кластер JBoss EAP на виртуальных машинах Azure, выполните следующие действия.

Войдите в портал Azure, посетите сайтhttps://aka.ms/publicportal.
В строке поиска в верхней части портал Azure введите JBoss EAP. В результатах поиска в разделе Marketplace выберите кластер JBoss EAP на виртуальных машинах.
В раскрывающемся меню убедитесь, что выбран PAYG .

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

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

Ниже показано, как заполнить область "Основные сведения" , показанную на следующем снимке экрана.

На странице предложения нажмите кнопку "Создать".
На панели "Основные сведения" убедитесь, что значение, отображаемое в поле "Подписка", совпадает с ролями, перечисленными в разделе предварительных требований.
В поле "Группа ресурсов" выберите "Создать" и введите значение для группы ресурсов. Так как группы ресурсов должны быть уникальными в пределах подписки, выберите уникальное имя. Простой способ создания уникальных имен — использовать сочетание ваших инициалов, текущей даты и некоторого идентификатора. Например, ejb040323jbosseapcluster.
В разделе "Сведения об экземпляре" выберите регион для развертывания.
Оставьте размер виртуальной машины по умолчанию для размера виртуальной машины.
Оставьте параметр OpenJDK 17 по умолчанию для версии JDK.
Оставьте значение jbossuser по умолчанию для имени пользователя.
Оставьте пароль по умолчанию для типа проверки подлинности.
Укажите пароль для пароля. Используйте то же значение для подтверждения пароля.
Используйте 3 для создания виртуальных машин.
В разделе "Необязательная базовая конфигурация" оставьте параметр "Да" для параметра "Принять значения по умолчанию" для необязательной конфигурации.
Прокрутите страницу до нижней части области "Основные сведения" и обратите внимание на полезные ссылки на проблемы с отчетами, получить справку и поделиться отзывами.
Нажмите кнопку "Далее" — параметры JBoss EAP.

Ниже показано, как заполнить область параметров JBoss EAP, показанную на следующем снимке экрана.

Оставьте управляемый домен по умолчанию для использования управляемого домена или автономных узлов, чтобы сформировать кластер.
Оставьте значение jbossadmin по умолчанию для имени администратора JBoss EAP.
Укажите пароль JBoss EAP для пароля JBoss EAP. Используйте то же значение для подтверждения пароля. Сохраните значение для последующего использования.
Оставьте параметр по умолчанию No for Connect к существующему вспомогательному серверу Red Hat?.
Нажмите кнопку "Далее": Шлюз приложений Azure.

Ниже показано, как заполнить область Шлюз приложений Azure, показанную на следующем снимке экрана.

Выберите "Да" для подключения к Шлюз приложений Azure?.
Выберите Далее: сеть.

Эта область позволяет настроить виртуальную сеть и подсеть, в которую развертывается кластер JBoss EAP. Сведения о виртуальных сетях см. в статье "Создание, изменение" или удаление виртуальной сети. Примите значения по умолчанию на этой панели.
Нажмите кнопку "Далее" — база данных.

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

Выберите "Да " для подключения к базе данных?.
Выберите PostgreSQL для выбора типа базы данных.
Заполните java:jboss/datasources/JavaEECafeDB для имени JNDI.
Укажите URL-адрес подключения JDBC сервера PostgreSQL, сохраненный ранее, для источника данных строка подключения (jdbc:postgresql://<host>:<port>/<database>).
Заполните testuser для имени пользователя базы данных.
Укажите значение заполнителя <postgresql-admin-password>, указанного ранее, для пароля базы данных. Используйте то же значение для подтверждения пароля.
Выберите Review + create (Просмотреть и создать). Убедитесь, что в верхней части появится зеленое сообщение "Проверка пройдена ". Если сообщение не отображается, исправьте проблемы проверки, а затем нажмите кнопку "Проверить и создать еще раз".
Нажмите кнопку создания.
Отслеживание хода выполнения развертывания на странице " Развертывание".

В зависимости от сетевых условий и других действий в выбранном регионе развертывание может занять до 35 минут. После этого на странице развертывания отобразится текст развертывания.

Проверка функциональности развертывания

Выполните следующие действия, чтобы проверить функциональность развертывания кластера JBoss EAP на виртуальных машинах Azure из консоль управления платформы корпоративных приложений Red Hat JBoss Enterprise:

На странице развертывания выберите выходные данные.
Щелкните значок копирования рядом с adminConsole.
Вставьте URL-адрес в веб-браузер, подключенный к Интернету, и нажмите клавишу ВВОД. Вы увидите знакомый экран консоль управления входа в Red Hat JBoss Enterprise Application Platform, как показано на следующем снимке экрана.
Введите имя администратора JBoss EAP для JBossadmin, указав значение пароля JBoss EAP, указанного ранее для пароля, а затем нажмите кнопку "Войти".
Вы увидите знакомую страницу приветствия Red Hat JBoss Enterprise Application Platform консоль управления, как показано на следующем снимке экрана.
Перейдите на вкладку "Среда выполнения ". В области навигации выберите "Топология". Вы увидите, что кластер содержит один главный контроллер домена и два рабочих узла, как показано на следующем снимке экрана:
Перейдите на вкладку "Конфигурация". В области навигации выберите профили>ha>Datasources & Drivers>Datasources. Вы увидите, что источник данныхsource-postgresql указан, как показано на следующем снимке экрана:

Оставьте консоль управления открытым. Он используется для развертывания примера приложения в кластере JBoss EAP в следующем разделе.

Развертывание приложения в кластере JBoss EAP

Чтобы развернуть пример приложения Java EE Cafe в кластере Red Hat JBoss EAP, выполните следующие действия.

Выполните следующие действия, чтобы создать пример Кафе Java EE. В этих шагах предполагается, что у вас установлена локальная среда с Git и Maven:
1. Используйте следующую команду, чтобы клонировать исходный код из GitHub и извлечь тег, соответствующий этой версии статьи:
```
git clone https://github.com/Azure/rhel-jboss-templates.git --branch 20240904 --single-branch
```
  Если появится сообщение об ошибке с текстом You are in 'detached HEAD' state, его можно игнорировать.
2. Чтобы создать исходный код, используйте следующую команду:
```
mvn clean install --file rhel-jboss-templates/eap-coffee-app/pom.xml
```
  Эта команда создает файл rhel-jboss-templates/eap-coffee-app/target/javaee-café.war. Этот файл будет отправлен на следующем шаге.
Выполните следующие действия в консоль управления платформы приложений Red Hat JBoss Enterprise, чтобы отправить javaee-café.war в репозиторий содержимого.
1. На вкладке "Развертывания" консоль управления Red Hat JBoss EAP выберите репозиторий контента на панели навигации.
2. Выберите " Добавить " и выберите " Отправить содержимое".
3. Используйте средство выбора файла браузера, чтобы выбрать файл javaee-café.war .
4. Выберите Далее.
5. Примите значения по умолчанию на следующем экране и нажмите кнопку Готово.
6. Выберите "Просмотреть содержимое".
Чтобы развернуть приложение в main-server-groupследующих шагах, выполните следующие действия.
1. В репозитории содержимого выберите javaee-café.war.
2. Откройте раскрывающееся меню и выберите "Развернуть".
3. Выберите main-server-group в качестве группы серверов для развертывания javaee-café.war.
4. Выберите "Развернуть" , чтобы начать развертывание. Вы увидите уведомление, аналогичное следующему снимку экрана:

Теперь вы завершите развертывание приложения Java EE. Выполните следующие действия, чтобы получить доступ к приложению и проверить все параметры:

Используйте следующую команду, чтобы получить общедоступный IP-адрес Шлюз приложений Azure. Замените заполнитель <resource-group-name> именем группы ресурсов, в которой развернут кластер JBoss EAP.
```
az network public-ip show \
    --resource-group <resource-group-name> \
    --name gwip \
    --query '[ipAddress]' \
    --output tsv
```
Скопируйте выходные данные, которые являются общедоступным IP-адресом развернутого Шлюз приложений Azure.
Откройте веб-браузер, подключенный к Интернету.
Перейдите к приложению с URL-адресом http://<gateway-public-ip-address>/javaee-cafe. Замените заполнитель <gateway-public-ip-address> общедоступным IP-адресом Шлюз приложений Azure, скопированной ранее.
Попробуйте добавить и удалить кофе.

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

Чтобы избежать расходов за использование Azure, необходимо удалить ненужные ресурсы. Если вам больше не нужен кластер JBoss EAP, развернутый на виртуальных машинах Azure, отмените регистрацию серверов JBoss EAP и удалите ресурсы Azure.

Выполните следующую команду, чтобы отменить регистрацию серверов JBoss EAP и виртуальных машин из управления подписками Red Hat. Замените заполнитель <resource-group-name> именем группы ресурсов, в которой развернут кластер JBoss EAP.

# Unregister domain controller
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm-adminVM \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"

# Unregister host controllers
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm1 \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm1 \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"

Выполните следующие команды, чтобы удалить две группы ресурсов, в которых развернут кластер JBoss EAP и гибкий сервер База данных Azure для PostgreSQL. Замените заполнитель <resource-group-name> именем группы ресурсов, в которой развернут кластер JBoss EAP. Убедитесь, что переменная $RG_NAME среды задана с именем группы ресурсов, в которой развернут гибкий сервер PostgreSQL.

az group delete --name <resource-group-name> --yes --no-wait
az group delete --name $RG_NAME --yes --no-wait

Следующие шаги

Дополнительные сведения о вариантах развертывания JBoss EAP в Azure:

Изучение JBoss EAP в Azure