Actuator Refresh 반영 안되는 현상 해결

문제

프로젝트 버전

• Spring Cloud Config Server: Spring Boot 2.7.4
• 각각의 서비스 서버들: Spring Boot 2.7.4
• Spring Discovery Server: Spring Boot 2.7.4
• Spring GateWay Server: Spring Boot 2.7.4

현재 상황은 위의 이미지처럼 Spring Cloud Conifg 서버를 띄운 후 각각의 Spring Boot Application에서 해당 Config 서버로부터 설정 정보를 가져오고 있습니다.

이때 Config Server의 내용이 변경되었을 때 수정된 내용을 각각의 Spring Boot Application에 반영하는 방법은 다음과 같습니다.

1. 서버 재기동
2. Actuator Refresh
3. Spring Cloud Bus 

저는 이 중에서 2번 방법을 토대로 학습을 하고 있는데, 문제가 발생했습니다.

먼저 각각의 이미지는 Config Server에 등록된 Config 값, Config Server의 세팅, User Service Server의 세팅입니다.

config server yml 설정 값

Config Server 세팅

User Service 세팅

그리고 이를 바라보는 user-service 애플리케이션에서 해당 값들을 잘 불러오는지 테스트하기 위해 다음과 같은 controller를 하나 만들었습니다.

    @GetMapping("/health_check")
    public String status() {
        return String.format("It's Working is User Service "
                + ", port(local.server.port) = " + env.getProperty("local.server.port")
                + ", port(server.port) = " + env.getProperty("server.port")
                + ", token secret = " + env.getProperty("token.secret")
                + ", token expiration time = " + env.getProperty("token.expiration_time")
                + ", gateway ip = " + env.getProperty("gateway.ip")
        );
    }

/health_check 호출

보이는 바와 같이 user-service server의 health_check api호출을 통해 config-server의 값이 올바르게 user-service에서 가져왔는지 확인할 수 있습니다. 여기서 token.expiration_time의 값을 변경시켜서 반영이 되는지 확인할 것입니다.

config server yml 설정 값 변경

config server token.expiration_time: 100000 -> 86400000로 변경했습니다.

git 등록

 

spring cloud config server에서 git으로 해당 값을 불러오기 때문에, 변경된 내용도 git으로 반영시켜주었습니다.

/actuator/refresh 호출

actuator/refresh 호출 시상태 값은 200으로 성공했다고 나옵니다. 하지만 원래라면 변경된 값인  token.expiration_time이 body에 찍혀서 나와야 하지만 나오지 않습니다. 

  

더군다나 Config Server에서는 Could not merge remote for main remote: null을 내뱉습니다.

 

원인 및 해결

원인은 바로 Config Server를 바라보는 각각의 서비스 중 하나인 user service server의 세팅값이 원인이었습니다.

User Service 세팅

저는 위와 같이 User Service Server의 application.yml에서 직접적으로 config server를 연동했습니다.

bootstrap.yml 생성

하지만 위와 같이 application.yml에 직접 명시하는 것이 아니라 bootstrap.yml에 값을 작성 한 뒤 application.yml에서 이 bootstrap.yml을 바라보도록 설정하면 해결이 되었습니다.

application.yml 수정

 

재시도

다시 변경사항을 반영한 뒤 actuator/refresh를 호출했습니다.

/actuator/refresh 호출

이제 정상적으로 변경사항이 있는 token.expiration_time이 body값으로 넘어옵니다.

/health_check 호출

refresh 후 /health_check를 호출했을 때 변경사항이 무사히 반영되어 출력되는 것을 확인할 수 있습니다.

 

정리

"Spring Boot 2.4 버전 이후부터는 bootstrap.yml 파일 대신 spring.config.import 설정을 사용하여 해당 기능을 구현하도록 하고 있다."라는 문장을 어디서 보게 되어 직접 application.yml에 cloud config를 import 해주었지만 오히려 해당 방법이 독이 되었던 것 같습니다. 정확한 원인은 솔직히 잘 모르겠으나 bootstrap.yml에 작성하는 방법으로 해결되었습니다. 혹시나 아시는 분 계시면 알려주시면 감사하겠습니다. 🥹