Semian 开源项目教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00094/article/details/138839581

Semian 开源项目教程

semian :monkey: Resiliency toolkit for Ruby for failing fast 项目地址: https://gitcode.com/gh_mirrors/se/semian

1. 项目介绍

Semian 是一个用于 Ruby 的弹性工具包，旨在快速失败以避免级联故障。当外部服务变慢或无响应时，Semian 通过拦截资源访问来控制对这些服务的访问，从而避免级联故障。Semian 的核心功能包括：

断路器（Circuit Breaker）：限制对有问题的依赖服务的请求数量。
隔离（Bulkheading）：控制对单个资源的并发访问，通过 SysV 信号量在服务器范围内协调访问。

Semian 通过猴子补丁（Monkey Patching）资源驱动程序来实现这些功能，确保每次资源访问请求时，Semian 都会首先查询资源的状态。如果 Semian 认为资源不可用，它会立即引发异常，而不是等待超时。

2. 项目快速启动

安装

首先，将 Semian 添加到你的 Gemfile 中，并要求你需要的适配器：

gem 'semian'
require 'semian/mysql2'
require 'semian/redis'

然后运行 bundle install 来安装 Semian。

配置

在初始化资源客户端时，需要传递 semian 参数来配置 Semian。以下是 MySQL 和 Redis 客户端的配置示例：

MySQL 客户端配置

client = Mysql2::Client.new(
  host: "localhost",
  username: "root",
  semian: {
    name: "master",
    tickets: 8,
    success_threshold: 2,
    error_threshold: 3,
    error_timeout: 10
  }
)

Redis 客户端配置

client = Redis.new(
  semian: {
    name: "inventory",
    tickets: 4,
    success_threshold: 2,
    error_threshold: 4,
    error_timeout: 20
  }
)

使用

Semian 通过拦截资源访问来工作。每次访问请求时，Semian 都会被查询，如果资源根据断路器或隔离机制被认为不可用，Semian 将引发异常。你可以在应用程序代码中捕获这些异常并进行优雅的回退处理。

3. 应用案例和最佳实践

应用案例

Semian 在 Shopify 的生产环境中已经成功运行多年，用于处理外部服务的故障和延迟。通过 Semian，Shopify 能够快速失败并优雅地处理这些故障，从而避免级联故障。

最佳实践

适配器配置：确保在 Gemfile 中直接要求适配器，以确保 Semian 适配器尽早加载，并保护应用程序在启动时的安全。
异常处理：在应用程序代码中捕获基础异常类，以便同时处理 Semian 和驱动程序的错误。
线程安全：从 v0.7.0 开始，Semian 的断路器实现默认是线程安全的。如果需要禁用线程安全以提高性能，可以在资源选项中传递 thread_safety_disabled: true。