개요

<!-- Spring Boot and Cloud --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-gateway</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-loadbalancer</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-config</artifactId> </dependency> <!-- SpringDoc OpenAPI --> <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-webflux-ui</artifactId> <version>1.6.15</version> </dependency> <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-webflux-core</artifactId> <version>1.6.15</version> </dependency> <!-- Resilience4j --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-circuitbreaker-reactor-resilience4j</artifactId> </dependency> <dependency> <groupId>io.github.resilience4j</groupId> <artifactId>resilience4j-spring-boot2</artifactId> </dependency> <!-- Redis Reactive --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis-reactive</artifactId> </dependency> <!-- Actuator --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency>

server: port: 8000 max-http-header-size: 200KB # HTTP 헤더의 최대 크기 설정 (기본값보다 증가) spring: application: name: chamomile-cloud-gateway config: import: "optional:configserver:" # 외부 Config Server에서 설정 가져오기 (옵션) cloud: config: uri: http://localhost:8888 # Config Server URL fail-fast: false # Config Server 연결 실패 시 애플리케이션 실행 중단 여부 enabled: false # Config Server 사용 비활성화 (필요시 활성화 gateway: httpclient: pool: type: fixed # 고정 크기의 커넥션 풀 사용 max-connections: 2000 # 최대 커넥션 수 설정 max-idle-time: 30s # 유휴 커넥션 유지 시간 globalcors: cors-configurations: '[/**]': # 모든 경로에 대해 CORS 설정 allowed-origins: "*" # 모든 도메인 허용 allowed-methods: "*" # 모든 HTTP 메서드 허용 allowed-headers: "*" # 모든 헤더 허용 allow-credentials: false # 인증 정보 전달 허용하지 않음 routes: # Gateway 라우팅 설정 #################### chamomile-cloud-auth-gateway 사용시 아래 주석 해제 ##################### # - id: chamomile-cloud-auth-gateway # 라우트 ID# uri: lb://CHAMOMILE-CLOUD-AUTH-GATEWAY # 로드 밸런싱을 통한 URI 지정 # predicates: # - Path=/auth/** # /auth/로 시작하는 경로 매칭 # filters: # - RewritePath=/auth/(?<segment>.*), /$\{segment} # /auth/ 제거 후 전달 ############################################################################################# - id: chamomile-cloud-admin-project uri: lb://CHAMOMILE-CLOUD-ADMIN-PROJECT # 로드 밸런싱된 Admin 프로젝트 서비스 predicates: - Path=/chmm/** # /chmm/로 시작하는 경로 매칭 filters: - RewritePath=/chmm/(?<segment>.*), /$\{segment} # /chmm/ 제거 - name: RequestRateLimiter args: key-resolver: "#{@ipKeyResolver}" # 요청 제한 Key Resolver redis-rate-limiter.replenishRate: 1500 # 초당 새로 고침 속도 redis-rate-limiter.burstCapacity: 3000 # 최대 버스트 요청 수 - name: CircuitBreaker args: name: exampleClientCircuitBreaker # Circuit Breaker 이름 fallbackUri: forward:/fallback/authFailure # 실패 시 Fallback URI 설정 # - name: GatewayIdFilter # 커스텀 필터 예시 (주석 처리됨) - id: chamomile-cloud-timetable uri: lb://CHAMOMILE-CLOUD-TIMETABLE # 로드 밸런싱된 Timetable 서비스 predicates: - Path=/timetable/** # /timetable/로 시작하는 경로 매칭 filters: - RewritePath=/timetable/(?<segment>.*), /$\{segment} # /timetable/ 제거 management: endpoints: web: exposure: include: refresh, health, beans, httptrace, circuitbreakers # 노출할 관리 엔드포인트 endpoint: health: show-details: always # Health 엔드포인트의 세부 정보 항상 표시 eureka: instance: instance-id:${spring.cloud.client.hostname}:${spring.application.instance_id:${random.value}} # Eureka에 등록될 인스턴스 ID client: register-with-eureka: true # Eureka에 클라이언트 등록 fetch-registry: true # Eureka 레지스트리 정보 가져오기 service-url: defaultZone: http://localhost:8761/eureka # Eureka 서버 URL springdoc: enable-native-support: true # Native OpenAPI 문서 지원 활성화 api-docs: enabled: true # API 문서 활성화 swagger-ui: enabled: true # Swagger UI 활성화 path: /swagger-ui.html # Swagger UI 경로 config-url: /v3/api-docs/swagger-config # Swagger 구성 URL urls: # OpenAPI 문서 경로 설정 - url: /chmm/api-docs name: ADMIN - url: /timetable/api-docs name: TIMETABLE resilience4j: circuitbreaker: instances: exampleClientCircuitBreaker: failureRateThreshold: 90 # 실패 비율이 90% 이상이면 Circuit이 열림 waitDurationInOpenState: 10000 # Circuit이 열린 후 10초 동안 대기 slidingWindowSize: 1000 # 최근 1000개의 호출 기준으로 실패 비율 계산 slowCallRateThreshold: 80 # 느린 호출 비율이 80%를 넘으면 Circuit이 열림 slowCallDurationThreshold: 30000 # 30초 이상 소요되면 느린 호출로 간주 permittedNumberOfCallsInHalfOpenState: 5 # 반 열림 상태에서 최대 5번 호출 허용 maxWaitDurationInHalfOpenState: 30000 # 반 열림 상태에서 최대 30초 대기 slidingWindowType: COUNT_BASED # 호출 횟수 기준으로 실패 비율 계산 minimumNumberOfCalls: 1000 # 최소 1000번 호출 후 실패 비율 계산 registerHealthIndicator: true # Health Indicator 등록 timelimiter: configs: default: timeoutDuration: 60s # 호출 타임아웃 60초 설정 cancelRunningFuture: false # 타임아웃 발생 시 실행 중 작업 취소하지 않음 logging: level: org.springframework.cloud.gateway: INFO # Gateway 로깅 레벨 org.springframework.cloud.gateway.filter.rateLimit.RedisRateLimiter: INFO# RateLimiter 로깅 레벨

@RestController @RequestMapping("/fallback") public class FallbackController { @GetMapping("/authFailure") public ResponseEntity<String> authFailure(ServerWebExchange exchange) { // CIRCUITBREAKER_EXECUTION_EXCEPTION_ATTR 속성에서 발생한 예외를 가져옴 Throwable exception = exchange.getAttribute(ServerWebExchangeUtils.CIRCUITBREAKER_EXECUTION_EXCEPTION_ATTR); // 예외가 없는 경우 기본 메시지 반환 if (exception == null) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR) .body("Fallback triggered, but no specific exception was found."); } // 요청 경로를 가져옴 String requestPath = exchange.getRequest().getPath().toString(); String responseMessage; if (exception instanceof CallNotPermittedException) { responseMessage = "CircuitBreaker Open error on path " + requestPath + ": " + exception.getMessage(); return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(responseMessage); } // 기타 예외 처리 else { responseMessage = "An unknown error occurred on path " + requestPath + "."; return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(responseMessage); } } }

<!-- Spring Boot and Cloud --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-gateway</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-loadbalancer</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> </dependency> <!-- Resilience4j --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-circuitbreaker-reactor-resilience4j</artifactId> </dependency> <!-- Additional Libraries --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <!-- chamomile --> <dependency> <groupId>net.lotte.chamomile.module</groupId> <artifactId>chamomile-database</artifactId> </dependency> <dependency> <groupId>net.lotte.chamomile.module</groupId> <artifactId>chamomile-cache-redis</artifactId> </dependency> <dependency> <groupId>net.lotte.chamomile.module</groupId> <artifactId>chamomile-security-jwt</artifactId> <exclusions> <exclusion> <groupId>net.lotte.chamomile.module</groupId> <artifactId>chamomile-web</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>net.lotte.chamomile.boot</groupId> <artifactId>chamomile-boot-autoconfigure</artifactId> </dependency> <dependency> <groupId>net.lotte.chamomile</groupId> <artifactId>chamomile-core</artifactId> </dependency>

server: port: 8900 max-http-header-size: 200KB # Spring 애플리케이션 설정 spring: main: allow-bean-definition-overriding: true # 빈 정의를 재정의할 수 있는지 여부 application: name: chamomile-cloud-auth-gateway # 애플리케이션 이름 cloud: gateway: httpclient: pool: type: fixed # 고정 크기의 커넥션 풀 사용 max-connections: 2000 # 최대 커넥션 수 설정 max-idle-time: 30s # 유휴 커넥션 유지 시간 default-filters: - RemoveResponseHeader=Vary # 응답 헤더에서 'Vary' 제거 routes: - id: chamomile-cloud-gateway # 라우트 ID uri: lb://CHAMOMILE-CLOUD-GATEWAY # 로드 밸런싱된 URI predicates: - Path=/** # 모든 경로와 매칭 filters: - RewritePath=/(?<segment>.*), /${segment} # 경로를 리라이트 - AddRequestHeader=X-Gateway-ID, auth-gateway # 요청 헤더에 추가 management: endpoints: web: exposure: include: refresh, health, beans, httptrace, circuitbreakers endpoint: health: show-details: always # Health 엔드포인트의 세부 정보 항상 표시 rate-limiter: enabled: true # Rate Limiter의 health 체크 활성화 여부 eureka: instance: instance-id: springtestgateway:${spring.application.instance_id:${random.value}} client: register-with-eureka: true fetch-registry: true service-url: defaultZone: http://localhost:8761/eureka chmm: cache: instance: redis # 캐시 인스턴스 설정 (none/redis/hazelcast) auth-enable: true # 인증.인가 캐시 활성화 여부 resilience4j: timelimiter: configs: default: timeoutDuration: 60s # 호출 타임아웃 60초 설정 cancelRunningFuture: false # 타임아웃 발생 시 실행 중 작업 취소하지 않음