supabase / supavisor / 26505402060

76%

Build Type

push

github

Committed by web-flow

Commit Message

chore: report current, permanent, base and previous versions (#983)

Based on the `:release_handler.which_releases()`.

Versions:
- **current** — version currently running (`Application.spec(:supavisor,
:vsn)`)
- **permanent** — version that boots on next restart
(`:release_handler.which_releases/0` status `:permanent`)
- **base** — oldest `:old` release (the original installation, i.e.
`upgrade_from`)
- **previous** — newest `:old` release (the version just before the last
hot upgrade)

`base` and `previous` are `""` when no upgrade has been applied.

## Tag semantics

```
┌───────────────────────────────────────┬─────────┬───────────┬───────┬──────────┐
│               Scenario                │ current │ permanent │ base  │ previous │
├───────────────────────────────────────┼─────────┼───────────┼───────┼──────────┤
│ Steady state (no upgrades)            │ 2.9.4   │ 2.9.4     │ ""    │ ""       │
├───────────────────────────────────────┼─────────┼───────────┼───────┼──────────┤
│ After 1 upgrade (2.9.3→2.9.4)         │ 2.9.4   │ 2.9.4     │ 2.9.3 │ 2.9.3    │
├───────────────────────────────────────┼─────────┼───────────┼───────┼──────────┤
│ After 2 upgrades (2.9.2→2.9.3→2.9.4)  │ 2.9.4   │ 2.9.4     │ 2.9.2 │ 2.9.3    │
├───────────────────────────────────────┼─────────┼───────────┼───────┼──────────┤
│ During upgrade, before make_permanent │ 2.9.4   │ 2.9.3     │ 2.9.2 │ 2.9.3    │
└───────────────────────────────────────┴─────────┴───────────┴───────┴──────────┘
```

## Example output

Right after `install_release` (before `make_permanent`): `permanent`
still points to the previous version, confirming the upgrade is in
progress:

```
supavisor_prom_ex_application_version_info{...,base="",current="2.9.5",permanent="2.9.4",previous=""} 1
```

After `make_permanent`: both `current` and `permanent` are the new
version, `previous` records what was just replaced:

```
supavisor_prom_ex_application_version_info{...,base="2.9.4",current="2.9.5",permane... (continued)

Coverage Stats

10 of 25 new or added lines in 2 files covered. (40.0%)

2 existing lines in 2 files now uncovered.

2543 of 3330 relevant lines covered (76.37%)

55409.56 hits per line