Как установить WildFly Java Application Server с обратным прокси Nginx на Ubuntu 20.04

WildFly или ранее известный как JBoss AS — это легковесная реализация контейнера JEE (Java Enterprise Edition). Его гибкая среда выполнения приложений написана на Java и помогает вам создавать фантастические приложения.

WildFly — это многоплатформенная среда выполнения приложений, работающая на операционных системах Linux, macOS и Windows. Созданный компанией JBoss Inc, в 2006 году он был приобретен компанией RedHat и стал WildFly.

В этом руководстве мы покажем вам, как установить WildFly на последней версии Ubuntu 20.04. Мы установим последнюю версию WildFly 20, включим административную консоль для WildFly, создадим администратора WildFly и настроим Nginx как обратный прокси для WildFly.

Предварительные требования

Для этого руководства мы установим WildFly на последнем сервере Ubuntu 20.04 FocalFossa с 2 ГБ ОЗУ, 50 ГБ свободного дискового пространства и 2 ЦП.

Что мы будем делать?

Установить Java OpenJDK 11
Добавить нового пользователя и скачать WildFly
Базовая конфигурация WildFly
Включить административную консоль WildFly
Настроить администратора для WildFly
Настроить Nginx как обратный прокси для WildFly
Тестирование

Шаг 1 - Установка Java OpenJDK

Сначала мы установим Java OpenJDK на сервер Ubuntu 20.04. И мы будем использовать Java OpenJDK 11 для нашей установки WildFly, которая является версией по умолчанию для пакетов Java в репозитории Ubuntu 20.04.

Обновите все репозитории пакетов и установите Java OpenJDK, используя команду apt ниже.

sudo apt update  
sudo apt install default-jdk

После завершения установки проверьте версию Java, используя следующую команду.

java -version

Ниже приведен результат, который вы получите.

openjdk version "11.0.7" 2020-04-14  
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)  
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)

Таким образом, установка Java OpenJDK на Ubuntu 20.04 завершена.

Шаг 2 - Добавить нового пользователя и скачать WildFly

На этом этапе мы создадим нового системного пользователя и группу ‘wildfly’ и загрузим исходный код wildfly в директорию ‘/opt/wildfly’.

Теперь создайте нового пользователя и группу с именем ‘wildfly’, используя команды ниже.

groupadd -r wildfly  
useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Далее перейдите в директорию ‘/opt’ и скачайте исходный код wildfly, используя команду wget, как показано ниже.

cd /opt/  
wget -q wget https://download.jboss.org/wildfly/20.0.1.Final/wildfly-20.0.1.Final.tar.gz

Исходный код wildfly был загружен.

Теперь извлеките исходный код wildfly и переименуйте извлеченную директорию в ‘wildfly’.

tar -xf wildfly-20.0.1.Final.tar.gz  
mv wildfly-20.0.1.Final wildfly

После этого измените владельца директории ‘wildfly’ на пользователя и группу ‘wildfly’.

chown -RH wildfly:wildfly /opt/wildfly

Таким образом, директория установки wildfly находится в директории ‘/opt/wildfly’. Служба wildfly будет работать под новым пользователем с именем ‘wildfly’, которого мы только что создали.

Создание нового пользователя и загрузка исходного кода WildFly

Шаг 3 - Базовая конфигурация WildFly

После загрузки исходного кода wildfly мы настроим wildfly на системе Ubuntu.

Создайте новую конфигурационную директорию ‘/etc/wildfly’ и скопируйте образец конфигурации ‘wildfly.conf’ в нее.

mkdir -p /etc/wildfly  
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

Далее скопируйте файл службы ‘wildfly.service’ в директорию ‘/etc/systemd/system’.

cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/

После этого скопируйте образец скрипта запуска wildfly в директорию ‘/opt/wildfly/bin’ и сделайте его исполняемым.

cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/  
chmod +x /opt/wildfly/bin/*.sh

Теперь перезагрузите менеджер systemd, чтобы применить новый файл ‘wildfly.service’.

systemctl daemon-reload

Запустите службу wildfly и добавьте ее в автозагрузку системы.

systemctl start wildfly  
systemctl enable wildfly

Служба wildfly запущена и работает на системе Ubuntu с конфигурацией по умолчанию.

Базовая конфигурация WildFly

Проверьте службу wildfly, используя следующую команду.

ss -plnt  
systemctl status wildfly

И вы получите результат, как показано ниже.

Запуск WildFly как службы Systemd

Как видно, wildfly работает как служба systemd на порту TCP по умолчанию ‘8080’ на системе Ubuntu.

Шаг 4 - Включить административную консоль WildFly

На этом этапе мы настроим wildfly для работы на локальном IP-адресе ‘127.0.0.1’ и включим его административную консоль. Мы отредактируем конфигурацию wildfly ‘wildfly.conf’, скрипт запуска wildfly ‘launch.sh’ и файл службы wildfly ‘wildfly.service’.

Отредактируйте конфигурацию wildfly ‘/etc/wildfly/wildfly.conf’, используя редактор vim.

vim /etc/wildfly/wildfly.conf

Теперь измените значение ‘WILDFLY_BIND’ на локальный IP-адрес ‘127.0.0.1’.

WILDFLY_BIND=127.0.0.1

Чтобы включить административную консоль wildfly, добавьте конфигурацию ‘WILDFLY_CONSOLE_BIND’ ниже.

WILDFLY_CONSOLE_BIND=127.0.0.1

Сохраните и закройте.

Далее отредактируйте скрипт запуска для wildfly ‘/opt/wildfly/bin/launch.sh’, используя редактор vim.

vim /opt/wildfly/bin/launch.sh

В строках ‘domain.sh‘ и ‘standalone.sh‘ добавьте дополнительный параметр для включения административной консоли wildfly, как показано ниже.

if [[ "$1" == "domain" ]]; then  
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4  
else  
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4  
fi

Сохраните и закройте.

Далее отредактируйте файл службы по умолчанию для wildfly ‘/etc/systemd/system/wildfly.service’, используя редактор vim.

vim /etc/systemd/system/wildfly.service

В строке ‘ExecStart=/opt/wildfly/bin/launch.sh….‘ добавьте параметр ‘$WILDFLY_CONSOLE_BIND‘, как показано ниже.

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

Сохраните и закройте.

Теперь перезагрузите менеджер systemd и перезапустите службу wildfly.

systemctl daemon-reload  
systemctl restart wildfly

Включение административной консоли WildFly

Служба wildfly работает с включенной административной консолью, проверьте, используя команду ниже.

ss -plnt  
systemctl status wildfly

Ниже приведен результат, который вы получите.

Проверка порта и службы WildFly

Таким образом, wildfly работает на локальном IP-адресе ‘127.0.0.1‘ с портом TCP по умолчанию ‘8080‘, и административная консоль wildfly включена на порту TCP ‘9990‘.

Шаг 5 - Настройка администратора WildFly

На этом этапе мы создадим нового пользователя для управления wildfly, используя скрипт ‘add-user.sh’, предоставленный wildfly.

Запустите скрипт wildfly ‘add-user.sh’, как показано ниже.

sh /opt/wildfly/bin/add-user.sh

Для типа пользователя введите ‘a‘, чтобы создать пользователя управления (администратора для управления wildfly).

Какой тип пользователя вы хотите добавить?   
 a) Пользователь управления (mgmt-users.properties)   
 b) Пользователь приложения (application-users.properties)  
(a): a

Теперь введите ваше имя пользователя и пароль, убедитесь, что используете надежный пароль.

Введите данные нового пользователя для добавления.  
Используя область 'ManagementRealm', как обнаружено из существующих файлов свойств.  
Имя пользователя : hakase  
Рекомендации по паролю приведены ниже. Чтобы изменить эти ограничения, отредактируйте файл конфигурации add-user.properties.  
 - Пароль должен отличаться от имени пользователя  
 - Пароль не должен быть одним из следующих ограниченных значений {root, admin, administrator}  
 - Пароль должен содержать не менее 8 символов, 1 алфавитный символ(ов), 1 цифру(ры), 1 неалфавитный символ(ов)  
Пароль :   
Повторите пароль :

Для группы нового пользователя просто нажмите ‘Enter‘, чтобы продолжить.

В какие группы вы хотите, чтобы этот пользователь принадлежал? (Пожалуйста, введите список, разделенный запятыми, или оставьте пустым для отсутствия)[  ]:

Далее введите ‘yes‘, чтобы добавить вашего пользователя в ‘ManagementRealm‘ на wildfly.

Скоро добавлю пользователя 'hakase' для области 'ManagementRealm'  
Это правильно yes/no? yes  
Добавлен пользователь 'hakase' в файл '/opt/wildfly/standalone/configuration/mgmt-users.properties'  
Добавлен пользователь 'hakase' в файл '/opt/wildfly/domain/configuration/mgmt-users.properties'  
Добавлен пользователь 'hakase' с группами в файл '/opt/wildfly/standalone/configuration/mgmt-groups.properties'  
Добавлен пользователь 'hakase' с группами в файл '/opt/wildfly/domain/configuration/mgmt-groups.properties'

Введите ‘yes‘, чтобы включить вашего пользователя как процесс для управления мастер-слейв контроллером хоста wildfly.

Этот новый пользователь будет использоваться для одного процесса AS для подключения к другому процессу AS?   
например, для контроллера слейва, подключающегося к мастеру, или для удаленного подключения для вызовов EJB от сервера к серверу.   
yes/no? yes  
Чтобы представить пользователя, добавьте следующее к определению server-identities

Таким образом, пользователь администратора и управления для wildfly был создан.

Шаг 6 - Настройка Nginx как обратного прокси для WildFly

На этом этапе мы установим и настроим Nginx как обратный прокси для wildfly на системе Ubuntu.

Установите пакеты Nginx, используя команду apt ниже.

sudo apt install nginx -y

После завершения установки перейдите в директорию конфигурации ‘/etc/nginx/‘.

cd /etc/nginx/

Создайте новый файл ‘proxy_headers.conf’ в директории ‘/etc/nginx/conf.d’, используя редактор vim.

vim conf.d/proxy_headers.conf

Вставьте следующую конфигурацию.

proxy_set_header Host $host;  
proxy_set_header X-Forwarded-Proto $scheme;  
add_header Front-End-Https on;  
add_header Cache-Control no-cache;

Сохраните и закройте.

Далее создайте новую конфигурацию виртуального хоста для wildfly в директории ‘/etc/nginx/sites-available’.

vim sites-available/wildfly

Измените IP-адрес на свой и вставьте конфигурацию в него.

server {  
  listen           80;  
  server_name     SERVER-IP;  
  
  location / {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:8080;  
  }  
  
  location /management {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990/management;  
  }  
  
  location /console {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990/console;  
  }  
  
  location /logout {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990/logout;  
  }  
  
  location /error {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990;  
  }  
  
}

Сохраните и закройте.

Далее активируйте виртуальный хост wildfly и проверьте конфигурацию Nginx.

ln -s /etc/nginx/sites-available/wildfly /etc/nginx/sites-enabled/  
ginx -t

Теперь убедитесь, что ошибок нет, затем перезапустите службу Nginx.

systemctl restart nginx

Таким образом, установка и настройка Nginx как обратного прокси для wildfly завершена.

Настройка Nginx как обратного прокси для WildFly

Шаг 7 - Тестирование

Откройте веб-браузер и введите IP-адрес вашего сервера в адресной строке.

http://192.168.1.50/

Теперь вы получите страницу индекса wildfly по умолчанию, как показано ниже.

Индекс WildFly по умолчанию

Далее получите доступ к административной консоли wildfly по URL-адресу ‘/console’, как показано ниже.

http://192.168.1.50/console/

Войдите, используя своего администратора wildfly и пароль.

Вход в админку WildFly

Теперь вы получите панель управления администратора wildfly, как показано ниже.

Панель управления консоли администратора WildFly

Таким образом, установка wildfly с обратным прокси Nginx на сервере Ubuntu 20.04 была успешно завершена.

Шаг 1 - Установка Java OpenJDK

Шаг 2 - Добавить нового пользователя и скачать WildFly

Шаг 3 - Базовая конфигурация WildFly

Шаг 4 - Включить административную консоль WildFly

Шаг 5 - Настройка администратора WildFly

Шаг 6 - Настройка Nginx как обратного прокси для WildFly

Шаг 7 - Тестирование

Get new posts in your inbox