Skip to content

Latest commit

 

History

History

tools

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

tools

手元で使う運用のコマンドを コンテナで動かす。手元の Windows から WSL コンテナで、 t.ps1 を通して使う。版は Dockerfile で固定し、Renovate が上げる。

tools/t.ps1 cf r2 buckets list
tools/t.ps1 sops edit deploy/matrix/secrets.sops.yaml
tools/t.ps1 kubectl get pods -A           # クラスタは読み取り用で繋ぐ
tools/t.ps1 --admin kubectl apply -f x.yaml  # 書くときだけ管理者(下の「クラスタの資格情報」)
tools/t.ps1        # 引数なしならシェルに入る

Git Bash からは t を使う(tools/t kubectl get pods -A のように t.ps1 と同じ引数)。Git Bash から pwsh を直に呼ぶと、 / で始まる引数が Windows のパスに書き換えられ(/proc/cmdline → C:/Program Files/Git/proc/cmdline)、 閉じない標準入力で終わらなくなる。t はパスの書き換えを止め、端末でなければ標準入力を渡さない。渡すときは tools/t --stdin … < x(--admin と並べる順は問わない)。

入っているもの 用途
cf Cloudflare(R2 など)
sops / age 暗号化したファイル(*.sops.yaml。秘密の読み書き)
kubectl / talosctl / helm クラスタ(資格情報は下の「クラスタの資格情報」)
restic R2 のバックアップの中身を見る・戻す
pulumi / bun pulumi/(ふだんは CI が流す)

jq はここに入れず、手元に置く。上の出力の加工は tools/t.ps1 … | jq … のようにコンテナの外でする(コンテナを起こすほどではなく、パイプの先で使うことが多いため)。

仕組み

  • ../compose.yaml の tools を wslc-compose run で動かす(winget で入る wslc-compose)。リポジトリは /repo に置く
  • ログインと鍵はリポジトリの .home/ に置く(コンテナの中の HOME。.gitignore 済み)。手元のホームは汚さない。 cf のログイン(.config/cloudflare)、sops の age 鍵(.config/sops/age/keys.txt)、 pulumi(.pulumi)がここに入る。 クラスタの資格情報はここにも置かない(下の「クラスタの資格情報」)。 .home/ は本人だけが読める ACL にする
  • git clean -fdx で消える(無視しているファイルも消すため)。age 鍵は recovery/sops-age.key.age から戻せる (README「秘密の扱い」)、ほかはログインし直せば戻る
  • Dockerfile を変えると、次の tools/t.ps1 でイメージを作り直す(変わっていなければキャッシュで一瞬)
  • パイプやリダイレクトのときは TTY を付けない(tools/t.ps1 が見分ける)
  • PowerShell でパイプしたもの(tools/t.ps1 sops -d … | tools/t.ps1 --admin kubectl apply -f -)は、t.ps1 がコンテナの標準入力に流し直す。 行を LF でつないだ UTF-8 にして渡す(PowerShell のまま流すと CRLF になり、5.1 では日本語が ? に化けるため、 base64 で包んでコンテナの中で戻す)。PowerShell のパイプは行(文字列)単位なので、バイナリは通らない。 バイナリはファイルに書いてリポジトリの中から読ませる
  • t.ps1 は BOM 付きの UTF-8 にしてある。BOM が無いと Windows PowerShell 5.1 が Shift_JIS として読み、 日本語のコメントで構文が壊れる

クラスタの資格情報

kubectl・talosctl・helm は、クラスタに繋ぐときだけ資格情報をコンテナの中で作るか復号して渡す(creds.sh)。置き場はコンテナの /dev/shm(tmpfs)で、コンテナと一緒に消える。 平文は手元のディスクにも .home/ にも残らない。 age 鍵(上の「仕組み」)が無いと止まる。

既定は読み取り用。管理者は tools/t.ps1 --admin … と書いたときだけ。 書く操作(apply・delete・ create job など)は --admin を付ける。--admin はシェルにも効く(tools/t.ps1 --admin)。 誤操作を防ぐための分け方で、権限の境界ではない(どちらも同じ age 鍵から作れる)。

読み取り用(既定) 管理者(--admin)
kubectl / helm その場で作る。bootstrap/talos-secrets.sops.yaml の Kubernetes の CA で、グループ entra:viewer の証明書(1 日で切れる) 同じく system:masters
talosctl その場で作る。Talos の CA で os:reader の証明書(1 日で切れる) 同じく os:admin
  • 読み取り用の権限は ../bootstrap/apiserver-rbac.yaml の entra:viewer (組み込みの view と readonly-extra。ログは読めて、Secret は読めない)。Headlamp で Entra の viewer が持つものと同じ
  • helm はリリースの情報を Secret に持つので、helm list や helm status も --admin を付ける
  • talosconfig は保存しない(../docs/decisions.md「手で持つもの」)。secrets.yaml から毎回作る
  • 管理者の kubeconfig も保存しない。 毎回その場で作るので、作り直しも期限切れも無い。 talosctl kubeconfig は 1 年もつ証明書を呼ぶたびに出す(取り消せない)ので使わない
  • 行き先は 10.10.0.4(ノードの、作業用 PC の LAN 側の口)。届かなければ 10.0.0.2 に繋ぐ(Wi-Fi などで 10.0 側につないだとき。creds.sh の ep。GITOPS_EP で決め打ちできる)。10.0.0.2 は ふだん手元から届かず、NetBird はクラスタの上で動くので落ちたときに使えない。API は外に開かない。 外からは mado で作業用 PC に入って打つ。どちらも Talos の証明書の SAN に入っている。KUBECONFIG / TALOSCONFIG や --kubeconfig / --talosconfig / --server を自分で渡したときは何もしない。繋がないもの(kubectl kustomize、helm template、talosctl gen、--client など)も同じ

平文の kubeconfig / talosconfig という名前のファイルは .gitignore 済み(手で書き出したものを誤って入れないように)。

wslc の制限

  • wslc は host ネットワークに対応していない。 ブラウザのログインは手元の localhost:<ポート> に結果を送ってくるので、 その方式のログイン(cf auth login など)はコンテナの中では使えない
  • uid は指定しない(Windows のファイルに持ち主の uid は無い)
  • 標準入力が NUL のところ(Claude Code のツールなど)では、wslc-compose run がつなぐ標準入力が無効なハンドルになる。 1 秒ほど以上かかるコマンドの出力が落ちて ERROR_INVALID_HANDLE で終わるので、t.ps1 はそのときだけ空のパイプを渡す。 NUL かどうかは標準入力の種類(GetFileType)で見分けるので、ファイルや外のパイプからの入力は今までどおり届く
  • NetBird の exit ノード越しだと *.doany.io を外向きの IPv4 で引いたときに届かないので、NetBird の DNS ゾーンで 内部の 10.0.0.2 に向けている(nb・md・autodiscover は例外。../pulumi/netbird.ts)

入れるものの確かめ方

全部、公式が出しているチェックサムと照らし合わせてから入れる。sops は age 鍵と秘密を扱うので、 取得元やミラーで差し替えられても気づけるようにする。一致しなければ組み立てごと止まる。

  • kubectl・talosctl・helm・sops・restic・pulumi: 各リリースのチェックサムのファイル
  • age: チェックサムのファイルを出していない(sigsum の証明だけ)ので、Go のモジュールとして go install し、 Go の公開のチェックサムの台帳(sum.golang.org)で確かめる
  • cf: npm の integrity

版

# renovate: datasource=… depName=… の次の ARG を Renovate が上げる(../renovate.json)。 kubectl と talosctl は talos の群(自動マージしない)── ノードの版と揃えて上げる。

gh・git・jq は手元のまま(このリポジトリに限らず使うため。dotfiles の init.ps1 が winget で入れる)。