Spring Cloud Gateway를 이용한 API 게이트웨이 구현 방법

Spring Cloud Gateway는 마이크로서비스 아키텍처에서 API 게이트웨이를 구현하는 데 사용되는 도구입니다. 이를 통해 사용자는 여러 마이크로서비스를 하나의 엔드포인트로 노출할 수 있으며, 요청을 라우팅하고 필터링하여 보안성을 강화할 수 있습니다. 이번 글에서는 Spring Cloud Gateway를 이용한 API 게이트웨이를 구현하는 방법을 알아보겠습니다.

Spring Cloud Gateway란?

Spring Cloud Gateway는 Spring 프레임워크에서 제공하는 API 게이트웨이 도구입니다. 이를 이용하면 여러 개의 마이크로서비스가 존재할 때, 하나의 엔드포인트로 노출하여 사용할 수 있습니다. 또한 요청을 라우팅하고 필터링하여 보안성을 강화할 수 있으며, 다양한 로드 밸런싱 전략을 적용할 수 있습니다.

API 게이트웨이란?

API 게이트웨이는 마이크로서비스 아키텍처에서 클라이언트와 서버 사이의 중간 지점에 위치한 서버입니다. 이를 통해 여러 개의 마이크로서비스를 하나의 엔드포인트로 노출시킬 수 있으며, 요청을 라우팅하고 필터링하여 보안성을 강화할 수 있습니다. 또한 로드 밸런싱, 캐시, 감지, 분석 등의 기능도 제공합니다.

Spring Cloud Gateway를 이용한 구현 방법

Spring Cloud Gateway를 이용한 API 게이트웨이를 구현하는 방법에는 크게 3가지가 있습니다. 첫 번째는 Spring Cloud Gateway를 이용하여 라우팅하는 방법입니다. 두 번째는 Spring Cloud Gateway를 이용하여 필터링하는 방법입니다. 세 번째는 Spring Cloud Gateway를 이용하여 로드 밸런싱하는 방법입니다.

예제 코드와 함께 배우는 Spring Cloud Gateway

아래는 Spring Cloud Gateway를 이용하여 라우팅하는 예제 코드입니다.

@SpringBootApplication
public class GatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}

@Configuration
public class GatewayConfig {
    @Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
        return builder.routes()
            .route("first_route", r -> r.path("/first")
                .uri("http://localhost:8081"))
            .route("second_route", r -> r.path("/second")
                .uri("http://localhost:8082"))
            .build();
    }
}

위 코드에서는 /first 경로 요청 시에는 localhost:8081 서버로 라우팅하고, /second 경로 요청 시에는 localhost:8082 서버로 라우팅합니다.

아래는 Spring Cloud Gateway를 이용하여 필터링하는 예제 코드입니다.

@Bean
public GlobalFilter customFilter() {
    return ((exchange, chain) -> {
        ServerHttpRequest request = exchange.getRequest();
        if (request.getPath().toString().contains("/admin")) {
            throw new AccessDeniedException("Admin access denied");
        }
        return chain.filter(exchange);
    });
}

위 코드에서는 /admin 경로에 대한 요청 시에는 AccessDeniedException을 발생시킵니다.

아래는 Spring Cloud Gateway를 이용하여 로드 밸런싱하는 예제 코드입니다.

@Bean
public LoadBalancerClient loadBalancerClient() {
    return LoadBalancerClient.create();
}

@Bean
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
    return builder.routes()
        .route("first_route", r -> r.path("/first")
            .uri("lb://first-service"))
        .route("second_route", r -> r.path("/second")
            .filters(f -> f.stripPrefix(1))
            .uri("lb://second-service"))
        .build();
}

위 코드에서는 first-service와 second-service를 로드 밸런싱합니다. /first 경로 요청 시에는 first-service로, /second 경로 요청 시에는 second-service로 요청이 전달됩니다.

이번 글에서는 Spring Cloud Gateway를 이용한 API 게이트웨이를 구현하는 방법에 대해 알아보았습니다. Spring Cloud Gateway를 이용하면 여러 개의 마이크로서비스를 하나의 엔드포인트로 노출시킬 수 있으며, 요청을 라우팅하고 필터링하여 보안성을 강화할 수 있습니다. 또한 로드 밸런싱, 캐시, 감지, 분석 등의 기능도 제공합니다. 이러한 기능을 활용하여 안정적이고 확장성 있는 API 게이트웨이를 구현해보세요!

Reference : Spring Cloud Gateway를 이용한 API 게이트웨이 구현 방법