手元で使う運用のコマンドを コンテナで動かす。手元の 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 は 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 で入れる)。