Flipper项目Redis适配器内部机制解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00544/article/details/148552548

Flipper项目Redis适配器内部机制解析

flipper 🐬 Beautiful, performant feature flags for Ruby. 项目地址: https://gitcode.com/gh_mirrors/flip/flipper

概述

Flipper是一个功能强大的功能开关(Feature Flags)管理库，它允许开发者在运行时动态地启用或禁用应用程序的功能。本文将通过分析Redis适配器的内部实现机制，深入理解Flipper如何利用Redis存储和管理功能开关状态。

环境准备与初始化

首先，我们需要设置基础环境并初始化Redis客户端：

require 'bundler/setup'
require 'pp'
require 'logger'
require 'flipper/adapters/redis'

client = Redis.new

这段代码加载了必要的依赖，包括用于美化输出的pp库、日志记录器logger，以及Flipper的Redis适配器。然后创建了一个Redis客户端实例。

功能组注册

Flipper允许定义功能组，这些组可以根据特定条件动态确定成员资格：

Flipper.register(:admins) { |actor| actor.admin? }
Flipper.register(:early_access) { |actor| actor.early_access? }

这里注册了两个组：

:admins组：成员需满足admin?方法返回true
:early_access组：成员需满足early_access?方法返回true

用户模型定义

为了演示，我们定义了一个简单的用户结构：

User = Struct.new(:flipper_id)

在实际应用中，用户模型通常会更复杂，但Flipper只需要它能响应flipper_id方法即可。

功能开关配置

接下来，我们配置了两个功能开关:stats和:search：

Flipper[:stats].enable
Flipper[:stats].enable_group :admins
Flipper[:stats].enable_group :early_access
Flipper[:stats].enable_actor User.new('25')
Flipper[:stats].enable_actor User.new('90')
Flipper[:stats].enable_actor User.new('180')
Flipper[:stats].enable_percentage_of_time 15
Flipper[:stats].enable_percentage_of_actors 45

Flipper[:search].enable

这段配置展示了Flipper的多种启用方式：

完全启用(enable)
为特定组启用(enable_group)
为特定用户启用(enable_actor)
按时间百分比启用(enable_percentage_of_time)
按用户百分比启用(enable_percentage_of_actors)

Redis存储结构分析

让我们看看这些配置在Redis中是如何存储的。

功能列表

所有注册的功能都存储在一个Redis集合中：

client.smembers("flipper_features")  # => ["stats", "search"]

这个集合记录了所有已定义的功能开关名称。

功能详细配置

每个功能的详细配置存储在单独的Redis哈希中：

stats功能

client.hgetall('stats')
# => {
#   "boolean"=>"true",
#   "groups/admins"=>"1",
#   "actors/25"=>"1",
#   "percentage_of_time"=>"15",
#   "percentage_of_actors"=>"45",
#   "groups/early_access"=>"1",
#   "actors/90"=>"1",
#   "actors/180"=>"1"
# }

这个哈希包含了:stats功能的所有配置：

boolean: 表示功能是否全局启用
groups/*: 表示哪些组被启用
actors/*: 表示哪些用户被单独启用
percentage_of_time: 时间百分比值
percentage_of_actors: 用户百分比值

search功能

client.hgetall('search')  # => {"boolean"=>"true"}

相比之下，:search功能只设置了全局启用标志。

适配器数据获取

Flipper适配器提供了统一的接口获取功能配置：

Flipper.adapter.get(Flipper[:stats])
# => {
#   :boolean=>"true",
#   :groups=>#<Set: {"admins", "early_access"}>,
#   :actors=>#<Set: {"25", "90", "180"}>,
#   :percentage_of_actors=>"45",
#   :percentage_of_time=>"15"
# }

适配器将Redis中的原始数据转换为更易用的Ruby数据结构，包括将组和用户ID转换为Set集合。