fix(doctor): backup check warns about services declared persistence.mode: ephemeral
まだ誰も着手していません。
評価
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 78/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- go
- 領域
- cli, devops, infrastructure
調査の方向性
cmd/ob/doctor.go:530 のサービスループから始め、internal/app/services.go の serviceIsEphemeral を、その renderer と loader での使用箇所も含めて読みます。persistence.mode: ephemeral を使用するサービスで ob doctor の出力を再現し、その後サービスチェックのカバレッジを追加します。ephemeral サービスが backup 警告なしで pass を報告し、persistence mode または backup のないサービスでは既存の警告が維持されれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Summary
ob doctor's service backup check keys only off service.Backup == nil, ignoring persistence.mode: ephemeral. A service the author has explicitly declared disposable is reported as unprotected durable data on every run, and the remedy it offers cannot be followed.
Observed
A project declaring:
redis:
driver: redis
version: "8.8"
# Rate-limit counters and nothing else. Losing them costs a window of
# limiter state, which rebuilds on its own.
persistence:
mode: ephemeral
gets, on every ob doctor:
[WARN] backups: durable data is present and Onebox does not back it up
[WARN] redis/backup: managed service data lives only on this host; declare
services.redis.backup to copy it off, or accept that one disk is all there is
That single warning also drags the overall report to Onebox doctor: WARNING.
Why it is wrong
The declaration has already answered the question the check is asking, and Onebox acts on it everywhere else:
internal/app/services.go:122—serviceIsEphemeralexists.internal/app/services.go:531-539— the renderer consults it and turns persistence off (appendonly: no,save: ""for the redis driver). The comment there is explicit: "The mode owns this decision and a driver setting cannot override it."internal/app/load.go:582— the loader refuses a service that declares volumes together withmode: ephemeral, because "an ephemeral service owns no durable volume".
So by the time doctor runs, the project has stated the data is disposable, the renderer has removed persistence, and the loader has guaranteed there is no durable volume. Doctor then warns that durable data is unprotected.
The offered remedy is worse than the warning. "Declare services.redis.backup" asks the operator to configure a backup for a service Onebox has already established owns nothing durable to back up. The advice cannot be acted on, so the only way to clear the warning is to stop meaning what the declaration says.
The standard is already stated in this file
cmd/ob/doctor.go:520-524, in the comment immediately above the loop:
// A service that declares backup is not the same as one that does not,
// and this said otherwise for both — it warned that "Onebox takes no
// backups yet" over a database archiving to an off-host repository. A
// doctor that reports a healthy thing as broken is a doctor people stop
// reading.
That is this defect, one case over. The earlier fix taught the check to distinguish "declares backup" from "does not"; it did not teach it to distinguish "has durable data" from "declared it has none."
The workload branch directly above, at doctor.go:505, already reasons about exactly this field — it tells the operator to "declare persistence: {mode: durable} to state this, or mode: ephemeral if the volume is not state." So doctor understands the concept, applies it to workloads, and skips it for services.
Cost
A warning an operator must dismiss on every run is not free. It trains people to skim past a report whose entire value is that its warnings mean something, and it is the same erosion product.md guards against from the other direction — there, silence reading as approval; here, noise reading as nothing.
Proposal
In the service loop at cmd/ob/doctor.go:530, consult the ephemeral declaration before warning. Something like:
serviceIsEphemeral(service)→doctorPass, message along the lines of "declared ephemeral; Onebox renders no durable volume and takes no backup, which is what the declaration asks for."service.Backup == niland not ephemeral → the existing warning, unchanged.service.Backup != nil→ the existing pass, unchanged.
Reporting it as a pass rather than omitting it keeps the inventory complete, which seems closer to the project's habit of naming what it does not own rather than staying quiet about it.
serviceIsEphemeral is currently unexported in internal/app; whether doctor consults an exported helper or the field directly is a taste call I have no basis for.
Notes
- Reproduced against runner
v2026.8.21(aafb110), against8500ab7of this repository. - Same run reports
[WARN] qdrant/backup— that one appears correct: qdrant declares no backup and no persistence mode, so nothing has claimed the data is disposable.
- 主要言語
- Go
- スター
- 3
- フォーク
- 0
- 平均マージ
- 2時間 40分
- マージ済み PR(30日)
- 63
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
labstack/onebox のほかの issue
-
難易度 4/5 3〜5日 初心者へのやさしさ 55/100
-
難易度 4/5 3〜5日 初心者へのやさしさ 48/100
-
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
bug
難易度 3/5 1〜2日 初心者へのやさしさ 76/100
-
bug
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
labstack/onebox の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 60/100
github/gh-aw-mcpg#13748 ·
-
agentic-workflows
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
googleapis/librarian#7670 · コメント 2 件 ·