Как установить сервер приложений GlassFish Java с обратным прокси Nginx на AlmaLinux 9

GlassFish — это бесплатная и с открытым исходным кодом реализация платформы Java EE, разработанная Eclipse. Это первая в мире реализация платформы Java EE для развертывания Java-приложений. GlassFish предоставляет масштабируемую архитектуру с поддержкой нескольких технологий Java, таких как Enterprise JavaBeans, JPA, JavaServer Faces и JMS.

Этот гид покажет вам, как установить GlassFish на сервер AlmaLinux 9 с обратным прокси Nginx. Мы также рассмотрим, как защитить GlassFish, включив аутентификацию и настройку безопасного соединения SSL/TLS для администрирования GlassFish.

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

Перед началом убедитесь, что у вас есть следующее:

Сервер AlmaLinux 9.
Непривилегированный пользователь с правами администратора.
Локальное доменное имя, указывающее на IP-адрес сервера.

Настройка зависимостей

Сначала вам нужно настроить вашу систему AlmaLinux, добавив системного пользователя, который будет использоваться для запуска GlassFish, а затем установить пакеты Java OpenJDK.

Перед установкой любого пакета создайте нового системного пользователя glassfish с помощью команды ниже. Этот пользователь будет иметь домашний каталог по умолчанию /opt/glassfish7, который будет использоваться в качестве каталога установки для GlassFish.

sudo useradd -m -d /opt/glassfish7 -U -s /bin/false glassfish

Теперь установите Java OpenJDK 21 и пакеты unzip с помощью команды ниже. Нажмите y, чтобы продолжить установку.

sudo dnf install java-21-openjdk unzip nano

установка java

После завершения установки проверьте версию Java с помощью команды ниже. Убедитесь, что у вас установлена Java 17 или 21 на вашем сервере AlmaLinux.

java --version

Загрузка пакета GlassFish

После того, как вы создали системного пользователя и установили Java, вы можете загрузить пакет GlassFish. Убедитесь, что вы посетили страницу загрузки GlassFish и скопировали ссылку на последнюю версию.

Скачайте пакет GlassFish с помощью команды wget ниже.

wget https://download.eclipse.org/ee4j/glassfish/glassfish-7.0.12.zip

После загрузки извлеките файл glassfish-7.0.12.zip в каталог /opt с помощью следующей команды unzip. Это извлечет GlassFish в каталог /opt/glassfish7.

unzip glassfish-7.0.12.zip -d /opt

Наконец, измените владельца каталога /opt/glassfish7 на пользователя glassfish. Это необходимо, потому что вы будете запускать GlassFish как системный пользователь glassfish.

sudo chown -R glassfish:glassfish /opt/glassfish7

Настройка службы systemd для GlassFish

В этом руководстве вы будете запускать GlassFish как службу systemd. Это позволит запускать GlassFish в фоновом режиме, и вы сможете легко управлять им с помощью утилиты systemctl.

Создайте новый файл службы systemd /etc/systemd/system/glassfish7.service с помощью следующей команды редактора nano.

sudo nano /etc/systemd/system/glassfish7.service

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

[Unit]  
Description = GlassFish Server v7  
After = syslog.target network.target  
  
[Service]  
User=glassfish  
ExecStart=/opt/glassfish7/bin/asadmin start-domain  
ExecReload=/opt/glassfish7/bin/asadmin restart-domain  
ExecStop=/opt/glassfish7/bin/asadmin stop-domain  
Type = forking  
  
[Install]  
WantedBy = multi-user.target

Сохраните файл и закройте редактор, когда закончите.

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

sudo systemctl daemon-reload

Затем запустите и включите GlassFish с помощью команды ниже. После запуска GlassFish должен работать на портах 8080 и 4848.

sudo systemctl start glassfish7  
sudo systemctl enable glassfish7

настройка systemd

Наконец, проверьте службу glassfish7 с помощью команды ниже. Убедитесь, что служба glassfish7 включена и работает на вашей системе.

sudo systemctl status glassfish7

проверка glassfish

Настройка администратора GlassFish

На этом этапе GlassFish работает как служба systemd на вашей системе. Теперь вам нужно подтвердить администратора для GlassFish и настроить enable-secure-admin для защиты администрирования GlassFish.

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

sudo -u glassfish /opt/glassfish7/bin/asadmin --port 4848 change-admin-password

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

После завершения процесса вы должны получить вывод ‘ Команда change-admin-password выполнена успешно ‘.

После настройки пароля администратора для GlassFish выполните следующую команду, чтобы включить функцию secure-admin. Это автоматически сгенерирует SSL/TLS сертификаты для GlassFish.

sudo -u glassfish /opt/glassfish7/bin/asadmin --port 4848 enable-secure-admin

Введите вашего администратора и пароль для GlassFish, когда будет предложено. После успешного выполнения процесса вы должны увидеть вывод ‘ Команда enable-secure-admin выполнена успешно ‘.

Наконец, перезапустите службу glassfish7, чтобы применить ваши изменения к GlassFish. После выполнения команды ваша установка GlassFish должна быть защищена, администратор с новым паролем и сгенерированными TLS сертификатами для администратора GlassFish.

sudo systemctl restart glassfish7

Запуск GlassFish с обратным прокси Nginx

В этом руководстве вы будете запускать GlassFish за обратным прокси Nginx. Поэтому теперь вам нужно установить Nginx на ваш сервер AlmaLinux, а затем создать новую конфигурацию блока сервера для обратного прокси.

Установите веб-сервер Nginx на ваш AlmaLinux с помощью команды ниже. Нажмите y, чтобы продолжить установку.

sudo dnf install nginx

установка nginx

После завершения установки создайте новую конфигурацию блока сервера /etc/nginx/conf.d/glassfish.conf с помощью следующей команды редактора nano.

sudo nano /etc/nginx/conf.d/glassfish.conf

Вставьте следующую конфигурацию, чтобы настроить обратный прокси для GlassFish, который по умолчанию работает на порту 8080. Обязательно измените доменное имя в следующем на ваше локальное доменное имя.

upstream glassfish7 {  
server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;  
}  
  
server {  
listen 80;  
server_name glassfish.howtoforge.local;  
  
location / {  
proxy_set_header X-Forwarded-Host $host;  
proxy_set_header X-Forwarded-Server $host;  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_pass http://glassfish7/;  
}  
}

Когда закончите, сохраните и выйдите из файла.

Теперь проверьте синтаксис Nginx с помощью команды ниже. Если у вас правильный синтаксис, вы должны получить вывод ‘синтаксис в порядке - тест успешен’.

sudo nginx -t

Затем запустите и включите Nginx на вашем сервере AlmaLinux с помощью команды ниже.

sudo systemctl start nginx  
sudo systemctl enable nginx

настройка nginx

После запуска проверьте службу Nginx, чтобы убедиться, что служба работает и включена.

sudo systemctl status nginx

Ниже вы должны увидеть, что служба Nginx работает и включена на AlmaLinux.

проверка nginx

Настройка Firewalld

С Nginx, работающим, вы должны открыть HTTP-порт на вашем сервере через firewalld. Кроме того, вы также можете открыть порт 4848, который используется администратором GlassFish.

Откройте оба HTTP и HTTPS службы в firewalld с помощью команды ниже.

sudo firewall-cmd --add-service={http,https} --permanent

Откройте TCP порт 4848, который будет использоваться для администрирования GlassFish.

sudo firewall-cmd --add-port=4848/tcp --permanent

Теперь перезагрузите firewalld, чтобы применить ваши изменения к firewalld. Затем проверьте включенные правила.

sudo firewall-cmd --reload  
sudo firewall-cmd --list-all

Вы можете увидеть ниже, что службы HTTP, HTTPS и порт 4848 добавлены в firewalld.

настройка firewalld

Доступ к GlassFish

Откройте ваш веб-браузер и посетите ваше доменное имя для GlassFish, например http://glassfish.howtoforge.local/. Если ваша установка успешна, вы должны увидеть индексную страницу GlassFish, как показано ниже.

индекс

Теперь откройте новую вкладку и посетите http://glassfish.howtoforge.local:4848/, чтобы получить доступ к администрированию GlassFish. Введите пользователя admin с вашим паролем, затем нажмите Войти.

страница входа

Если у вас правильный пароль, вы должны увидеть панель управления GlassFish.

консоль администратора

Заключение

Поздравляем! Вы успешно установили GlassFish на сервер AlmaLinux 9. Вы установили GlassFish, настроили пользователя администратора и защитили администратора для GlassFish. Наконец, вы также установили и настроили Nginx как обратный прокси для вашей установки GlassFish.