Gray Release Strategies for Large Frontend Projects

Introduction

Gray release (gradual rollout) is a strategy to deploy new features to a subset of users to reduce risk. The article shares several practical schemes and implementation details.

Common Gray Release Schemes

1. Simple Nginx weighted routing

Deploy two builds, use Nginx weighted round‑robin and a front‑end SDK that stores a random identifier in a cookie to decide which version a user receives. Advantages: simple, no back‑end changes. Disadvantages: limited control, weak monitoring, cookie loss.

2. Nginx + Lua + Redis

Lua script in Nginx reads client IP, checks Redis for a stored flag, and routes accordingly. Provides more flexibility but still limited for complex business logic.

3. Server‑side rendering split

Two builds are deployed, a back‑end service adds a version cookie based on gray rules stored in Redis, and serves the appropriate index.html. Offers strong control but adds server load.

4. Client‑side conditional compilation

Uses code comments to enable/disable features; hard to maintain, not recommended.

5. Nginx + back‑end + Redis + Front‑end SDK

Stable and beta versions run behind separate Nginx instances; an entry Nginx forwards requests, the SDK sets a cookie and records the user in Redis. The back‑end can revoke gray access by clearing Redis or cookies.

Implementation Example

Node.js snippet demonstrates how a UUID is checked against an in‑memory list and a Redis‑like array to decide the version.

//这里只是演示，直接通过链接获取用户id，实际场景应该是通过获取用户会话去判别用户相关信息
const uuid = ctx.query.uuid;
//可以进入灰度版本的uuid，在数据库存放
const uuids = ['123','456','789'];
//redis 中存放了的的用户id，如果清理了redis，则意味着，取消用户的版本标识，这里简单的用数组存放，实际应用场景根据各自的业务信息考虑是否需要多集合存放
const redisUuids = [{id:'789',version:'beta'},{id:'333',version:'stable'}];
复制代码

Operational Tips

Rollback by disabling gray feature and clearing Redis/cookies.

Force a specific user to a version by editing Redis.

Limit gray release to certain pages via SDK logic.

Running the Demo

Use Docker Compose:

docker-compose build

docker-compose up -d

localhost:8000
复制代码

Conclusion

Select the scheme that fits your business; the provided code is illustrative and should be adapted to real projects.