Spring Boot 2.7.10을 JBoss EAP 7.3에 배포하고 Log4j 로그 설정하는 방법

Spring Boot 2.7.10을 JBoss EAP 7.3에 배포하고 Log4j 로그 설정하는 방법

Spring Boot는 독립 실행형 애플리케이션 개발에 최적화되어 있지만, 기업 환경에서는 여전히 JBoss EAP 같은 WAS(Web Application Server)에 war 형태로 배포하는 경우가 많습니다. 특히 로그 관리는 운영 환경에서 매우 중요한 부분으로, Log4j를 통해 로그를 세밀하게 관리할 수 있습니다.

이 글에서는 Spring Boot 2.7.10 버전을 JBoss EAP 7.3에 배포하고, Log4j를 이용해 로그를 출력하는 전체 설정 과정을 상세히 설명합니다.

1. Spring Boot 프로젝트 설정

1) pom.xml 설정:

<packaging>war</packaging>

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-web</artifactId>
  <exclusions>
    <exclusion>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-tomcat</artifactId>
    </exclusion>
  </exclusions>
</dependency>

2) WAR 배포용 main 클래스 설정:

@SpringBootApplication
public class Application extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(Application.class);
    }
}

2. JBoss EAP 7.3 설정

• standalone.xml에서 deployment-scanner 설정 확인
• 생성된 WAR 파일을 standalone/deployments/에 배포

3. Log4j 설정

1) log4j2.xml 설정:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} - %msg%n" />
    </Console>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="Console" />
    </Root>
  </Loggers>
</Configuration>

2) Log4j 의존성 추가:

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

3) application.properties 설정:

logging.config=classpath:log4j2.xml

4) JBoss 로깅 충돌 방지를 위한 설정:

<jboss-deployment-structure>
  <deployment>
    <exclude-subsystems>
      <subsystem name="logging" />
    </exclude-subsystems>
    <dependencies>
      <module name="org.apache.logging.log4j" services="import"/>
    </dependencies>
  </deployment>
</jboss-deployment-structure>

Spring Boot 애플리케이션을 JBoss EAP 7.3에 성공적으로 배포하고 Log4j로 로그를 출력하려면 몇 가지 설정을 명확히 처리해야 합니다. 특히 log4j2.xml 설정과 JBoss의 기본 로깅 시스템 충돌을 방지하는 설정이 중요합니다.

이 과정을 통해 운영 환경에서도 안정적이고 구조적인 로그 관리가 가능해지며, 유지보수와 디버깅의 효율성도 크게 향상됩니다.