spring-cloud-gateway-routing

This project demonstrates the usage of API gateway between microservices using spring cloud gateway.

what is spring cloud gateway ?

Spring Cloud Gateway is an intelligent and programmable router based on Project Reactor.

Compatability Matrix

choose the branch based on below maintained versions.

Projects

Eureka Server Registration (Optional)

By default eureka is disabled.

eureka:
  client:
    enabled: false

To enable eureka, set below property in all the microservices and restart.

spring:
  profiles:
    active: eureka

How to build and run ?

• Download/Clone the repository :

  $ git clone https://github.com/BarathArivazhagan/spring-cloud-gateway-routing.git
  $ cd spring-cloud-gateway-routing
  $ ./mvnw clean install
  

• To run the application :

  $ docker-compose up
  

How to test the application ?

Use gateway routes to route to respective microservices.

spring cloud gateway route definition :

spring:
  cloud:
    gateway:
      routes:
        - id: jio-service
          uri: http://localhost:9501
          predicates:
          - Path= /jio/*
          filters:
          - StripPrefix=1 # required to strip the prefix made to the request . Ex /jio/customers request will go to jio service as /customers 
        - id: airtel-service
          uri: http://localhost:9502
          predicates:
          - Path= /airtel/*
          filters:
          - StripPrefix=1
        - id: vodaphone-service
          uri: http://localhost:9503
          predicates:
          - Path= /vodaphone/*
          filters:
          - StripPrefix=1

$ curl http://localhost:9500/jio/customers

[
    {
        "customerName": "barath-jio",
        "customerAge": 25,
        "customerGender": "MALE"
    }
]

$ curl http://localhost:9500/airtel/customers

[
    {
        "customerName": "barath-airtel",
        "customerAge": 25,
        "customerGender": "MALE"
    }
]

$ curl http://localhost:9500/vodaphone/customers

[
    {
        "customerName": "barath-vodaphone",
        "customerAge": 25,
        "customerGender": "MALE"
    }
]

Header based routing strategy

Enable SPRING_PROFILES_ACTIVE=header to test header based routing strategy

Query param based routing strategy

Enable SPRING_PROFILES_ACTIVE=query to test query param based routing strategy

Eureka Registration View

How to rebuild the project after the changes?

  docker-compose build

References

• spriing-cloud

• spring-cloud-gateway