/spring-cloud-tutorials

Spring Cloud Tutorials

Primary LanguageJavaMIT LicenseMIT

Spring Cloud Tutorials

Tutorials for learning Spring Cloud. Each example shows the basic usage of one component of Spring Cloud. See also shuaicj/spring-cloud-example for a complete demo.

Compile

$ mvn clean package

Modules

  • tt01-config-native - Configuration with native mode of Spring Cloud Config

    • Run
      • $ java -jar tt01*/*server/target/*.jar
      • $ java -jar tt01*/*client/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello should print port: 8080, message: Hello, I'm tt01.

  • tt02-config-git - Configuration with git mode of Spring Cloud Config

    • Run
      • $ java -jar tt02*/*server/target/*.jar
      • $ java -jar tt02*/*client/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello should print port: 8080, message: Hello, I'm tt02.

  • tt03-config-zookeeper - Configuration with Spring Cloud Zookeeper

    • Install and start Zookeeper. If using Homebrew on Mac:
      • $ brew install zookeeper
      • $ zkServer start

      Now a local zookeeper is running at localhost:2181.

    • Create configurations in zookeeper:
      • $ zkCli
      • zk$ create /config ''
      • zk$ create /config/tt03-hello ''
      • zk$ create /config/tt03-hello/server ''
      • zk$ create /config/tt03-hello/server/port 8080
      • zk$ create /config/tt03-hello/hello ''
      • zk$ create /config/tt03-hello/hello/message "Hello, I'm tt03."
    • Run
      • $ java -jar tt03*/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello should print port: 8080, message: Hello, I'm tt03.

  • tt04-config-consul - Configuration with Spring Cloud Consul

    • Install and start Consul. If using Homebrew on Mac:
      • $ brew install consul
      • $ consul agent -dev -advertise 127.0.0.1

      Now a consul agent is running at localhost:8500.

    • Create configurations in consul:
      • $ consul kv put config/tt04-hello/server/port 8080
      • $ consul kv put config/tt04-hello/hello/message "Hello, I'm tt04."
    • Run
      • $ java -jar tt04*/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello should print port: 8080, message: Hello, I'm tt04.

  • tt11-eureka-standalone - Standalone mode of Spring Cloud Netflix Eureka

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt11*/*client/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello should print out instance info.
      • Open http://localhost:8761 in browser to check eureka portal.
      • Open http://localhost:8761/eureka/apps in browser to check registered services.

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt12-eureka-ha - HA mode of Spring Cloud Netflix Eureka

    • Run
      • $ java -jar tt12*/*server/target/*.jar --spring.profiles.active=peer1
      • $ java -jar tt12*/*server/target/*.jar --spring.profiles.active=peer2
      • $ java -jar tt12*/*client/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello should print out instance info.
      • Open http://localhost:8761 or http://localhost:8762 in browser to check eureka portal.
      • Open http://localhost:8761/eureka/apps in browser to check registered services.

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt13-eureka-config - Register config server to Spring Cloud Netflix Eureka

    • Run
      • $ java -jar tt13*/*eureka-server/target/*.jar
      • $ java -jar tt13*/*config-server/target/*.jar
      • $ java -jar tt13*/*config-client/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello should print port: 8080, message: Hello, I'm tt13.

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt21-hystrix - Simple usage of Spring Cloud Netflix Hystrix

    • Run
      • $ java -jar tt21*/target/*.jar
    • Verify
      • $ curl http://localhost:8080/hello?name=abc should print Hello ABC!.
      • $ curl http://localhost:8080/hello?name=a should print Hello A [FALLBACK]!.

  • tt22-hystrix-timeout - Timeout of Spring Cloud Netflix Hystrix

    • Run
      • $ java -jar tt22*/*api/target/*.jar
      • $ java -jar tt22*/*consumer/target/*.jar
    • Verify
      • Repeat the following curl and CONSUMER [FALLBACK] should be printed out randomly.
        • $ curl http://localhost:8081/consume

  • tt23-hystrix-dashboard - Dashboard of Spring Cloud Netflix Hystrix

    • Run
      • $ java -jar tt23*/*server/target/*.jar
      • $ java -jar tt23*/*client/target/*.jar
    • Verify
      • Open http://localhost:8081/hystrix in browser and you will see the dashboard. Input http://localhost:8080/hystrix.stream and click Monitor Stream button.
      • Do the following two curl randomly and watch the changes on dashboard.
        • $ curl http://localhost:8080/hello?name=abc
        • $ curl http://localhost:8080/hello?name=a

  • tt31-ribbon-resttemplate - RestTemplate and Spring Cloud Netflix Ribbon

    • Run
      • $ java -jar tt31*/*api/target/*.jar --server.port=8081 --hello.id=server-1
      • $ java -jar tt31*/*api/target/*.jar --server.port=8082 --hello.id=server-2
      • $ java -jar tt31*/*consumer/target/*.jar
    • Verify
      • Repeat the following curl and server-1, server-2 should say hello by turns.
        • $ curl http://localhost:8080/consume

  • tt32-ribbon-eureka - Spring Cloud Netflix Ribbon with Eureka

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt32*/*api/target/*.jar --server.port=8081 --hello.id=server-1
      • $ java -jar tt32*/*api/target/*.jar --server.port=8082 --hello.id=server-2
      • $ java -jar tt32*/*consumer/target/*.jar
    • Verify
      • Repeat the following curl and server-1, server-2 should say hello by turns.
        • $ curl http://localhost:8080/consume

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt41-feign - Simple usage of Spring Cloud Netflix Feign

    • Run
      • $ java -jar tt41*/*api/target/*.jar --server.port=8081 --hello.id=server-1
      • $ java -jar tt41*/*api/target/*.jar --server.port=8082 --hello.id=server-2
      • $ java -jar tt41*/*consumer/target/*.jar
    • Verify
      • Repeat the following curl and server-1, server-2 should say hello by turns.
        • $ curl http://localhost:8080/consume

  • tt42-feign-hystrix-eureka - Spring Cloud Netflix Feign with Hystrix, Eureka

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt42*/*api/target/*.jar --server.port=8081 --hello.id=server-1
      • $ java -jar tt42*/*api/target/*.jar --server.port=8082 --hello.id=server-2
      • $ java -jar tt42*/*consumer/target/*.jar
    • Verify
      • Repeat the following curl and hystrix fallback should be triggered randomly.
        • $ curl http://localhost:8080/consume

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt51-turbine - Simple usage of Spring Cloud Netflix Turbine

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt51*/*api-1/target/*.jar --server.port=8081 --hello.id=server-1-1
      • $ java -jar tt51*/*api-1/target/*.jar --server.port=8082 --hello.id=server-1-2
      • $ java -jar tt51*/*api-2/target/*.jar --server.port=8083 --hello.id=server-2-1
      • $ java -jar tt51*/*api-2/target/*.jar --server.port=8084 --hello.id=server-2-2
      • $ java -jar tt51*/*server/target/*.jar
      • $ java -jar tt23*/*server/target/*.jar --server.port=9090
    • Verify
      • Open http://localhost:9090/hystrix in browser and you will see the dashboard. Input http://localhost:8080/turbine.stream and click Monitor Stream button.
      • Do the following two curl randomly and watch the changes on dashboard.
        • $ curl http://localhost:8081/consume
        • $ curl http://localhost:8082/consume
        • $ curl http://localhost:8083/consume
        • $ curl http://localhost:8084/consume

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt52-turbine-rabbitmq - Spring Cloud Netflix Turbine with RabbitMQ

    • Install and start RabbitMQ. If using Homebrew on Mac:
      • $ brew install rabbitmq
      • $ rabbitmq-server

      Now you can check if rabbitmq is running in browser http://localhost:15672.

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt52*/*api-1/target/*.jar --server.port=8081 --hello.id=server-1-1
      • $ java -jar tt52*/*api-1/target/*.jar --server.port=8082 --hello.id=server-1-2
      • $ java -jar tt52*/*api-2/target/*.jar --server.port=8083 --hello.id=server-2-1
      • $ java -jar tt52*/*api-2/target/*.jar --server.port=8084 --hello.id=server-2-2
      • $ java -jar tt52*/*server/target/*.jar
      • $ java -jar tt23*/*server/target/*.jar --server.port=9090
    • Verify
      • Same as tt51-turbine

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt61-zuul - Simple usage of Spring Cloud Netflix Zuul

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt61*/*api-1/target/*.jar --server.port=8081 --hello.id=server-1-1
      • $ java -jar tt61*/*api-1/target/*.jar --server.port=8082 --hello.id=server-1-2
      • $ java -jar tt61*/*api-2/target/*.jar --server.port=8083 --hello.id=server-2-1
      • $ java -jar tt61*/*api-2/target/*.jar --server.port=8084 --hello.id=server-2-2
      • $ java -jar tt61*/*server/target/*.jar
    • Verify
      • Repeat the following curl and each service instance should say hello by turns.
        • $ curl http://localhost:8080/tt61-api-1/hello
        • $ curl http://localhost:8080/tt61-api-2/hello

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt62-zuul-route - Customize routes of Spring Cloud Netflix Zuul

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt61*/*api-1/target/*.jar --server.port=8081 --hello.id=server-1-1
      • $ java -jar tt61*/*api-1/target/*.jar --server.port=8082 --hello.id=server-1-2
      • $ java -jar tt61*/*api-2/target/*.jar --server.port=8083 --hello.id=server-2-1
      • $ java -jar tt61*/*api-2/target/*.jar --server.port=8084 --hello.id=server-2-2
      • $ java -jar tt62*/target/*.jar
    • Verify
      • Repeat the following curl and each service instance should say hello by turns.
        • $ curl http://localhost:8080/api1/hello
        • $ curl http://localhost:8080/api2/hello

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt71-sleuth - Simple usage of Spring Cloud Sleuth

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt71*/*api-1/target/*.jar
      • $ java -jar tt71*/*api-2/target/*.jar
      • $ java -jar tt71*/*api-3/target/*.jar
    • Verify
      • $ curl http://localhost:8081/hello?name=user
      • and you shoud see some log text like 
        [tt71-api-1,aff79919529ce79f,4a8442d5d47112ba,false]
        which means 
        [appname,traceId,spanId,exportable]
        See doc for more details.

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt72-sleuth-feign - Spring Cloud Sleuth with Feign

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt72*/*api-1/target/*.jar
      • $ java -jar tt72*/*api-2/target/*.jar
      • $ java -jar tt72*/*api-3/target/*.jar
    • Verify
      • Same as tt71-sleuth

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt73-sleuth-zipkin - Spring Cloud Sleuth with Zipkin

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt73*/*server/target/*.jar
      • $ java -jar tt73*/*api-1/target/*.jar
      • $ java -jar tt73*/*api-2/target/*.jar
      • $ java -jar tt73*/*api-3/target/*.jar
    • Verify
      • Repeat $ curl http://localhost:8081/hello?name=user for several times.
      • Open http://localhost:9411 in browser and you should see tt73-api-1 or the other two.
        • Click Find Traces to check the service duration details.
        • Click Dependencies you should see 
          tt73-api-1  =>  tt73-api-2  => tt73-api-3

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.

  • tt74-sleuth-zipkin-rabbitmq - Spring Cloud Sleuth with Zipkin, RabbitMQ

    • Install and start RabbitMQ. If using Homebrew on Mac:
      • $ brew install rabbitmq
      • $ rabbitmq-server

      Now you can check if rabbitmq is running in browser http://localhost:15672.

    • Run
      • $ java -jar tt11*/*server/target/*.jar
      • $ java -jar tt74*/*server/target/*.jar
      • $ java -jar tt74*/*api-1/target/*.jar
      • $ java -jar tt74*/*api-2/target/*.jar
      • $ java -jar tt74*/*api-3/target/*.jar
    • Verify
      • Same as tt73-sleuth-zipkin

    It takes one or two minutes for Eureka to take effect. You should wait this time to do the verify.