Como Instalar o Servidor de Aplicações GlassFish com Nginx como Proxy Reverso no Debian 12

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 que fornece um servidor de aplicações leve e permite que você implante várias aplicações baseadas em Java. O GlassFish suporta vários tipos de tecnologias de aplicações Java, como Enterprise JavaBeans, JPA, JavaServer Faces, JMS e muitas outras.

O GlassFish é uma das melhores escolhas para desenvolvedores desenvolverem e implantarem aplicações baseadas em Java. Ele permite que os desenvolvedores criem aplicações empresariais de maneira conveniente e também uma arquitetura escalável. O projeto GlassFish foi originalmente iniciado pela Sun Microsystems. Ele vem com duas licenças gratuitas diferentes - A Licença de Desenvolvimento e Distribuição Comum e a Licença Pública Geral GNU.

Neste guia, você instalará o Servidor de Aplicações GlassFish no Debian 12 em um processo passo a passo. Você também configurará o Nginx como um proxy reverso para sua instalação do GlassFish.

Pré-requisitos

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

• Um servidor Debian 12 com pelo menos 4GB de RAM ou memória.
• Um usuário não-root com privilégios sudo.

Instalando o Java OpenJDK

O GlassFish é um servidor de aplicações para implantar aplicações Java. Para instalar o GlassFish, você deve instalar o Java primeiro em seu sistema Debian. Neste momento, o repositório Debian fornece o Java OpenJDK 17, que é compatível com a versão mais recente do GlassFish.

Primeiro, atualize e atualize seu repositório Debian usando o seguinte comando.

sudo apt update

Uma vez que o repositório esteja atualizado, instale o pacote default-jdk executando o comando abaixo. Ao instalar o pacote default-jdk, você instalará o Java OpenJDK 17.

sudo apt install default-jdk

Digite y para prosseguir com a instalação.

Após a instalação ser concluída, verifique sua versão do Java usando o comando abaixo. Você deve ver que o Java OpenJDK 17 está instalado.

java -version

Configurando o Sistema

Após instalar o Java OpenJDK, o próximo passo é configurar seu sistema Debian instalando pacotes adicionais como wget e unzip, criando um novo usuário de sistema glassfish e configurando a variável de ambiente JAVA_HOME.

Para começar, você instalará o pacote unzip e wget executando o seguinte comando apt.

sudo apt install unzip wget -y

Agora, execute o comando abaixo para criar um novo usuário de sistema glassfish. Este usuário será usado para executar sua instalação do GlassFish, que estará localizada no diretório /opt/glassfish.

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

Em seguida, crie um novo script bash /etc/profile.d/java.sh usando o seguinte comando do editor nano.

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

Adicione a seguinte configuração para configurar a variável de ambiente JAVA_HOME e adicionar o caminho binário do Java ao PATH do sistema.

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

Salve e feche o arquivo quando terminar.

Agora carregue a nova variável de ambiente dentro de /etc/profile.d/java.sh usando o comando source abaixo.

source /etc/profile.d/java.sh

Por último, execute o seguinte comando para verificar as variáveis de ambiente PATH e JAVA_HOME do sistema.

echo $JAVA_HOME  
echo $PATH

Se tudo correr bem, você deve ver que o caminho JAVA_HOME está configurado para o diretório /usr/lib/jvm/java-17-openjdk-amd64, e o diretório bin do Java foi adicionado ao PATH do sistema.

Baixando o Pacote Binário do GlassFish

Com o Java OpenJDK instalado e seu sistema Debian pronto, você pode agora baixar e instalar o GlassFish. Antes de prosseguir, verifique a página de download do GlassFish para obter a versão mais recente do GlassFish. Neste momento, a versão mais recente do GlassFish é a v7.0.10.

Vá para o diretório /tmp e baixe o pacote binário do GlassFish via o comando wget abaixo. Uma vez que o processo de download esteja concluído, você deve ver o arquivo glassfish-7.0.10.zip.

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

Extraia o arquivo glassfish-7.0.10.zip para o diretório /opt via o comando unzip abaixo. O pacote GlassFish será extraído para o diretório /opt/glassfish7.

unzip glassfish-7.0.10.zip -d /opt

Por último, renomeie o diretório extraído de /opt/glassfish7 para /opt/glassfish. Em seguida, mude a propriedade do diretório /opt/glassfish para o usuário glassfish.

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

Executando o GlassFish como um Serviço Systemd

Após baixar o pacote binário do GlassFish, você criará um novo arquivo de serviço systemd que será usado para executar o GlassFish. Isso permite que você gerencie o GlassFish através da utilidade systemctl e execute o GlassFish em segundo plano como um serviço systemd.

Para executar o GlassFish como um serviço systemd, execute o comando do editor nano abaixo para criar um novo arquivo /etc/systemd/system/glassfish.service.

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

Insira a seguinte configuração no arquivo.

[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

Salve e feche o arquivo quando terminar.

Agora, execute o seguinte comando systemctl para recarregar o gerenciador systemd e aplicar as alterações.

sudo systemctl daemon-reload

Com o gerenciador systemd recarregado, inicie e habilite o serviço glassfish usando o seguinte comando.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

Por último, verifique o status do serviço glassfish usando o comando abaixo.

sudo systemctl status glassfish

Se tudo correr bem, você deve ver o status do glassfish como ativo (em execução), e ele está habilitado.

Configurando Usuário e Protegendo a Administração do GlassFish

Neste ponto, o GlassFish está em funcionamento. Agora você configurará a instalação do GlassFish mudando a senha padrão do Console de Administração e habilitando o Admin Seguro. Isso pode ser feito através do comando asadmin que está disponível no diretório /opt/glassfish/bin.

Execute a linha de comando asadmin abaixo para mudar a senha do administrador para sua instalação do GlassFish.

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

Durante o processo, você será solicitado a:

• Inserir o usuário administrador padrão do GlassFish.
• Pressione ENTER quando solicitado pela senha. O usuário administrador padrão do GlassFish vem sem senha.
• Agora insira a nova senha do administrador para o GlassFish e repita.

Quando o processo estiver completo, você deve receber uma mensagem como a seguinte:

Em seguida, execute o comando asadmin abaixo para habilitar o admin seguro na sua instalação do GlassFish.

Essencialmente, o Admin Seguro habilita comunicações seguras via SSL entre o servidor de administração do domínio (DAS), instâncias remotas e clientes de administração, incluindo a utilidade asadmin, o console de administração e clientes REST.

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

Digite seu usuário e senha do administrador do GlassFish e pressione Enter. Quando terminar, a seguinte saída será exibida.

Após o Admin Seguro ser habilitado, execute o seguinte comando para reiniciar o serviço glassfish e aplicar as alterações.

sudo systemctl restart glassfish

Agora, abra seu navegador da web e visite o endereço IP do servidor seguido da porta 8080, como http://192.168.5.15:8080/. Se sua instalação do GlassFish for bem-sucedida, você deve ver a seguinte página, que confirma que o GlassFish está em execução.

Por último, abra uma nova aba e visite o mesmo endereço IP do servidor com a porta 4848 (ou seja: https://192.168.5.15:4848/) para acessar a página de administração do GlassFish. Aceite os certificados SSL/TLS no seu navegador da web e, se for bem-sucedido, você deve ver a página de login da administração do GlassFish abaixo.

Instalando o Nginx como Proxy Reverso

Neste guia, você executará o GlassFish com o Nginx como um proxy reverso. Agora, você instalará o Nginx em sua máquina Debian e criará uma nova configuração de bloco de servidor para o GlassFish. Neste caso, usaremos um nome de domínio local glassfish.howtoforge.local.

Primeiro, instale o Nginx em seu sistema Debian usando o seguinte comando apt. Digite y para prosseguir com a instalação.

sudo apt install nginx

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

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

Insira a seguinte configuração e tenha certeza de mudar o parâmetro server_name com seu nome de domínio local.

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

Salve e saia do arquivo quando terminar.

Em seguida, execute o seguinte comando para ativar a configuração do bloco de servidor glassfish e verificar a sintaxe do Nginx para garantir que você tenha a sintaxe correta.

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

Se você tiver a sintaxe correta do Nginx, deverá obter a saída ‘teste bem-sucedido - sintaxe está ok‘.

Agora você pode reiniciar o serviço Nginx e aplicar as alterações. Em seguida, verifique o serviço Nginx para garantir que o serviço esteja em execução.

sudo systemctl restart nginx  
sudo systemctl status nginx

Na saída a seguir, você deve ver que o serviço Nginx está em execução.

Acessando a Instalação do GlassFish

Na última seção, você acessará sua instalação do GlassFish a partir da máquina cliente. Você pode usar qualquer sistema operacional como sua máquina cliente.

Edite o arquivo /etc/hosts em sua máquina local e insira a seguinte configuração. Certifique-se de mudar o endereço IP do servidor e o nome de domínio local. Se você estiver usando um cliente Windows, certifique-se de modificar o arquivo C:\Windows\System32\drivers\etc\hosts como administrador.

192.168.5.15    glassfish.howtoforge.local

Agora volte ao seu navegador da web e visite o nome de domínio da sua instalação do GlassFish, como http://glassfish.howtoforge.local/. Se a sua configuração do proxy reverso Nginx for bem-sucedida, você deve ver a página de índice padrão do GlassFish como a seguinte.

Em seguida, visite a página de administração do GlassFish na porta 4848 (ou seja: https://glassfish.howtoforge.local:4848/). Na página de login, insira seu usuário e senha de administrador e clique em Login.

Se sua instalação for bem-sucedida, você deve obter o painel de administração do GlassFish como o seguinte:

Agora clique no menu Servidor para verificar o status da sua instalação do GlassFish. Neste exemplo, você deve ver que GlassFish 7.0 está instalado com o status Em Execução.

A partir daqui, você pode agora gerenciar seu servidor de aplicações GlassFish.

Conclusão

Em conclusão, você agora instalou com sucesso o Servidor de Aplicações GlassFish em um servidor Debian 12, seguindo as instruções passo a passo. Você instalou o GlassFish com Java OpenJDK 17 e Nginx como um proxy reverso, e também protegeu o GlassFish mudando a senha padrão do administrador e habilitando o Admin Seguro. Agora você pode começar a implantar sua aplicação com o GlassFish.