WildFly (JBoss) - это бесплатный, кросс-платформенный сервер приложений с открытым исходным кодом, который в настоящее время разрабатывается компанией Red Hat. WildFly написан на Java и помогает создавать отличные приложения. Благодаря его подключаемым подсистемам вы можете настроить приложение так, как вам нужно. В этой статье мы объясним, как администратор Debian может установить и настроить Wildfly в своей системе.
Установка WildFly
Администратор Debian/(пользователь sudo) может установить стабильный сервер приложений WildFly, тщательно выполнив следующие шаги:
Шаг 1: Откройте Терминал или подключитесь к серверу по SSH
Для установки и настройки WildFly мы будем использовать командную строку Debian, Терминал. Вы можете открыть приложение Terminal через поиск Application Launcher следующим образом:
Шаг 2: Обновление индекса репозитория
Для того чтобы установить последнюю доступную версию программы из интернет-репозиториев, индекс вашего локального репозитория должен соответствовать им. Выполните следующую команду от имени sudo, чтобы обновить индекс локального репозитория:
| 1 | sudo apt-get update |
Обратите внимание, что только авторизованный пользователь может добавлять, удалять и настраивать программное обеспечение в Debian.
Шаг 3: Установите пакет OpenJDK из APT
Для установки OpenJDK из репозиториев APT выполните следующую команду от имени sudo:
| 1 | sudo apt-get install default-jdk |
Система может спросить у вас пароль для sudo, а также предложить вам опцию Y/n для продолжения установки. Введите Y и нажмите Enter.
Шаг 4: Создание пользователя и группы для WildFly
В качестве предварительного шага необходимо создать пользователя и группу, которые впоследствии будут использоваться для запуска службы WildFly.
Выполните следующую команду для создания новой группы:
| 1 | sudo groupadd -r wildfly |
Выполните следующую команду, которая будет авторизована для запуска службы в /opt/wildfly
| 1 | sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly |
Во время установки WildFly вам придется использовать некоторые длинные команды. Вместо того чтобы набирать команду, вы можете скопировать ее отсюда и вставить в Терминал с помощью клавиш Ctrl+Shift+V или с помощью опции Вставить из меню правой кнопки мыши.
Шаг 5: Скачайте установочный файл Wildfly
Сейчас мы будем загружать tar.gz для WildFly с официального сайта JBoss.
Во-первых, давайте создадим переменную для определения номера версии WildFly, которую мы хотим загрузить.
| 1 | Version_Number=26.1.2.Final |
Я хочу загрузить версию 26.1.2.Final на мою систему. Эту переменную можно использовать во всех командах, где нужно указать версию WildFly.
Выполните следующую команду для загрузки tar.gz файла в папку /tmp вашего Debian.
| 1 | wget https://github.com/wildfly/wildfly/releases/download/$Version_Number/wildfly-$Version_Number.tar.gz -P /tmp |
Шаг 6: Распакуйте файл WildFly tar.gz в папку /opt
Программное обеспечение WildFly будет установлено после того, как вы извлечете скачанный файл .tar.gz. Выполните следующую команду от имени sudo, чтобы извлечь файл в папку /opt.
| 1 | sudo tar xf /tmp/wildfly-$Version_Number.tar.gz -C /opt/ |
Шаг 7: Создайте символическую ссылку, указывающую на каталог установки WildFly
Выполните следующую команду, чтобы создать символическую ссылку с именем wildfly. Эта ссылка будет указывать на каталог установки Wildfly.
| 1 | sudo ln -s /opt/wildfly-$Version_Number /opt/wildfly |
Шаг 8: Предоставьте доступ группе и пользователю wildfly
Пользователю и группе WildFly необходимо право собственности на каталог установки WildFly, чтобы они могли получить доступ и запустить WildFly.
Для этого выполните следующую команду:
| 1 | sudo chown -RH wildfly: /opt/wildfly |
Шаг 9: Настройка Wildfly для запуска в качестве службы
Пожалуйста, внимательно выполните эти шаги, чтобы настроить WildFly для запуска в качестве службы Systemd:
1. Создайте каталог, в который мы скопируем файл wildfly.conf. Этот файл является частью пакета WildFly, который вы скачали и установили.
| 1 | sudo mkdir -p /etc/wildfly |
2. Скопируйте файл wildfly.conf из файлов пакета во вновь созданный каталог с помощью следующей команды:
| 1 | sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/ |
3. Откройте файл конфигурации в редакторе Nano с помощью следующей команды:
sudo nano /etc/wildfly/wildfly.conf
Конечно, вы можете использовать любой из ваших любимых текстовых редакторов.
Вот как выглядит файл:
Этот файл пока включает в себя базовую конфигурацию для автономной системы. Позже мы объясним, как редактировать этот файл для индивидуальной конфигурации, например, при попытке удаленного доступа к административной консоли.
4. Далее скопируйте сценарий launch.sh из пакета WildFly в папку /opt/wildfly/bin/:
| 1 | sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/ |
Также сделайте скрипт исполняемым с помощью следующей команды:
| 1 | sudo sh -c 'chmod +x /opt/wildfly/bin/*.sh' |
5. Последний файл, который необходимо скопировать, это файл wildfly.service unit в папку служб вашей системы /etc/systemd/system
| 1 | sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/ |
6. Наконец, необходимо сообщить системе, что вы добавили новый служебный файл. Это можно сделать, перезагрузив демон systemctl:
| 1 | sudo systemctl daemon-reload |
Теперь вы готовы запустить службу WildFly от имени администратора.
Шаг 10: Запустите службу WildFly
Теперь служба WildFly может быть запущена, как и любая другая служба, распознаваемая Debian.
Выполните следующую команду от имени sudo, чтобы запустить службу:
| 1 | sudo systemctl start wildfly |
Вы можете убедиться, что всё работает хорошо, проверив статус службы следующим образом:
| 1 | sudo systemctl status wildfly |
Статус Active, как выделено выше, подтверждает, что служба запущена и работает.
Еще одна вещь, которая поможет вам, это включение службы wildfly при загрузке:
| 1 | sudo systemctl enable wildfly |
Настройка Wildfly
Теперь, когда мы установили WildFly и заставили его работать в качестве службы, пришло время выполнить некоторые настройки. В основном они включают в себя:
- Настройка вашего брандмауэра
- Создание безопасного администратора WildFly
- Проверка успешной установки
- Доступ к административной консоли WildFly локально и удаленно.
Пожалуйста, выполняйте эти шаги один за другим, чтобы обеспечить надежное использование портала WildFly.
Шаг 1: Разрешить трафик на порту 8080
Если вы хотите, чтобы к вашему серверу WildFly можно было получить удаленный доступ, вам нужно разрешить трафик на порту 8080. Если в вашем Debian по умолчанию не установлено приложение брандмауэра UFW, выполните следующую команду, чтобы установить его в вашей системе:
| 1 | sudo apt-get install ufw |
Для этого выполните следующую команду:
| 1 | sudo ufw allow 8080/tcp |
Шаг 2: Создание администратора WildFly
На этом шаге мы создадим и настроим пользователя WildFly. Этот пользователь будет управляющим пользователем/администратором для административной веб-консоли и CLI, который можно использовать удаленно.
Выполните следующую команду, чтобы запустить сценарий добавления пользователя из каталога WildFly:
| 1 | sudo /opt/wildfly/bin/add-user.sh |
Дальнейшая процедура практически не требует пояснений, но тем не менее мы вас проинструктируем.
Сначала скрипт спросит вас, хотите ли вы создать пользователя управления или пользователя приложения:
Просто нажмите Enter, чтобы указать, что вы хотите создать управляющего пользователя.
Затем сценарий предложит вам добавить подробную информацию о новом пользователе. Сюда входит добавление имени пользователя нового администратора и указание, а затем повторный ввод пароля, как показано ниже:
На изображении выше видно, что я создал пользователя под именем "admin".
Теперь этот пользователь может выполнять административные функции на WildFly.
Шаг 3: Проверка успешной установки WindFly
Теперь давайте проверим, работает ли наш сервер WindFly. Откройте браузер и введите следующий URL:a
http://<ваш_домен_или_IP_адрес>:8080
Я тестирую настройку на своем локальном хосте:
http://localhost:8080/
Если вы видите что-то похожее на то, что показано выше, мы можем заверить вас, что ваш экземпляр WildFly запущен и работает.
Как открыть административную консоль через веб-интерфейс?
Введите следующий URL в браузере, чтобы открыть административную консоль через локальную систему:
http://localhost:9990/console
Укажите имя пользователя и пароль пользователя управления, который вы создали в Шаге 2 "Настройка WildFly". После нажатия кнопки OK консоль откроется следующим образом:
Удаленное управление административной консолью
Для того чтобы получить удаленный доступ к административной консоли, необходимо внести небольшие изменения в три файла WildFly.
1. Откройте файл wildfly.conf с помощью следующей команды:
| 1 | sudo nano /etc/wildfly/wildfly.conf |
Добавьте следующие строки в конец файла:
| 1 2 | # Адрес консоли для привязки WILDFLY_CONSOLE_BIND=0.0.0.0 |
Вот как должен выглядеть файл:
Выйдите из файла через Ctrl+X, а затем сохраните изменения, нажав y, а затем Enter.
2. Откройте файл сценария запуска .sh с помощью следующей команды:
| 1 | sudo nano /opt/wildfly/bin/launch.sh |
Измените выделенные строки на следующие:
| 1 2 3 | $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4 else $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4 |
Выйдите из файла через Ctrl+X, а затем сохраните изменения, нажав y, а затем Enter.
После этого перезапустите службу WildFly с помощью следующей команды:
| 1 | sudo systemctl restart wildfly |
3. Наконец, отредактируйте файл wildfly.service с помощью следующей команды:
| 1 | sudo nano /etc/systemd/system/wildfly.service |
Замените выделенную строку на следующую:
| 1 | ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND |
Поскольку мы изменили файл сервисного блока, давайте уведомим об этом систему с помощью следующей команды:
| 1 | sudo systemctl daemon-reload |
Также перезапустите службу WildFly с помощью следующей команды:
| 1 | sudo systemctl restart wildfly |
Теперь вы можете получить доступ к консоли, введя следующую консоль на удаленной машине:
http://<ваш_домен_или_IP_адрес>:9990/console
Пожалуйста, убедитесь, что порт 9990 открыт для трафика на вашем брандмауэре.
Как открыть административную консоль CLI
Откройте терминал Debian и переключитесь в папку /opt/wildfly/bin, откуда мы будем запускать сценарий CLI:
| 1 | cd /opt/wildfly/bin/ |
Затем введите следующую команду для запуска сценария CLI административной консоли WildFly:
| 1 | /jboss-cli.sh --connect |
Теперь вы находитесь в консоли "[standalone@localhost:9990 /]".
Введите "help", чтобы узнать, что вы можете здесь делать.
Я проверю номер версии, введя команду "version":
Вы успешно установили и настроили WildFly в своей системе. Вы также знаете, как настроить WildFly и вашу систему так, чтобы вы могли получить удаленный доступ к административной консоли.
