/spring-cloud-example

A simple demo of Spring Cloud, and can run directly in docker-compose or kubernetes/minikube.

Primary LanguageJavaMIT LicenseMIT

Spring Cloud Example

An example for learning Spring Cloud.

Overview

Modules

  • cloud-config - usage of spring cloud config
  • cloud-gateway - usage of spring cloud netflix zuul
  • cloud-registry - usage of spring cloud netflix eureka
  • cloud-service-a - service-a provides endpoints /hello and /unstable
  • cloud-service-b - service-b provides endpoints /hello and /unstable

Requirements

  • JDK 8
  • Maven 3.3.9+
  • Docker 1.12.0+

Run in docker-compose

Make sure the port 8080 and 8761 is available, and the docker daemon can use 8G+ memory.

$ mvn package
$ docker-compose up

It will take two or three minutes for all services are ready. If everything is ok, each service will be running with 2 instances except cloud-gateway. Check the eureka page http://localhost:8761.

To verify if the services are working, repeat the following commands for several times:

$ curl http://localhost:8080/a/hello?name=shuaicj
$ curl http://localhost:8080/b/hello?name=shuaicj

and focus on the content printed out:

  • Check the IPs of the same service. It means multiple service instances are working.
  • Check if [FALLBACK] appears. It means Netflix Hystrix is working.

Run in minikube

Make sure the port 30000 and 30001 is available, and the minikube can use 8G+ memory.

$ kubectl create -f k8s

It will take two or three minutes for all services are ready. If everything is ok, each service will be running with 2 instances except cloud-gateway. Check the eureka page which is implied by minikube service registry --url.

To verify if the services are working, repeat the following commands for several times:

$ curl $(minikube service gateway --url)/a/hello?name=shuaicj
$ curl $(minikube service gateway --url)/b/hello?name=shuaicj

and focus on the content printed out:

  • Check the IPs of the same service. It means multiple service instances are working.
  • Check if [FALLBACK] appears. It means Netflix Hystrix is working.

See Also

shuaicj/spring-cloud-tutorials