Skip to content

Latest commit

 

History

History
86 lines (58 loc) · 3.98 KB

README.md

File metadata and controls

86 lines (58 loc) · 3.98 KB
Raw

08 - Build a Spring Cloud Gateway

This guide is part of the Azure Spring Cloud training

Build a Spring Cloud Gateway to route HTTP requests to the correct Spring Boot microservices.

Create a Spring Cloud Gateway

The application that we create in this guide is available here.

To create our gateway, we will use https://start.spring.io/ with the command line:

curl https://start.spring.io/starter.tgz -d dependencies=cloud-gateway,cloud-eureka,cloud-config-client -d baseDir=gateway -d bootVersion=2.3.8 -d javaVersion=1.8 | tar -xzvf -

We use the Cloud Gateway, Eureka Discovery Client and the Config Client components.

Configure the application

Rename src/main/resources/application.properties to src/main/resources/application.yml and add the following configuration:

spring:
  main:
    allow-bean-definition-overriding: true
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true
      globalcors:
        corsConfigurations:
          '[/**]':
            allowedOrigins: "*"
            allowedMethods:
              - GET
  • The spring.main.allow-bean-definition-overriding=true part is to configure Spring Cloud Gateway to use the Spring Cloud Discovery Server bean configured in the Azure Spring Cloud Client library.
  • The spring.cloud.gateway.discovery.locator.enabled=true part is to configure Spring Cloud Gateway to use the Spring Cloud Service Registry to discover the available microservices.
  • The spring.cloud.gateway.globalcors.corsConfiguration part is to allow CORS requests to our gateway. This will be helpful in the next guide, when we will add a front-end that is not hosted on Azure Spring Cloud.

Create the application on Azure Spring Cloud

As in 02 - Build a simple Spring Boot microservice, create a specific gateway application in your Azure Spring Cloud instance. As this application is a gateway, we add the --is-public true flag so it is exposed publicly.

az spring-cloud app create -n gateway --is-public true

Deploy the application

You can now build your "gateway" project and send it to Azure Spring Cloud:

cd gateway
./mvnw clean package -DskipTests
az spring-cloud app deploy -n gateway --jar-path target/demo-0.0.1-SNAPSHOT.jar
cd ..

Test the project in the cloud

  • Go to "Apps" in your Azure Spring Cloud instance.
    • Verify that gateway has a Discovery status which says UP(1),DOWN(0). This shows that it is correctly registered in the Spring Cloud Service Registry.
    • Select gateway to have more information on the microservice.
  • Copy/paste the public URL that is provided (there is a "Test Endpoint" like for microservices, but the gateway is directly exposed on the Internet, so let's use the public URL). Keep this URL handy for subsequent sections.

As the gateway is connected to the Spring Cloud Service Registry, it should have automatically opened routes to the available microservices, with URL paths in the form of /MICROSERVICE-ID/**: [The MICROSERVICE-ID must be in capital letters]

  • Test the city-service microservice endpoint by doing: curl https://XXXXXXXX-gateway.azuremicroservices.io/CITY-SERVICE/cities (replacing XXXXXXXX with the name of your Azure Spring Cloud instance)
  • Test the weather-service microservice endpoint by doing: curl 'https://XXXXXXXX-gateway.azuremicroservices.io/WEATHER-SERVICE/weather/city?name=Paris%2C%20France' (replacing XXXXXXXX by the name of your gateway)

If you need to check your code, the final project is available in the "gateway" folder.

⬅️ Previous guide: 07 - Build a Spring Boot microservice using MySQL

➡️ Next guide: 09 - Putting it all together, a complete microservice stack