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

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

GlassFish является одним из лучших выборов для разработчиков для разработки и развертывания приложений на основе Java. Он позволяет разработчикам удобно разрабатывать корпоративные приложения и обеспечивает масштабируемую архитектуру. Проект GlassFish изначально был начат компанией Sun Microsystems. Он поставляется с двумя различными бесплатными лицензиями - Лицензией на общее развитие и распространение и GNU General Public License.

В этом руководстве вы установите сервер приложений GlassFish на Debian 12 поэтапно. Вы также настроите Nginx в качестве обратного прокси для вашей установки GlassFish.

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

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

Сервер Debian 12 с как минимум 4 ГБ ОЗУ или памяти.
Непривилегированный пользователь с правами sudo.

Установка Java OpenJDK

GlassFish — это сервер приложений для развертывания Java-приложений. Чтобы установить GlassFish, сначала необходимо установить Java на вашу систему Debian. В настоящее время репозиторий Debian предоставляет Java OpenJDK 17, который совместим с последней версией GlassFish.

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

sudo apt update

обновить репозиторий

После обновления репозитория установите пакет default-jdk, выполнив команду ниже. Установив пакет default-jdk, вы установите Java OpenJDK 17.

sudo apt install default-jdk

Введите y, чтобы продолжить установку.

установить java

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

java -version

проверить java

Настройка системы

После установки Java OpenJDK следующим шагом является настройка вашей системы Debian путем установки дополнительных пакетов, таких как wget и unzip, создания нового системного пользователя glassfish и настройки переменной окружения JAVA_HOME.

Для начала установите пакеты unzip и wget, выполнив следующую команду apt.

sudo apt install unzip wget -y

установить wget unzip

Теперь выполните команду ниже, чтобы создать нового системного пользователя glassfish. Этот пользователь будет использоваться для запуска вашей установки GlasFish, которая будет находиться в директории /opt/glassfish.

sudo useradd -M -d /opt/glassfish -U -s /bin/false glassfish

Затем создайте новый bash-скрипт /etc/profile.d/java.sh, используя следующую команду редактора nano.

sudo nano /etc/profile.d/java.sh

Добавьте следующую конфигурацию, чтобы настроить переменную окружения JAVA_HOME и добавить путь к бинарным файлам Java в системный PATH.

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64  
export PATH=$PATH:$JAVA_HOME/bin

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

Теперь загрузите новую переменную окружения из /etc/profile.d/java.sh, используя команду source ниже.

source /etc/profile.d/java.sh

Наконец, выполните следующую команду, чтобы проверить системные переменные PATH и JAVA_HOME.

echo $JAVA_HOME  
echo $PATH

Если все прошло хорошо, вы должны увидеть, что путь JAVA_HOME настроен на директорию /usr/lib/jvm/java-17-openjdk-amd64, а директория bin Java добавлена в системный PATH.

Скачивание бинарного пакета GlassFish

С установленным Java OpenJDK и готовой системой Debian вы теперь можете скачать и установить GlassFish. Прежде чем продолжить, проверьте страницу загрузки GlassFish, чтобы получить последнюю версию GlassFish. В настоящее время последняя версия GlassFish - v7.0.10.

Перейдите в директорию /tmp и скачайте бинарный пакет GlassFish с помощью команды wget ниже. После завершения процесса загрузки вы должны увидеть файл glassfish-7.0.10.zip.

cd /tmp  
wget https://download.eclipse.org/ee4j/glassfish/glassfish-7.0.10.zip

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

unzip glassfish-7.0.10.zip -d /opt

Наконец, переименуйте извлеченную директорию из /opt/glassfish7 в /opt/glassfish. Затем измените владельца директории /opt/glassfish на пользователя glassfish.

mv /opt/glassfish7 /opt/glassfish  
sudo chown -R glassfish:glassfish /opt/glassfish

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

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

Чтобы запустить GlassFish как службу systemd, выполните команду редактора nano ниже, чтобы создать новый файл /etc/systemd/system/glassfish.service.

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

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

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

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

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

sudo systemctl daemon-reload

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

sudo systemctl start glassfish  
sudo systemctl enable glassfish

запустить glassfish systemd

Наконец, проверьте статус службы glassfish, используя команду ниже.

sudo systemctl status glassfish

Если все прошло хорошо, вы должны увидеть статус glassfish как active (running), и он включен.

проверить службу glassfish

Настройка пользователя и защита администрирования GlassFish

На данный момент GlassFish работает. Теперь вы настроите установку GlassFish, изменив пароль по умолчанию для консоли администратора и включив Secure Admin. Это можно сделать с помощью команды asadmin, которая доступна в директории /opt/glassfish/bin.

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

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

В процессе вас попросят следующее:

Введите имя пользователя администратора по умолчанию для GlassFish.
Нажмите ENTER, когда вас попросят ввести пароль. У администратора GlassFish по умолчанию нет пароля.
Теперь введите новый пароль администратора для GlassFish и повторите его.

Когда процесс завершится, вы должны получить сообщение, подобное следующему:

Затем выполните команду asadmin ниже, чтобы включить безопасное администрирование на вашей установке GlassFish.

По сути, Secure Admin включает безопасные коммуникации через SSL между сервером администрирования домена (DAS), удаленными экземплярами и клиентами администрирования, включая утилиту asadmin, консоль администрирования и REST-клиентов.

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

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

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

sudo systemctl restart glassfish

Теперь запустите веб-браузер и перейдите по IP-адресу сервера, добавив порт 8080, например http://192.168.5.15:8080/. Если ваша установка GlassFish успешна, вы должны увидеть следующую страницу, которая подтверждает, что GlassFish работает.

индекс glassfish

Наконец, откройте новую вкладку и перейдите по тому же IP-адресу сервера с портом 4848 (т.е.: https://192.168.5.15:4848/), чтобы получить доступ к странице администрирования GlassFish. Примите сертификаты SSL/TLS в вашем веб-браузере, и если все прошло успешно, вы должны увидеть страницу входа в администрирование GlassFish ниже.

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

Установка Nginx как обратного прокси

В этом руководстве вы будете запускать GlassFish с Nginx в качестве обратного прокси. Теперь вы установите Nginx на вашем Debian-машине и создадите новую конфигурацию блока сервера для GlassFish. В этом случае мы будем использовать локальное доменное имя glassfish.howtoforge.local.

Сначала установите Nginx на вашу систему Debian, используя следующую команду apt. Введите y, чтобы продолжить установку.

sudo apt install nginx

установить nginx

После установки Nginx создайте новую конфигурацию блока сервера /etc/nginx/sites-available/glassfish, используя следующую команду редактора nano.

sudo nano /etc/nginx/sites-available/glassfish

Вставьте следующую конфигурацию и обязательно измените параметр server_name на ваше локальное доменное имя.

upstream glassfish {  
    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://glassfish/;  
    }  
}

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

Затем выполните следующую команду, чтобы активировать конфигурацию блока сервера glassfish и проверить синтаксис Nginx, чтобы убедиться, что у вас правильный синтаксис.

sudo ln -s /etc/nginx/sites-available/glassfish /etc/nginx/sites-enabled/  
sudo nginx -t

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

настройка nginx обратного прокси

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

sudo systemctl restart nginx  
sudo systemctl status nginx

В следующем выводе вы должны увидеть, что служба Nginx работает.

проверить nginx

Доступ к установке GlassFish

В последнем разделе вы получите доступ к вашей установке GlassFish с клиентской машины. Вы можете использовать любую операционную систему в качестве клиентской машины.

Отредактируйте файл /etc/hosts на вашей локальной машине и вставьте следующую конфигурацию. Обязательно измените IP-адрес сервера и локальное доменное имя. Если вы используете клиент Windows, обязательно измените файл C:\Windows\System32\drivers\etc\hosts с правами администратора.

192.168.5.15    glassfish.howtoforge.local

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

nginx обратный прокси glassfish

Затем перейдите на страницу администрирования GlassFish на порту 4848 (т.е.: https://glassfish.howtoforge.local:4848/). На странице входа введите вашего администратора и пароль, затем нажмите Войти.

вход GlassFish

Если ваша установка успешна, вы должны получить панель управления администрированием GlassFish, как показано ниже:

панель управления GlassFish

Теперь нажмите на меню Сервер, чтобы проверить статус вашей установки GlassFish. В этом примере вы должны увидеть, что GlassFish 7.0 установлен со статусом Работает.

статус GlassFish

Отсюда вы можете управлять вашим сервером приложений GlassFish.

Заключение

В заключение, вы успешно установили сервер приложений GlassFish на сервер Debian 12, следуя пошаговым инструкциям. Вы установили GlassFish с Java OpenJDK 17 и Nginx в качестве обратного прокси, а также защитили GlassFish, изменив пароль администратора по умолчанию и включив Secure Admin. Теперь вы можете начать развертывание вашего приложения с помощью GlassFish.