KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #deepseek-harness #windows #open-source #agent-skills #ai

spring-cloud-learning

★ 40 Open GitHub ↗

:cloud:适合刚接触微服务架构的初学者了解和学习微服务，主要集成了注册中心、服务网关、配置中心、熔断机制、应用监控。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Spring-Cloud-Learning

[![Build Status](https://travis-ci.org/coderqianlq/spring-cloud-learning.svg?branch=master)](https://travis-ci.org/coderqianlq/spring-cloud-learning)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/coderqianlq/spring-cloud-learning/master/LICENSE)
[![Coverage Status](https://coveralls.io/repos/github/coderqianlq/spring-cloud-learning/badge.svg?branch=master)](https://coveralls.io/github/coderqianlq/spring-cloud-learning?branch=master)

README: [English](README.md) | [中文](README-zh.md)

spring-cloud-learning can be used as a project to learn microservices, and it's mainly contain service discovery, service gateway, configuration management, circuit breakers, application monitor.

## Table of Contents

* [Components](#components)
* [Getting Started](#getting-started)
  * [Use directly (recommend)](#use-directly-recommend)
  * [Use docker](#use-docker)
* [Preview](#preview)
* [Modules](#modules)
* [Dependency Chart](#dependency-chart)
* [Todo List](#todo-list)
* [Collaborators](#collaborators)
* [License](#license)

## Components

- [x] Eureka
- [x] Consul
- [ ] Ribbon
- [x] Feign
- [x] Hystrix
- [x] Turbine
- [x] Zuul
- [x] Spring Cloud Config
- [x] Spring Cloud Stream
- [x] Spring Cloud Bus
- [ ] Spring Cloud Sleuth
- [ ] Spring Cloud Security
- [ ] Spring Cloud Task
- [x] Spring Cloud Gateway

To be supplemented...

## Getting Started

Two methods will mainly introduced, but no matter what you need to clone the code.

```
$ git clone https://github.com/coderqianlq/spring-cloud-learning.git
```

### Use directly (recommend)

You can use ide to import the project with maven, and use ide or use command line to start project.

```
$ mvn spring-boot:run
```

You can also package the code and run it.

```
$ java -jar xxx.jar
```

### Use docker

First, you have to make sure you have installed docker and start docker server.

```
$ docker --version
Docker version 18.06.1-ce, build e68fc7a
```

Then, you need to enter each submodule and execute the docker building command.

```
$ cd eureka-server

$ mvn clean package -Pdocker docker:build
```

Next, return to the parent module and execute docker-compose command.

```
$ docker-compose up -d
```

Finally, you can open the registration center(default url: http://localhost:8761) to see if the service is registered successfully.

## Preview

![Spring boot admin wallboard](https://raw.githubusercontent.com/coderqianlq/spring-cloud-learning/master/screenshots/Spring%20boot%20admin%20wallboard.png)

![Spring Boot admin detail](https://raw.githubusercontent.com/coderqianlq/spring-cloud-learning/master/screenshots/Spring%20boot%20admin%20detail.png)

![Service customer hystrix stream](https://raw.githubusercontent.com/coderqianlq/spring-cloud-learning/master/screenshots/Service%20customer%20hystrix%20stream.png)

![Hystrix monitor](https://raw.githubusercontent.com/coderqianlq/spring-cloud-learning/master/screenshots/Hystrix%20monitor.png)

## Modules

|      -            |     port     |     remarks     |
| :-------------    | :----------: | :-------------: |
| admin-dashboard   |     8040     | Spring boot Admin Dashboard for monitor spring cloud services |
| api-gateway       |     9090     | Service gateway(Zuul) |
| config-server     |     8504     | if you change the port, you need also modify bootstrap.yml of service-customer. |
| consul-server     |     8502     | Service discovery(Consul) |
| eureka-server     |     8761     | Service discovery(Eureka) |
| gateway-server    |     8080     | Service gateway(Gateway) |
| hystrix-dashboard |     8050     |                 |
| service-customer  |     8200     | Integrated multiple components, including Feign, Spring Cloud Config, Spring Cloud Stream, Spring Cloud Bus |
| service-producer  |     8100     |                 |
| turbine-server    |     8060     |                 |
| zipkin-server     |     9411     | if you change the port, you need also modify bootstrap.yml of service-customer. |

## Dependency Chart

| Spring Boot | Spring Cloud | Spring Boot Admin | Swagger2 |
| :---------: | :----------: | :---------------: | :------: |
|    2.1.5    |   Greenwich  |       2.1.6       |   2.7.0  |

## Todo List

- [ ] Split the module of service-customer.
- [x] Add the detailed usage of hystrix with turbine.
- [x] Update Spring Boot to 2.x and both Spring Cloud to Greenwich.
- [x] Add Spring Boot admin dashboard.
- [x] Use Spring Cloud Gateway replaces zuul as service gateway.

## Collaborators

<table>
 <tr>
 <td align="center">
 <a href="https://github.com/Marveliu">
 <img src="https://avatars3.githubusercontent.com/u/15508722?v=4" width="100" alt=""/>
 
 Marveliu
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/Joby1230">
 <img src="https://avatars3.githubusercontent.com/u/23372369?v=4" width="100" alt=""/>
 
 Joby1230
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/wxaaaa">
 <img src="https://avatars3.githubusercontent.com/u/19554712?&v=4" width="100" alt=""/>
 
 wxaaaa
 </a>
 </td>
 </tr>
</table>

spring-cloud-learning

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README