Skip to content

refactor(backup): 復元チェックで check だけにする PVC をアプリの注釈で選ぶ - #844

Merged
5ym merged 2 commits into
mainfrom
loosen-app-couplings
Nov 15, 2026
Merged

5ym merged 2 commits into
mainfrom
loosen-app-couplings

Conversation

@5ym

@5ym 5ym commented Nov 15, 2026

Copy link
Copy Markdown
Collaborator

アプリのリポジトリを消しても gitops を直さずに済むように、denpa を名前で挙げていた所を外します。

  • deploy/backup/restore-check.yaml: 取り出さずに restic check --read-data-subset=1% だけにするものを、決め打ちの denpa/denpa-encoded から ReplicationSource の注釈 backup.doany.io/restore-check: check-only で選ぶ形にした。ReplicationSource の一覧は前から読んでいるので、RBAC は変わらない
  • deploy/backup/README.md: 「足す」に注釈のことを足した
  • コメントと docs(bootstrap/lvm-localpv-values.yaml・bootstrap/storage.yaml・bootstrap/talos.md・deploy/volsync/application.yaml・deploy/external-dns/README.md): gitops の外のアプリは例として書き、今あるものは kubectl で見る形にした

順番: 注釈を付ける danything/denpa#2900 を先にマージする(そうしないと、マージから同期までの間に録画を丸ごと取り出しにいく。チェックは毎月 1 日だけなので、実際に当たることはまず無い)。

hookshot の denpa の webhook(deploy/matrix/hookshot.yaml の connections と hook-denpa)はこの PR では触らない(移すには URL が変わるか、Matrix 側を手で書く必要があるため)。

🤖 Generated with Claude Code

https://claude.ai/code/session_01T8TqVdo6LUrWKdVQgbScVU

restore-check が denpa/denpa-encoded を名前で決め打ちしていたのを、ReplicationSource の注釈
backup.doany.io/restore-check: check-only で選ぶ形にする。注釈はアプリのリポジトリの volsync.yaml に
書くので、アプリを消しても gitops を直さなくてよい(denpa 側は danything/denpa#2900)。

アプリの名前を挙げていたコメントと docs(lvm-localpv の容量、storage の shared、volsync の取らないもの、
external-dns の直接つなぐもの、PSA のラベル)は、gitops の外のアプリを例として書く形にした。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T8TqVdo6LUrWKdVQgbScVU
@claude

claude Bot commented Nov 15, 2026 •

Copy link
Copy Markdown

Claude finished @5ym's task in 14s —— View job


レビュー結果

問題無し。 指摘できる不具合はありません。

確認した点:

  • deploy/backup/restore-check.yaml: CHECK_ONLY は checkPvc が呼ばれる前に、ReplicationSource の一覧を読んだ直後に埋めています。順序は正しいです。metadata.annotations が無くても ?. で落ちません。
  • keyOf は以前の <namespace>/<sourcePVC> と同じ形で、CHECK_ONLY.has(${ns}/${pvc}) と一致します。重複排除と sort も元のままです。
  • RBAC: 一覧は既に backup-reader で読んでいて、注釈は同じレスポンスに入っています。PR 本文のとおり変更は要りません。
  • ドキュメントは、gitops の外のアプリを例として書き、今あるものは kubectl で見る形になっています。kubectl get ns -l pod-security.kubernetes.io/enforce=privileged や kubectl get httproute -A の案内も妥当です。

補足(対応は任せます):

  • 注釈の値が check-only と違うとき(綴り間違いなど)は、何も言わずに通常の取り出しになります。録画だと丸ごと取り出しにいくので、タイプミスに気づけるよう、check-only 以外の値が付いていたら結果に警告を 1 行出す手もあります。必須ではありません。
  • 要確認: PR 本文のとおり、deploy: 録画の ReplicationSource に復元チェックを check だけにする注釈を付ける denpa#2900(注釈を付ける側)を先にマージしないと、次の月次チェック(毎月 1 日 06:00 UTC)で denpa-encoded を丸ごと取り出しにいきます。マージ順だけ守れば足ります。リスクは小さく、work の emptyDir が 24Gi なので、録画が収まらなければ失敗として通知されるだけです。

テスト: この種の CronJob 内スクリプトには自動テストが無く、変更も小さいので追加は不要と考えます。

@claude

claude Bot commented Nov 15, 2026 •

Copy link
Copy Markdown

Claude finished @5ym's task in 13s —— View job


レビュー結果

問題無し。 指摘できる不具合はありません。

確認した点:

  • deploy/backup/restore-check.yaml: bad と lines は 258〜259 行で宣言済みで、注釈を読む処理(286 行)より前にあります。CHECK_ONLY は checkPvc が呼ばれる前に埋まります。metadata.annotations が無くても ?. で落ちません。
  • keyOf は以前の <namespace>/<sourcePVC> と同じ形で、重複排除と sort も元のままです。
  • 注釈の値が check-only 以外だと、失敗として数えて通知します(前回のレビューで挙げた警告は取り込み済み)。値を間違えても、その PVC は通常どおり取り出すので、チェック自体は止まりません。
  • RBAC は変わりません。一覧は既に読んでいて、注釈は同じレスポンスに入っています。
  • README とコメントの変更は、内容が実装と合っています。

要確認(コードの問題ではありません):

テスト: この種の CronJob 内スクリプトには自動テストが無く、変更も小さいので追加は不要と考えます。

@5ym
5ym merged commit 228c3e7 into main Nov 15, 2026
5 checks passed
@5ym
5ym deleted the loosen-app-couplings branch November 15, 2026 13:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant