Aquarius 开源项目教程

Aquarius 开源项目教程

Aquarius 🔱 Nepxion Aquarius is a list of distribution components based on Redis + Zookeeper with Nepxion Matrix AOP framework, including distribution lock, cache, id generator, limitation 分布式锁、缓存、全局唯一主键、限流 项目地址: https://gitcode.com/gh_mirrors/aq/Aquarius

项目介绍

Aquarius 是一个基于 Spring Boot 和 Spring Cloud 的分布式限流、熔断、降级、隔离、追踪、流量染色、灰度发布、配置动态化、路由策略、调用链监控等功能的分布式系统框架。它旨在帮助开发者构建高可用、高性能的分布式应用系统。Aquarius 提供了丰富的功能模块，包括限流、熔断、降级、隔离、追踪、流量染色、灰度发布、配置动态化、路由策略、调用链监控等，能够有效提升系统的稳定性和可靠性。

项目快速启动

环境准备

在开始之前，请确保你已经安装了以下环境：

• JDK 1.8 或更高版本
• Maven 3.x
• Git

克隆项目

首先，克隆 Aquarius 项目到本地：

git clone https://github.com/Nepxion/Aquarius.git

构建项目

进入项目目录并使用 Maven 进行构建：

cd Aquarius
mvn clean install

启动示例应用

Aquarius 提供了一个示例应用，你可以通过以下命令启动：

cd aquarius-example
mvn spring-boot:run

访问示例应用

启动成功后，你可以通过浏览器访问以下地址来查看示例应用：

http://localhost:8080

应用案例和最佳实践

限流

Aquarius 提供了多种限流策略，包括基于 IP、用户、接口等的限流。以下是一个简单的限流配置示例：

aquarius:
  rate-limiter:
    enabled: true
    type: ip
    limit: 100
    timeout: 1000

熔断

Aquarius 支持基于 Hystrix 的熔断机制，可以在服务调用失败时快速失败，避免级联故障。以下是一个熔断配置示例：

aquarius:
  circuit-breaker:
    enabled: true
    type: service
    failure-rate-threshold: 50
    wait-duration-in-open-state: 5000

降级

Aquarius 提供了降级策略，可以在服务不可用时返回默认值或执行备用逻辑。以下是一个降级配置示例：

aquarius:
  fallback:
    enabled: true
    type: service
    fallback-method: defaultFallback

典型生态项目

Spring Cloud

Aquarius 是基于 Spring Cloud 构建的，因此它可以与 Spring Cloud 生态中的其他项目无缝集成，如 Eureka、Zuul、Feign 等。

Apache SkyWalking

Aquarius 支持与 Apache SkyWalking 集成，提供调用链监控和性能分析功能。

Nacos

Aquarius 支持与 Nacos 集成，实现配置的动态管理和服务的注册与发现。

Sentinel

Aquarius 支持与 Alibaba Sentinel 集成，提供更强大的限流、熔断和降级功能。

通过以上模块的介绍和示例，你可以快速上手 Aquarius 项目，并将其应用到实际的分布式系统开发中。

Aquarius 🔱 Nepxion Aquarius is a list of distribution components based on Redis + Zookeeper with Nepxion Matrix AOP framework, including distribution lock, cache, id generator, limitation 分布式锁、缓存、全局唯一主键、限流 项目地址: https://gitcode.com/gh_mirrors/aq/Aquarius