Skip to content

apps/ のコメントを削る(経緯の語り・日付・重複) - #445

Merged
5ym merged 2 commits into
mainfrom
trim-apps
Oct 18, 2026
Merged

5ym merged 2 commits into
mainfrom
trim-apps

Conversation

@5ym

@5ym 5ym commented Oct 18, 2026

Copy link
Copy Markdown
Collaborator

apps/ の README 以外のマニフェストから、もう要らないコメントを削りました。38 ファイル、+92 / −221(差し引き −129 行)。

何を削ったか

  • 「2026-xx-xx に踏んだ」「以前は…」などの日付と経緯の語り。罠の注意は 1 行で残した($( の禁止、hostPort と Recreate の理由、/dns-query に認証をかけない、hostNetwork にしない、WgPort は default.json が優先、Service links の名前の衝突など)
  • やめたアプリとの比較(Traefik の acme-watcher、wg-easy、Zulip、Portainer、Synapse、k3s の svclb)
  • 重複していた説明
    • InfisicalSecret の sync-options の 3 行の説明は 1 行にして bootstrap/README.md を指す
    • 「Infisical (il.doany.io) のフォルダ…にあり、純正 operator が Secret にする」は 1 行にした
    • 「値は Infisical の UI で書き換えるだけ(push-bridge…)」は bootstrap/README.md にあるので消した
    • restore-check の「FAILED でも exit 0」は notify.yaml の末尾を指すだけにした
  • YAML を読めば分かることを言い直しているだけのコメント

変えていないもの

  • 値・キー・ラベル・リソース名は変えていない。HEAD と作業ツリーから、コメントだけの行(# か // で始まる行)を除いて比べたら、どのファイルも一致した
  • ConfigMap に埋め込んだスクリプト(notify.js、restore-check.js、run.sh、runner の config.yml など)は、コメントの行が変わっただけ。そのため ConfigMap の data は変わり、ArgoCD 上はその ConfigMap が差分として出る。処理は同じ
  • apps/adguardhome/deployment.yaml の CONFIG の本体と、renovate-post-upgrade.sh が探す - name: CONFIG / value: | の行には触れていない

確かめたこと

この環境には PyYAML も kubectl も無いので、YAML のパーサーには通していない。代わりに、コメントを除いた中身が一致することを全ファイルで確かめ、ブロックスカラーの中に足したコメントの字下げが周りと同じことを目で見た。

🤖 Generated with Claude Code

https://claude.ai/code/session_01JbmWyUB9jcBcYCnNyiGBSV

- 「2026-xx-xx に踏んだ」などの日付や経緯の語りを外し、罠の注意は 1 行で残す
- InfisicalSecret の sync-options の説明を 1 行にそろえ、push-bridge の説明の重複を消す
- Traefik / wg-easy / Zulip / Portainer / k3s の頃の比較を消す
- routing-peer の hostNetwork の経緯、runner のネットワークの説明を短くする

YAML の値・キー・埋め込みのスクリプトの処理は変えていない(変わったのはコメント行だけ)。

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

claude Bot commented Oct 18, 2026 •

Copy link
Copy Markdown

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


レビュー結果

総評: 大きな問題はありません。マージして良いと思います。

  • 全 38 ファイルの差分を確認し、# / // 以外の行が変わっている箇所は見つかりませんでした。値・キー・リソース名は不変です。
  • InfisicalSecret の sync-options の説明を 1 行にして bootstrap/README.md を指す変更は、元の理由が README に残っているという前提で妥当です。
  • 日付や、やめたアプリへの言及を消しつつ、罠の注意(hostNetwork にしない、WgPort と default.json、$( の禁止など)は残っています。
  • ConfigMap に埋め込んだスクリプト(notify.js、restore-check.js、runner の config.yml など)はコメントだけが変わります。ArgoCD 上でその ConfigMap が差分として出て、参照する Pod が再起動する場合がありますが、動作は同じです。
  • CONFIG 本体と、renovate-post-upgrade.sh が探す - name: CONFIG / value: | の行は無事です。

指摘(軽微・任意)

  • apps/adguardhome/service-dns.yaml:9 に 1 件、インラインコメントを付けました。dual-stack が要る理由がコメントから消えています。

確認できていないこと

  • YAML パーサーや kubectl での検証は、この環境に無いので行っていません。
  • 参照先(bootstrap/README.md「InfisicalSecret には sync-options を 2 つ付けること」、apps/k8up/README.md「空のスナップショット」など)の見出しが実在するかは見ていません(要確認)。

テストは該当しない変更です。
· branch: trim-apps

Comment thread apps/adguardhome/service-dns.yaml Outdated
# Dual-stack: without this the Service is IPv4-only, yet the CNI still
# installs hostPort DNAT rules for v6 :53 -- so IPv6 queries reach the
# svclb pod and are dropped there (klipper-lb only gets SRC_RANGES for v4).
# 無いと IPv4 だけの Service になる。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

軽微(任意): 「無いと IPv4 だけの Service になる」だけだと、なぜ dual-stack が要るのかが読み取れません。元のコメントにあった「CNI が v6 の :53 にも hostPort の DNAT を入れるので、Service が v4 のみだと IPv6 クエリが落ちる」という理由を 1 行残すと、罠の注意として意味が残ります(svclb の言及は不要)。ただし現状の hostPort 構成でも同じ理由が成り立つかは要確認です。

@claude

claude Bot commented Oct 18, 2026 •

Copy link
Copy Markdown

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


レビュー結果(再レビュー)

問題ありません。マージして良いと思います。

  • 前回の指摘(apps/adguardhome/service-dns.yaml の dual-stack が要る理由)は 807b09b で直っています。コメントは「無いと IPv4 だけの Service になり、IPv6 で来た DNS(:53)を受けられない」になり、罠の注意として意味が通ります。
  • 前回「要確認」にした参照先の見出しは実在しました。
    • bootstrap/README.md:90 「InfisicalSecret には sync-options を 2 つ付けること」
    • apps/k8up/README.md:82 「空のスナップショット」
  • 807b09b はコメント 1 行だけの変更で、値・キーは変わりません。

確認できていないこと

  • YAML パーサーや kubectl での検証は、この環境に無いので行っていません。
  • 元のコメントにあった「CNI が v6 の :53 にも hostPort の DNAT を入れる」という理由が、今の hostPort 構成でもそのまま成り立つかは見ていません(要確認・任意)。

テストは該当しない変更です。
· branch: trim-apps

@5ym
5ym merged commit f07692b into main Oct 18, 2026
1 check passed
@5ym
5ym deleted the trim-apps branch October 18, 2026 06:00
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