MCloud — микросервисная инфраструктура

Проект

MCloud разработан на основе Spring Cloud и предоставляет следующие компоненты:

• mcloud-registry — сервис регистрации и обнаружения.
• Keycloak — аутентификация и управление пользователями.
• mcloud-apigw — API-шлюз, основанный на Spring cloud gateway, с использованием netflix-ribbon в качестве балансировщика нагрузки.
• mcloud-config — унифицированный конфигурационный центр на базе GitHub (использует этот репозиторий в качестве хранилища конфигурации).
• mcode-logs — система журналов на основе logstash, Kibana и ElasticSearch.
• mcloud-demo — демонстрационный проект.
• mcloud-console — системная консоль на основе ant-design-pro (временно недоступен из-за обновления Spring Cloud).

Другие компоненты:

• Code Generator — плагин для генерации кода для Intellij-IDEA.
• Документация доступна по ссылке https://www.docs4dev.com.

Зависимости

• Spring Boot 2.1.3.RELEASE.
• Spring Cloud Greenwich.RELEASE.
• Maven.
• JDK 1.8.

Среда

• JDK версии 1.8 или выше.
• IDE с установленным плагином lombok.
• Keycloak.

  Примечание: после установки Keycloak необходимо импортировать файл realm-export.json из каталога mcloud/data в Keycloak и вручную сбросить clientSecret для клиента mcloud в области mcloud. Новый clientSecret должен быть добавлен в application.yml в mcloud-demo.

Быстрый старт

Клонирование проекта

git clone https://github.com/heyuxian/mcloud.git

Сборка и запуск

Поскольку проект использует конфигурацию, необходимо сначала запустить mcloud-config, а затем последовательно запустить mcloud-registry, mcloud-apigw и mcloud-demo.

Запуск конфигурационного центра:

cd mcloud-config
mvn clean install spring-boot:run

Запуск регистрационного центра:

cd mcloud-registry
# Запустите три экземпляра регистрационного узла в трёх разных терминалах
mvn clean install spring-boot:run -Dspring.profiles.active=peer1
mvn clean install spring-boot:run -Dspring.profiles.active=peer2
mvn clean install spring-boot:run -Dspring.profiles.active=peer3

Запуск API-шлюза:

cd mcloud-apigw
mvn clean install spring-boot:run

Запуск демонстрационного проекта:

cd mcloud-demo
mvn clean install
# Запустите два экземпляра демонстрационного узла в двух разных терминалах
mvn spring-boot:run -Dspring.profiles.active=peer1
mvn spring-boot:run -Dspring.profiles.active=peer2

После запуска всех узлов необходимо получить access_token. После этого можно использовать этот токен для доступа к API:

curl --request GET \
  --url http://localhost/mcloud-demo/users/me \
  --header 'authorization: Bearer ${access_token}' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{}'

Проблемы и предложения

Если у вас есть какие-либо вопросы или предложения по этому проекту, пожалуйста, создайте Issue.