Развертывание приложения Java с помощью Open Liberty или WebSphere Liberty в приложениях контейнеров Azure
В этой статье показано, как запустить Open Liberty или WebSphere Liberty в приложениях контейнеров Azure. В этой статье выполняются следующие действия:
- Запуск приложения Java, Java EE, Jakarta EE или MicroProfile в среде выполнения Open Liberty или WebSphere Liberty.
- Создайте образ Docker приложения с помощью образов контейнеров Liberty.
- Разверните контейнерное приложение в приложениях контейнеров Azure.
Дополнительные сведения об Open Liberty см. на странице проекта Open Liberty. Дополнительные сведения об IBM WebSphere Liberty см. на странице продукта WebSphere Liberty.
Эта статья предназначена для быстрого развертывания. Прежде чем перейти к производству, вы должны исследовать Настройка Свободы.
Если вы заинтересованы в предоставлении отзывов или тесной работе с сценариями миграции с помощью группы разработчиков, разрабатывающей веб-sphere в решениях Azure, заполните этот короткий опрос по миграции WebSphere и включите контактные данные. Команда руководителей программ, архитекторов и инженеров будет быстро связаться с вами, чтобы начать тесное сотрудничество.
Необходимые компоненты
- Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начать работу.
Если вы выполняете команды в этом руководстве локально (вместо Azure Cloud Shell):
- Подготовьте локальный компьютер с установленным windows или Linux.
- Установите реализацию Java SE версии 17 или более поздней (например, Eclipse Open J9).
- Установите Maven 3.5.0 или более поздней версии.
- Установите Docker для своей операционной системы.
Подготовка среды к работе с Azure CLI
Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.
Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.
Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.
Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.
- Для этой статьи требуется по крайней мере версия 2.53.0 Azure CLI. Если вы используете Azure Cloud Shell, последняя версия уже установлена. Команды Azure CLI можно запускать в Bash или Azure PowerShell локально или в Azure Cloud Shell.
Вход в Azure
Если вы еще этого не сделали, войдите в подписку Azure с помощью команды az login и следуйте инструкциям на экране.
az login
Примечание.
Большинство команд Azure CLI можно выполнять в PowerShell так же, как и в Bash. Разница существует только при использовании переменных. В следующих разделах разница рассматривается на разных вкладках при необходимости.
Если у вас несколько клиентов Azure, связанных с учетными данными Azure, необходимо указать, в какой клиент вы хотите войти. Это можно сделать с --tenant помощью параметра , например az login --tenant contoso.onmicrosoft.com.
Если у вас есть несколько подписок в одном клиенте, убедитесь, что вы выполнили вход с помощью того, который вы планируете использовать az account set --subscription <subscription-id>.
Создание или изменение группы ресурсов
Группа ресурсов Azure — это логическая группа, в которой развертываются и управляются ресурсы Azure.
Создайте группу ресурсов java-liberty-project в расположении eastus с помощью команды az group create. Эта группа ресурсов используется позже для создания экземпляра Реестр контейнеров Azure (ACR) и экземпляра приложений контейнеров Azure.
export RESOURCE_GROUP_NAME=java-liberty-project
az group create --name $RESOURCE_GROUP_NAME --location eastus
Создание экземпляра ACR
Создайте экземпляр ACR с помощью команды az acr create. В следующем примере создается экземпляр ACR с именем youruniqueacrname. Убедитесь, что имя youruniqueacrname является уникальным в Azure.
export REGISTRY_NAME=youruniqueacrname
az acr create \
--resource-group $RESOURCE_GROUP_NAME \
--name $REGISTRY_NAME \
--sku Basic \
--admin-enabled
Через некоторое время вы увидите выходные данные JSON, содержащие следующие строки:
"provisioningState": "Succeeded",
"publicNetworkAccess": "Enabled",
"resourceGroup": "java-liberty-project",
Подключение к экземпляру ACR
Перед отправкой образа в экземпляр ACR необходимо войти в экземпляр ACR. Если вы решили выполнить команды локально, убедитесь, что управляющая программа Docker запущена, и выполните следующие команды, чтобы проверить подключение:
export ACR_LOGIN_SERVER=$(az acr show \
--resource-group $RESOURCE_GROUP_NAME \
--name $REGISTRY_NAME \
--query 'loginServer' \
--output tsv)
export ACR_USER_NAME=$(az acr credential show \
--resource-group $RESOURCE_GROUP_NAME \
--name $REGISTRY_NAME \
--query 'username' \
--output tsv)
export ACR_PASSWORD=$(az acr credential show \
--resource-group $RESOURCE_GROUP_NAME \
--name $REGISTRY_NAME \
--query 'passwords[0].value' \
--output tsv)
docker login $ACR_LOGIN_SERVER -u $ACR_USER_NAME -p $ACR_PASSWORD
Если вы успешно вошли в экземпляр ACR, вы увидите Login Succeeded в конце выходных данных команды.
Создать среду
Среда в Azure Container Apps создает безопасную границу вокруг группы приложений-контейнеров. Развертываемые в одной среде приложения-контейнеры развертываются в одной виртуальной сети и записывают журналы в одну рабочую область Log Analytics. Используйте команду az containerapp env create для создания среды. В следующем примере создается среда с именем youracaenvname:
export ACA_ENV=youracaenvname
az containerapp env create \
--resource-group $RESOURCE_GROUP_NAME \
--location eastus \
--name $ACA_ENV
Если вам будет предложено установить расширение, ответ Y.
Через некоторое время вы увидите выходные данные JSON, содержащие следующие строки:
"provisioningState": "Succeeded",
"type": "Microsoft.App/managedEnvironments"
"resourceGroup": "java-liberty-project",
Создание базы данных SQL Azure
В этом разделе вы создадите База данных SQL Azure отдельную базу данных для использования с приложением.
Создайте одну базу данных в База данных SQL Azure, выполнив действия Azure CLI в кратком руководстве. Создание одной базы данных База данных SQL Azure. Выполните шаги до, но не включая запрос к базе данных. Выполните следующие действия, как описано в статье, а затем вернитесь к этому документу после создания и настройки сервера базы данных:
Когда вы достигнете раздела "Задать значения параметров" краткого руководства, выходные данные и сохраните значения переменных в примере кода, в Variable blockтом числеserverresourceGroupdatabase , , loginи .password Определите следующие переменные среды после замены <resourceGroup>заполнителей,<server><database> , и <login><password> с этими значениями.
export DB_RESOURCE_GROUP=<resourceGroup>
export DB_SERVER_NAME=<server>.database.windows.net
export DB_NAME=<database>
export DB_USER=<login>
export DB_PASSWORD=<password>
Если вы хотите протестировать приложение локально, выполните следующие действия, чтобы убедиться, что адрес IPv4 клиента разрешен для подключения:
На портале найдите и выберите элемент Базы данных SQL, а затем в открывшемся списке выберите нужную базу данных.
Выберите Обзор.
Убедитесь, что вкладка "Начало работы " выбрана в середине страницы.
В разделе "Настройка доступа" выберите "Настроить".
Выберите " Добавить адрес IPv4 клиента".
Выберите Сохранить.
Правила брандмауэра можно найти и настроить на вкладке "Сеть" и на вкладке "Общедоступный доступ".
Настройка и сборка образа приложения
Чтобы развернуть и запустить приложение Liberty в приложениях контейнеров Azure, контейнеризируйте приложение как образ Docker с помощью образов контейнеров Open Liberty или образов контейнеров WebSphere Liberty.
Выполните действия, описанные в этом разделе, чтобы развернуть пример приложения в среде выполнения Liberty. Эти действия используют Maven.
Получение приложения для изменения
Используйте следующие команды, чтобы подготовить пример кода для этого руководства. Пример размещен на сайте GitHub.
git clone https://github.com/Azure-Samples/open-liberty-on-aca.git
cd open-liberty-on-aca
git checkout 20231026
Если появится сообщение о detached HEAD состоянии, это сообщение безопасно игнорировать. Это просто означает, что вы проверили тег.
В этой статье используется java-app. Ниже приведена структура файла приложения:
java-app
├─ src/main/
│ ├─ liberty/config/
│ │ ├─ server.xml
│ ├─ java/
│ ├─ resources/
│ ├─ webapp/
├─ Dockerfile
├─ Dockerfile-wlp
├─ pom.xml
Каталоги java, java и webapp содержат исходный код примера приложения. В коде объявлен и используется источник данных с именем jdbc/JavaEECafeDB.
В корневом каталоге java-app есть два файла для создания образа приложения с помощью Open Liberty или WebSphere Liberty.
В каталоге liberty/config файл server.xml используется для настройки подключения базы данных для кластера Open Liberty и WebSphere Liberty.
Сборка проекта
Запустите сборку приложения с помощью следующей команды.
cd <path-to-your-repo>/java-app
mvn clean install
Если сборка выполнена успешно, вы увидите выходные данные, аналогичные приведенным ниже в конце сборки.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 22.651 s
[INFO] Finished at: 2023-10-26T18:58:40-04:00
[INFO] ------------------------------------------------------------------------
Если вы не видите эти выходные данные, устраните и устраните проблему перед продолжением.
(Необязательно) Локальное тестирование проекта
Теперь можно выполнить и протестировать проект локально перед развертыванием в Azure. Для удобства используйте .liberty-maven-plugin Дополнительные сведения о liberty-maven-plugin см. в статье Создание веб-приложения с помощью Maven. Для приложения можно сделать что-то подобное с помощью любого другого механизма, например локальной интегрированной среды разработки.
Примечание.
Если выбрано развертывание базы данных без сервера, убедитесь, что база данных SQL не вошла в режим приостановки. Одним из способов этого является вход в редактор запросов базы данных, как описано в кратком руководстве. Используйте редактор запросов портал Azure (предварительная версия) для запроса База данных SQL Azure.
Запустите приложение с помощью команды
liberty:run.liberty:runиспользует переменные среды, связанные с базой данных, определенные на предыдущем шаге.cd <path-to-your-repo>/java-app mvn liberty:runУбедитесь, что приложение работает правильно. В случае успеха в выходных данных команды должно появиться примерно такое сообщение:
[INFO] [AUDIT] CWWKZ0003I: The application javaee-cafe updated in 1.930 seconds.. В браузере перейдите по адресуhttp://localhost:9080/, чтобы убедиться, что приложение доступно и все функции работают.Нажмите клавиши CTRL+C, чтобы остановиться.
Создание образа
Примечание.
Если вы решили использовать среду Bash в Azure Cloud Shell, используйте az acr build команду для создания и отправки образа из файла Docker. Дополнительные сведения см. в разделе "Сборка и отправка образа" из раздела Dockerfile в кратком руководстве. Создание и запуск образа контейнера с помощью Реестр контейнеров Azure задач. После этого перейдите непосредственно в раздел "Развертывание приложения в приложениях контейнеров Azure". Если вы решили выполнить команды локально, используйте следующее руководство.
Теперь можно выполнить docker buildx build команду для сборки образа, как показано в следующем примере:
cd <path-to-your-repo>/java-app
# If you are running with Open Liberty
docker buildx build --platform linux/amd64 -t javaee-cafe:v1 --pull --file=Dockerfile .
# If you are running with WebSphere Liberty
docker buildx build --platform linux/amd64 -t javaee-cafe:v1 --pull --file=Dockerfile-wlp .
(Необязательно) Тестирование образа Docker локально
Теперь можно выполнить следующие действия для локального тестирования образа Docker перед развертыванием в Azure:
Запустите образ с помощью следующей команды. Эта команда использует переменные среды, связанные с базой данных, определенные ранее.
docker run -it --rm -p 9080:9080 \ -e DB_SERVER_NAME=${DB_SERVER_NAME} \ -e DB_NAME=${DB_NAME} \ -e DB_USER=${DB_USER} \ -e DB_PASSWORD=${DB_PASSWORD} \ javaee-cafe:v1После запуска контейнера перейдите
http://localhost:9080/в браузер, чтобы получить доступ к приложению.Нажмите клавиши CTRL+C, чтобы остановиться.
Отправка образа в ACR
Затем отправьте созданный образ в ACR, созданный на предыдущих шагах.
Если вы еще этого не сделали, используйте следующую команду, чтобы войти в ACR:
docker login -u ${ACR_USER_NAME} -p ${ACR_PASSWORD} ${ACR_LOGIN_SERVER}
Используйте следующие команды для тега и отправки образа контейнера:
docker tag javaee-cafe:v1 ${ACR_LOGIN_SERVER}/javaee-cafe:v1
docker push ${ACR_LOGIN_SERVER}/javaee-cafe:v1
Развертывание приложения в приложениях контейнеров Azure
Используйте следующие команды, чтобы создать экземпляр Azure Container Apps для запуска приложения после извлечения образа из ACR. В этом примере создается экземпляр приложений контейнеров Azure с именем youracainstancename.
export ACA_NAME=youracainstancename
az containerapp create \
--resource-group $RESOURCE_GROUP_NAME \
--name $ACA_NAME \
--image ${ACR_LOGIN_SERVER}/javaee-cafe:v1 \
--environment $ACA_ENV \
--registry-server $ACR_LOGIN_SERVER \
--registry-username $ACR_USER_NAME \
--registry-password $ACR_PASSWORD \
--target-port 9080 \
--env-vars \
DB_SERVER_NAME=${DB_SERVER_NAME} \
DB_NAME=${DB_NAME} \
DB_USER=${DB_USER} \
DB_PASSWORD=${DB_PASSWORD} \
--ingress 'external'
Успешные выходные данные — это объект JSON, включая свойство "type": "Microsoft.App/containerApps".
Тестирование приложения
Чтобы получить полный URL-адрес для доступа к приложению, используйте следующую команду:
echo https://$(az containerapp show \
--resource-group $RESOURCE_GROUP_NAME \
--name $ACA_NAME \
--query properties.configuration.ingress.fqdn \
--output tsv)
Откройте веб-браузер для доступа к URL-адресу и протестируйте приложение. На следующем снимка экрана показано работающее приложение:
Очистка ресурсов
Чтобы избежать расходов за использование Azure, необходимо удалить ненужные ресурсы. Если кластер больше не нужен, используйте команду az group delete , чтобы удалить группу ресурсов, реестр контейнеров, приложения контейнеров, сервер базы данных и все связанные ресурсы.
az group delete --name $RESOURCE_GROUP_NAME --yes --no-wait
az group delete --name $DB_RESOURCE_GROUP --yes --no-wait
Затем используйте следующую команду, чтобы удалить образ контейнера с локального сервера Docker:
docker rmi -f ${ACR_LOGIN_SERVER}/javaee-cafe:v1
Следующие шаги
Дополнительные сведения о ссылках, используемых в этом руководстве, см. в следующем руководстве.
- Приложения контейнеров Azure
- Open Liberty
- Настройка сервера Open Liberty
- Подключаемый модуль Liberty Maven
- Образы контейнеров Open Liberty
- Образы контейнеров WebSphere Liberty
Сведения о возможностях запуска продуктов WebSphere в Azure см. в статье "Что такое решения для запуска семейства продуктов WebSphere в Azure?"
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по