Como Instalar o Servidor de Aplicação Java GlassFish com Proxy Reverso Nginx no AlmaLinux 9

GlassFish é uma implementação gratuita e de código aberto da Plataforma Java EE desenvolvida pela Eclipse. É a primeira implementação do mundo da plataforma Java EE para implantar aplicações Java. O GlassFish fornece uma arquitetura escalável com suporte a várias tecnologias Java, como Enterprise JavaBeans, JPA, JavaServer Faces e JMS.

Este guia mostrará como instalar o GlassFish no servidor AlmaLinux 9 com proxy reverso Nginx. Também abordamos como proteger o GlassFish habilitando a autenticação e configurando uma conexão SSL/TLS segura para a administração do GlassFish.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Um servidor AlmaLinux 9.
• Um usuário não-root com privilégios de administrador.
• Um nome de domínio local apontado para o endereço IP do servidor.

Configurando dependências

Primeiro, você precisa configurar seu sistema AlmaLinux adicionando um usuário do sistema que será usado para executar o GlassFish, e depois instalar os pacotes Java OpenJDK.

Antes de instalar qualquer pacote, crie um novo usuário do sistema glassfish com o comando abaixo. Este usuário terá o diretório home padrão /opt/glassfish7, que será usado como diretório de instalação do GlassFish.

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

Agora instale o Java OpenJDK 21 e os pacotes unzip com o comando abaixo. Digite y para prosseguir com a instalação.

sudo dnf install java-21-openjdk unzip nano

Uma vez que a instalação esteja completa, verifique a versão do Java com o comando abaixo. Certifique-se de ter o Java 17 ou 21 instalado em seu servidor AlmaLinux.

java --version

Baixando o pacote GlassFish

Depois de criar um usuário do sistema e instalar o Java, você pode agora baixar o pacote GlassFish. Certifique-se de visitar a página de download do GlassFish e copiar o link para a versão mais recente.

Baixe o pacote GlassFish usando o comando wget abaixo.

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

Uma vez baixado, extraia o arquivo glassfish-7.0.12.zip para o diretório /opt com o seguinte comando unzip. Isso extrairá o GlassFish para o diretório /opt/glassfish7.

unzip glassfish-7.0.12.zip -d /opt

Por último, mude a propriedade do diretório /opt/glassfish7 para o usuário glassfish. Isso porque você estará executando o GlassFish como um usuário do sistema glassfish.

sudo chown -R glassfish:glassfish /opt/glassfish7

Configurando o serviço systemd para o GlassFish

Neste guia, você executará o GlassFish como um serviço systemd. Isso fará com que o GlassFish seja executado em segundo plano e você poderá gerenciá-lo facilmente através da utilidade systemctl.

Crie um novo arquivo de serviço systemd /etc/systemd/system/glassfish7.service usando o seguinte comando do editor nano.

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

Insira a configuração do systemd abaixo para o 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

Salve o arquivo e feche o editor quando terminar.

Agora recarregue o gerenciador systemd para aplicar seu novo arquivo de serviço.

sudo systemctl daemon-reload

Em seguida, inicie e habilite o GlassFish com o comando abaixo. Uma vez iniciado, o GlassFish deve estar rodando nas portas 8080 e 4848.

sudo systemctl start glassfish7  
sudo systemctl enable glassfish7

Por último, verifique o serviço glassfish7 com o comando abaixo. Certifique-se de que o serviço glassfish7 está habilitado e em execução em seu sistema.

sudo systemctl status glassfish7

Configurando o administrador do GlassFish

Neste ponto, o GlassFish está rodando como um serviço systemd em seu sistema. Agora você precisa confirmar o usuário administrador para o GlassFish e configurar o enable-secure-admin para proteger a administração do GlassFish.

Primeiro, execute o seguinte comando para criar um novo usuário administrador para sua instalação do GlassFish.

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

Quando solicitado pelo usuário, digite o usuário padrão admin e pressione ENTER quando solicitado pela senha. O GlassFish padrão vem sem senha.
Quando solicitado a definir uma nova senha, digite sua senha e repita.

Uma vez que o processo esteja completo, você deve receber uma saída ‘ Comando change-admin-password executado com sucesso ‘.

Após configurar a senha do administrador para o GlassFish, execute o seguinte comando para habilitar o recurso secure-admin. Isso gerará certificados SSL/TLS automaticamente para o GlassFish.

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

Digite seu usuário e senha de administrador para o GlassFish quando solicitado. Uma vez que o processo seja bem-sucedido, você deve ver uma saída ‘ Comando enable-secure-admin executado com sucesso ‘.

Por último, reinicie o serviço glassfish7 para aplicar suas modificações ao seu GlassFish. Após a execução do comando, sua instalação do GlassFish deve estar segura, o usuário administrador com nova senha e certificados TLS gerados para o administrador do GlassFish.

sudo systemctl restart glassfish7

Executando o GlassFish com proxy reverso Nginx

Neste guia, você estará executando o GlassFish atrás do proxy reverso Nginx. Portanto, agora você precisa instalar o Nginx em seu servidor AlmaLinux e, em seguida, criar uma nova configuração de bloco de servidor para o proxy reverso.

Instale o servidor web Nginx em seu AlmaLinux usando o comando abaixo. Digite y para prosseguir com a instalação.

sudo dnf install nginx

Após a instalação, crie uma nova configuração de bloco de servidor /etc/nginx/conf.d/glassfish.conf usando o seguinte comando do editor nano.

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

Insira a seguinte configuração para configurar um proxy reverso para o GlassFish que está rodando por padrão na porta 8080. Certifique-se de alterar o nome do domínio na seguinte configuração para o seu domínio local.

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/;  
}  
}

Quando terminar, salve e saia do arquivo.

Agora verifique a sintaxe do Nginx usando o comando abaixo. Se você tiver a sintaxe correta, deve receber uma saída ‘sintaxe está ok - teste bem-sucedido’.

sudo nginx -t

Em seguida, inicie e habilite o Nginx em seu servidor AlmaLinux com o comando abaixo.

sudo systemctl start nginx  
sudo systemctl enable nginx

Uma vez iniciado, verifique o serviço Nginx para garantir que o serviço está em execução e habilitado.

sudo systemctl status nginx

Abaixo você deve ver que o serviço Nginx está em execução e habilitado no AlmaLinux.

Configurando o Firewalld

Com o Nginx em funcionamento, você deve abrir a porta HTTP em seu servidor através do firewalld. Além disso, você também pode abrir a porta 4848 que é usada pelo administrador do GlassFish.

Abra ambos os serviços HTTP e HTTPS no firewalld com o comando abaixo.

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

Abra a porta TCP 4848 que será usada para a administração do GlassFish.

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

Agora recarregue o firewalld para aplicar suas alterações ao firewalld. Em seguida, verifique as regras lis-enabled.

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

Você pode ver abaixo os serviços HTTP, HTTPS e a porta 4848 adicionados ao firewalld.

Acessando o GlassFish

Abra seu navegador e visite seu nome de domínio para o GlassFish, como http://glassfish.howtoforge.local/. Se sua instalação for bem-sucedida, você deve ver a página de índice do GlassFish como a seguinte.

Agora abra uma nova aba e visite http://glassfish.howtoforge.local:4848/ para acessar a administração do GlassFish. Digite o usuário admin padrão com sua senha e clique em Login.

Se você tiver a senha correta, deverá ver o painel do GlassFish.

Conclusão

Parabéns! Você agora instalou com sucesso o GlassFish no servidor AlmaLinux 9. Você instalou o GlassFish, configurou o usuário administrador e protegeu o admin do GlassFish. Por último, você também instalou e configurou o Nginx como um proxy reverso para sua instalação do GlassFish.