우분투 22.04에서 Nginx와 함께 WildFly Java 애플리케이션 서버 설치하기

Wildfly는 Java 애플리케이션을 구축하는 데 사용되는 간단하고 가벼우며 유연한 애플리케이션 런타임입니다. Java로 작성되었으며 Linux, macOS 및 Windows 운영 체제에서 실행할 수 있습니다. 이는 기업용이며 Java 웹 애플리케이션을 실행하는 데 필요한 모든 기능을 제공하는 완전한 기능을 갖춘 애플리케이션 서버입니다.

기능

무료 및 오픈 소스
모듈식 및 경량
효율적인 관리로 리소스 절약
빠른 개발로 시간 절약

이 튜토리얼에서는 우분투 22.04에서 Nginx를 리버스 프록시로 사용하여 Wildfly를 설치하는 방법을 보여줍니다.

전제 조건

우분투 22.04를 실행하는 서버.
서버 IP를 가리키는 유효한 도메인 이름.
서버에 구성된 루트 비밀번호.

시스템 업데이트

먼저, 시스템 패키지를 모두 최신 버전으로 업데이트해야 합니다. 다음 명령어를 실행하여 모든 패키지를 업데이트할 수 있습니다.

apt update -y  
apt upgrade -y

모든 패키지가 업데이트되면 다음 단계로 진행할 수 있습니다.

Java JDK 설치

Wildfly는 Java 기반 애플리케이션입니다. 따라서 서버에 Java를 설치해야 합니다. 다음 명령어로 Java JDK를 설치할 수 있습니다.

apt install default-jdk -y

Java가 설치되면 다음 명령어를 사용하여 Java 버전을 확인할 수 있습니다.

java --version

다음 출력에서 Java 버전을 확인할 수 있어야 합니다.

openjdk 11.0.17 2022-10-18
OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu222.04)
OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu222.04, mixed mode, sharing)

Wildfly 다운로드 및 설치

시작하기 전에 Wildfly를 실행할 전용 사용자 및 그룹을 생성해야 합니다. 다음 명령어를 사용하여 둘 다 생성할 수 있습니다.

groupadd -r wildfly  
useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

다음으로, 다음 명령어를 사용하여 Wildfly의 최신 버전을 다운로드합니다.

wget https://github.com/wildfly/wildfly/releases/download/26.1.3.Final/wildfly-26.1.3.Final.zip

다운로드가 완료되면 다음 명령어로 다운로드한 파일을 압축 해제합니다.

unzip wildfly-26.1.3.Final.zip

다음으로, 추출된 Wildfly 디렉토리를 /opt 디렉토리로 이동합니다.

mv wildfly-26.1.3.Final /opt/wildfly

다음으로, 다음 명령어를 사용하여 Wildfly 디렉토리의 소유권을 변경합니다.

chown -RH wildfly: /opt/wildfly

작업이 완료되면 Wildfly를 구성할 수 있습니다.

Wildfly 구성

먼저, 다음 명령어를 사용하여 Wildfly 구성 디렉토리를 생성합니다.

mkdir -p /etc/wildfly

다음으로, Wildfly 구성 파일을 /etc/wildfly 디렉토리로 복사합니다.

cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

다음으로, Wildfly 서비스 파일을 systemd 디렉토리로 복사합니다.

cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/

다음으로, Wildfly launch.sh 파일을 /opt/wildfly/bin/ 디렉토리로 복사합니다.

cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

다음으로, 스크립트 파일에 실행 권한을 설정합니다.

chmod +x /opt/wildfly/bin/*.sh

그런 다음, 변경 사항을 적용하기 위해 systemd 데몬을 다시 로드합니다.

systemctl daemon-reload

다음으로, Wildfly 서비스를 시작하고 시스템 부팅 시 자동으로 시작되도록 설정합니다.

systemctl start wildfly  
systemctl enable wildfly

이제 다음 명령어를 사용하여 Wildfly의 상태를 확인할 수 있습니다.

systemctl status wildfly

다음과 같은 출력을 받을 수 있습니다.

? wildfly.service - The WildFly Application Server
     Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
     Active: active (running) since Wed 2023-02-15 09:34:24 UTC; 4s ago
   Main PID: 20425 (launch.sh)
      Tasks: 61 (limit: 4579)
     Memory: 111.6M
        CPU: 6.919s
     CGroup: /system.slice/wildfly.service
             ??20425 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml 0.0.0.0
             ??20426 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b 0.0.0.0
             ??20534 java "-D[Standalone]" -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stac>

Feb 15 09:34:24 ubuntu2204 systemd[1]: Started The WildFly Application Server.

기본적으로 Wildfly는 포트 8080 및 9990에서 수신 대기합니다. 다음 명령어로 확인할 수 있습니다.

ss -antpl | grep -i java

다음과 같은 출력을 볼 수 있어야 합니다.

LISTEN 0      4096         0.0.0.0:8443      0.0.0.0:*    users:(("java",pid=20534,fd=498))                                                                
LISTEN 0      50         127.0.0.1:9990      0.0.0.0:*    users:(("java",pid=20534,fd=497))                                                                
LISTEN 0      4096         0.0.0.0:8080      0.0.0.0:*    users:(("java",pid=20534,fd=495))

Wildfly 관리 콘솔 구성

기본적으로 Wildfly 관리 콘솔은 비활성화되어 있습니다. 따라서 웹 브라우저에서 Wildfly에 접근하려면 이를 활성화해야 합니다.

먼저, 다음 명령어를 사용하여 Wildfly 구성 파일을 편집합니다.

nano /etc/wildfly/wildfly.conf

다음 줄을 변경합니다.

WILDFLY_BIND=127.0.0.1
WILDFLY_CONSOLE_BIND=127.0.0.1

작업이 완료되면 파일을 저장하고 닫습니다. 그런 다음, 다음 명령어로 launch.sh 파일을 편집합니다.

nano /opt/wildfly/bin/launch.sh

다음 줄을 수정합니다:

if [[ "$1" == "domain" ]]; then
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4
else
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4
fi

파일을 저장하고 닫은 후 Wildfly 서비스 파일을 편집합니다.

nano /etc/systemd/system/wildfly.service

다음 줄을 수정합니다.

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

파일을 저장하고 닫은 후 변경 사항을 적용하기 위해 systemd 데몬을 다시 로드합니다.

systemctl daemon-reload

이제 변경 사항을 적용하기 위해 Wildfly 서비스를 재시작합니다.

systemctl restart wildfly

Wildfly 관리 사용자 추가

다음으로, Wildfly 관리 콘솔에 접근하기 위해 관리 사용자를 추가해야 합니다. 다음 명령어로 추가할 수 있습니다.

sh /opt/wildfly/bin/add-user.sh

어떤 유형의 사용자를 추가할지 묻는 메시지가 표시됩니다:

What type of user do you wish to add? 
 a) Management User (mgmt-users.properties) 
 b) Application User (application-users.properties)
(a): a

다음과 같이 새 사용자 세부 정보를 제공하십시오:

Using the realm 'ManagementRealm' as discovered from the existing property files.
Username : wadmin
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
 - The password should be different from the username
 - The password should not be one of the following restricted values {root, admin, administrator}
 - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password : 
Re-enter Password :

이 사용자에게 속할 그룹을 묻는 메시지가 표시됩니다:

What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]:

그냥 Enter 키를 누르십시오. 다음과 같은 출력을 볼 수 있습니다.

About to add user 'wadmin' for realm 'ManagementRealm'
Is this correct yes/no? yes
Added user 'wadmin' to file '/opt/wildfly/standalone/configuration/mgmt-users.properties'
Added user 'wadmin' to file '/opt/wildfly/domain/configuration/mgmt-users.properties'
Added user 'wadmin' with groups  to file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'
Added user 'wadmin' with groups  to file '/opt/wildfly/domain/configuration/mgmt-groups.properties'
Is this new user going to be used for one AS process to connect to another AS process? 
e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server EJB calls.
yes/no? yes
To represent the user add the following to the server-identities definition

Wildfly를 위한 Nginx 구성

이 시점에서 Wildfly가 설치되고 localhost에서 실행되도록 구성되었습니다. 이제 Wildfly 웹 인터페이스에 접근하기 위해 Nginx를 리버스 프록시로 구성해야 합니다.

먼저, 다음 명령어를 사용하여 Nginx 패키지를 설치합니다.

apt install nginx -y

다음으로, proxy_headers 구성 파일을 생성합니다.

nano /etc/nginx/conf.d/proxy_headers.conf

다음 구성을 추가합니다:

proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
add_header Front-End-Https on;
add_header Cache-Control no-cache;

파일을 저장하고 닫은 후, 새로운 가상 호스트 구성 파일을 생성합니다.

nano /etc/nginx/conf.d/wildfly.conf

다음 구성을 추가합니다.

server {
  listen          80;
  server_name     wildfly.example.com;

  location / {
    include conf.d/proxy_headers.conf;
    proxy_pass http://127.0.0.1:8080;
  }

  location /management {
    include conf.d/proxy_headers.conf;
    proxy_pass http://127.0.0.1:9990/management;
  }

  location /console {
    include conf.d/proxy_headers.conf;
    proxy_pass http://127.0.0.1:9990/console;
  }

  location /logout {
    include conf.d/proxy_headers.conf;
    proxy_pass http://127.0.0.1:9990/logout;
  }

  location /error {
    include conf.d/proxy_headers.conf;
    proxy_pass http://127.0.0.1:9990;
  }

}

파일을 저장한 후, Nginx의 구문 구성 오류를 확인합니다.

ginx -t

모든 것이 정상이라면 다음과 같은 출력을 받을 수 있습니다.

ginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

마지막으로, 변경 사항을 적용하기 위해 Nginx 서비스를 재시작합니다.

systemctl restart nginx

다음 명령어로 Nginx 서비스의 상태를 확인할 수 있습니다.

systemctl status nginx