rust/neon
1
0
Fork 0
mirror of https://github.com/neondatabase/neon.git synced 2026-01-16 18:02:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs/rfc: add gradual feature rollout

Browse Source 
Signed-off-by: Alex Chi Z <chi@neon.tech>
This commit is contained in:
Alex Chi Z
2025-04-25 15:49:35 -04:00
parent 257aa9e9cf
commit b2623137e0
1 changed files with 16 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/rfcs/0XY-storcon-rollout.md
View File

@@ -1,6 +1,10 @@
# Feature Rollout on Storage Controller
describes the rollout interface from the user's perspective; no implementation idea yet, might be infeasible, and needs to figure out.
This RFC describes the rollout interface from a user's perspective. I do not have a concreate implementation idea
yet, but the operations described below should be intuitively feasible to implement -- most of them map to a single
SQL inside the storcon database and then some reconcile operations.
What will it look like if we want to rollout gc-compaction gradually?
Create a feature called gc-compaction.
@@ -58,16 +62,25 @@ Week 3: rollout gradually to 50% larger tenants before Jun 1. The storage contro
$ storcon-cli feature scheduled-rollout --job gc-compaction --config-set enable --filter "remote_size < 100GB" --coverage-percentage 50 --cron "0 0 * * *" --before 2025-06-01 00:00:00
```
Week 4: we discover a bug and need to immediately stop the feature across the fleet.
Week 4: we discover a bug over a specific tenant and want to disable gc-compaction on it,
```
$ storcon-cli feature rollout --job gc-compaction --config-set default --filter "tenant-id=<id>" --coverage-percentage all
rollout succeeded, operation_id=11
```
Then we realize that this bug might affect all tenants and decide to disable it for all tenants:
```
$ storcon-cli feature rollout --job gc-compaction --config-set default --coverage-percentage all
rollout succeeded, operation_id=10
```
We get a fix and can re-enable it on those tenants which had the feature enabled previously.
```
$ storcon-cli feature rollout --job gc-compaction --config-set enable --filter "in (history_id <= 10)" --coverage-percentage all
$ storcon-cli feature rollout --job gc-compaction --revert 11
$ storcon-cli feature rollout --job gc-compaction --revert 10
```
Week 5: enable by default