detached 22a960f

feat(app): restart a stale broker once on connect

commit
22a960f0b347cadb4af62c741e1553fd53dd1deb
author
brice · · 2026-09-23 13:33 UTC
parent
1df3ba0
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
3 files · +37 -6
M internal/app/broker_offline.go +3 -1
@@ -272,6 +272,8 @@ func effectiveIdleGrace(config *brokerconfig.Config, explicit time.Duration) (ti
272272 // supervisor open from construction until the listener and its accept drain are
273273 // ready, so the idle timer can never fire during setup.
274274 func runBrokerServe(ctx context.Context, options brokerServeOptions, deps brokerServeDeps) (retErr error) {
275+ ctx, cancel := context.WithCancel(ctx)
276+ defer cancel()
275277 var layout brokerconfig.Layout
276278 var configPath string
277279 var err error
@@ -459,7 +461,7 @@ func runBrokerServe(ctx context.Context, options brokerServeOptions, deps broker
459461 return err
460462 }
461463 socketPath := brokeripc.SocketPath(layout.Runtime)
462- listener, err := deps.listen(socketPath, epoch, authority, brokeripc.Config{})
464+ listener, err := deps.listen(socketPath, epoch, authority, brokeripc.Config{OnRetire: cancel})
463465 if err != nil {
464466 return fmt.Errorf("vev: listen on broker sandbox socket: %w", err)
465467 }
@@ -272,6 +272,8 @@ func effectiveIdleGrace(config *brokerconfig.Config, explicit time.Duration) (ti
272 // supervisor open from construction until the listener and its accept drain are272 // supervisor open from construction until the listener and its accept drain are
273 // ready, so the idle timer can never fire during setup.273 // ready, so the idle timer can never fire during setup.
274 func runBrokerServe(ctx context.Context, options brokerServeOptions, deps brokerServeDeps) (retErr error) {274 func runBrokerServe(ctx context.Context, options brokerServeOptions, deps brokerServeDeps) (retErr error) {
275+ ctx, cancel := context.WithCancel(ctx)
276+ defer cancel()
275 var layout brokerconfig.Layout277 var layout brokerconfig.Layout
276 var configPath string278 var configPath string
277 var err error279 var err error
@@ -459,7 +461,7 @@ func runBrokerServe(ctx context.Context, options brokerServeOptions, deps broker
459 return err461 return err
460 }462 }
461 socketPath := brokeripc.SocketPath(layout.Runtime)463 socketPath := brokeripc.SocketPath(layout.Runtime)
462- listener, err := deps.listen(socketPath, epoch, authority, brokeripc.Config{})464+ listener, err := deps.listen(socketPath, epoch, authority, brokeripc.Config{OnRetire: cancel})
463 if err != nil {465 if err != nil {
464 return fmt.Errorf("vev: listen on broker sandbox socket: %w", err)466 return fmt.Errorf("vev: listen on broker sandbox socket: %w", err)
465 }467 }
M internal/app/broker_offline_status.go +11 -2
@@ -530,8 +530,11 @@ func ensureBrokerReady(ctx context.Context, req brokerStatusRequest, deps broker
530530 if !deps.now().Before(req.deadline) {
531531 return brokerStatusReport{}, fmt.Errorf("%w: endpoint %s did not answer Register within %s", errBrokerNotReady, req.socketPath, req.timeout)
532532 }
533+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
534+ return brokerStatusReport{}, err
535+ }
533536 if !errors.Is(err, errBrokerAbsent) {
534- return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w", req.socketPath, err)
537+ return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w; run \"vev kill --broker\" and retry", req.socketPath, err)
535538 }
536539
537540 if held == nil {
@@ -548,8 +551,11 @@ func ensureBrokerReady(ctx context.Context, req brokerStatusRequest, deps broker
548551 if ctx.Err() != nil {
549552 return brokerStatusReport{}, ctx.Err()
550553 }
554+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
555+ return brokerStatusReport{}, err
556+ }
551557 if !errors.Is(err, errBrokerAbsent) {
552- return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w", req.socketPath, err)
558+ return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w; run \"vev kill --broker\" and retry", req.socketPath, err)
553559 }
554560 case errors.Is(err, lifecycle.ErrBusy):
555561 // Another caller is elected and spawning. Only the elected
@@ -620,6 +626,9 @@ func probeBrokerStatus(ctx context.Context, socketPath string) (brokerStatusRepo
620626 }
621627
622628 service, err := brokeripc.Dial(ctx, socketPath, brokeripc.Config{})
629+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
630+ return brokerStatusReport{}, err
631+ }
623632 if err != nil {
624633 if backendAbsent(err) {
625634 return brokerStatusReport{}, absentError(socketPath)
@@ -530,8 +530,11 @@ func ensureBrokerReady(ctx context.Context, req brokerStatusRequest, deps broker
530 if !deps.now().Before(req.deadline) {530 if !deps.now().Before(req.deadline) {
531 return brokerStatusReport{}, fmt.Errorf("%w: endpoint %s did not answer Register within %s", errBrokerNotReady, req.socketPath, req.timeout)531 return brokerStatusReport{}, fmt.Errorf("%w: endpoint %s did not answer Register within %s", errBrokerNotReady, req.socketPath, req.timeout)
532 }532 }
533+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
534+ return brokerStatusReport{}, err
535+ }
533 if !errors.Is(err, errBrokerAbsent) {536 if !errors.Is(err, errBrokerAbsent) {
534- return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w", req.socketPath, err)537+ return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w; run \"vev kill --broker\" and retry", req.socketPath, err)
535 }538 }
536 539
537 if held == nil {540 if held == nil {
@@ -548,8 +551,11 @@ func ensureBrokerReady(ctx context.Context, req brokerStatusRequest, deps broker
548 if ctx.Err() != nil {551 if ctx.Err() != nil {
549 return brokerStatusReport{}, ctx.Err()552 return brokerStatusReport{}, ctx.Err()
550 }553 }
554+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
555+ return brokerStatusReport{}, err
556+ }
551 if !errors.Is(err, errBrokerAbsent) {557 if !errors.Is(err, errBrokerAbsent) {
552- return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w", req.socketPath, err)558+ return brokerStatusReport{}, fmt.Errorf("vev: broker endpoint %s is live but incompatible: %w; run \"vev kill --broker\" and retry", req.socketPath, err)
553 }559 }
554 case errors.Is(err, lifecycle.ErrBusy):560 case errors.Is(err, lifecycle.ErrBusy):
555 // Another caller is elected and spawning. Only the elected561 // Another caller is elected and spawning. Only the elected
@@ -620,6 +626,9 @@ func probeBrokerStatus(ctx context.Context, socketPath string) (brokerStatusRepo
620 }626 }
621 627
622 service, err := brokeripc.Dial(ctx, socketPath, brokeripc.Config{})628 service, err := brokeripc.Dial(ctx, socketPath, brokeripc.Config{})
629+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
630+ return brokerStatusReport{}, err
631+ }
623 if err != nil {632 if err != nil {
624 if backendAbsent(err) {633 if backendAbsent(err) {
625 return brokerStatusReport{}, absentError(socketPath)634 return brokerStatusReport{}, absentError(socketPath)
M internal/app/broker_production_connect.go +23 -3
@@ -2,11 +2,14 @@ package app
22
33 import (
44 "context"
5+ "errors"
56 "fmt"
7+ "os"
68 "time"
79
810 "github.com/bnema/vev/internal/adapters/brokeripc"
911 "github.com/bnema/vev/internal/adapters/ipc"
12+ "github.com/bnema/vev/internal/adapters/lifecycle"
1013 "github.com/bnema/vev/internal/ports"
1114 "github.com/bnema/vev/pkg/safedir"
1215 )
@@ -52,13 +55,30 @@ func connectProductionBroker(ctx context.Context) (ports.BrokerService, error) {
5255 deps.spawn = func(ctx context.Context, _ string, _ time.Duration, _ bool) error {
5356 return spawnProductionBrokerLauncher(ctx)
5457 }
55- if _, err := ensureBrokerReady(ctx, request, deps); err != nil {
56- return nil, fmt.Errorf("vev: ensure broker: %w", err)
58+ connect := func() (ports.BrokerService, error) {
59+ if _, err := ensureBrokerReady(ctx, request, deps); err != nil {
60+ return nil, fmt.Errorf("vev: ensure broker: %w", err)
61+ }
62+ return brokeripc.NewConnector(request.socketPath, brokeripc.Config{}).Connect(ctx)
63+ }
64+ service, err := connect()
65+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
66+ owner, acquireErr := lifecycle.Acquire(ctx, layout.Runtime, 50*time.Millisecond)
67+ if acquireErr != nil {
68+ return nil, fmt.Errorf("vev: wait for retiring broker: %w", acquireErr)
69+ }
70+ if releaseErr := owner.Release(); releaseErr != nil {
71+ return nil, fmt.Errorf("vev: release broker ownership: %w", releaseErr)
72+ }
73+ request.deadline = time.Now().Add(productionBrokerStartupTimeout)
74+ service, err = connect()
5775 }
58- service, err := brokeripc.NewConnector(request.socketPath, brokeripc.Config{}).Connect(ctx)
5976 if err != nil {
6077 return nil, fmt.Errorf("vev: connect broker: %w", err)
6178 }
79+ if _, stale := brokeripc.StaleBuild(service); stale {
80+ fmt.Fprintln(os.Stderr, `vev: the running broker is from another build; run "vev kill --broker" to restart it`)
81+ }
6282 if err := awaitBrokerPublication(ctx, service); err != nil {
6383 _ = service.Close()
6484 return nil, fmt.Errorf("vev: await broker publication: %w", err)
@@ -2,11 +2,14 @@ package app
2 2
3 import (3 import (
4 "context"4 "context"
5+ "errors"
5 "fmt"6 "fmt"
7+ "os"
6 "time"8 "time"
7 9
8 "github.com/bnema/vev/internal/adapters/brokeripc"10 "github.com/bnema/vev/internal/adapters/brokeripc"
9 "github.com/bnema/vev/internal/adapters/ipc"11 "github.com/bnema/vev/internal/adapters/ipc"
12+ "github.com/bnema/vev/internal/adapters/lifecycle"
10 "github.com/bnema/vev/internal/ports"13 "github.com/bnema/vev/internal/ports"
11 "github.com/bnema/vev/pkg/safedir"14 "github.com/bnema/vev/pkg/safedir"
12 )15 )
@@ -52,13 +55,30 @@ func connectProductionBroker(ctx context.Context) (ports.BrokerService, error) {
52 deps.spawn = func(ctx context.Context, _ string, _ time.Duration, _ bool) error {55 deps.spawn = func(ctx context.Context, _ string, _ time.Duration, _ bool) error {
53 return spawnProductionBrokerLauncher(ctx)56 return spawnProductionBrokerLauncher(ctx)
54 }57 }
55- if _, err := ensureBrokerReady(ctx, request, deps); err != nil {58+ connect := func() (ports.BrokerService, error) {
56- return nil, fmt.Errorf("vev: ensure broker: %w", err)59+ if _, err := ensureBrokerReady(ctx, request, deps); err != nil {
60+ return nil, fmt.Errorf("vev: ensure broker: %w", err)
61+ }
62+ return brokeripc.NewConnector(request.socketPath, brokeripc.Config{}).Connect(ctx)
63+ }
64+ service, err := connect()
65+ if errors.Is(err, brokeripc.ErrBrokerRetired) {
66+ owner, acquireErr := lifecycle.Acquire(ctx, layout.Runtime, 50*time.Millisecond)
67+ if acquireErr != nil {
68+ return nil, fmt.Errorf("vev: wait for retiring broker: %w", acquireErr)
69+ }
70+ if releaseErr := owner.Release(); releaseErr != nil {
71+ return nil, fmt.Errorf("vev: release broker ownership: %w", releaseErr)
72+ }
73+ request.deadline = time.Now().Add(productionBrokerStartupTimeout)
74+ service, err = connect()
57 }75 }
58- service, err := brokeripc.NewConnector(request.socketPath, brokeripc.Config{}).Connect(ctx)
59 if err != nil {76 if err != nil {
60 return nil, fmt.Errorf("vev: connect broker: %w", err)77 return nil, fmt.Errorf("vev: connect broker: %w", err)
61 }78 }
79+ if _, stale := brokeripc.StaleBuild(service); stale {
80+ fmt.Fprintln(os.Stderr, `vev: the running broker is from another build; run "vev kill --broker" to restart it`)
81+ }
62 if err := awaitBrokerPublication(ctx, service); err != nil {82 if err := awaitBrokerPublication(ctx, service); err != nil {
63 _ = service.Close()83 _ = service.Close()
64 return nil, fmt.Errorf("vev: await broker publication: %w", err)84 return nil, fmt.Errorf("vev: await broker publication: %w", err)

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 12

Tags 11

↑↓ moveenter openesc close