Compose、Ruby、IPv6、そしてKubernetesなしでのホームラボの再構築
Rebuilding My Homelab with Compose, Ruby, IPv6, and No Kubernetes (petekeen.net)
要約
筆者は、以前のホームラボ環境がKubernetesの複雑さとハードウェアの不安定さによって破綻した経験を共有しています。現在は、Docker Composeを基盤とし、RubyスクリプトとIPv6を活用して、よりシンプルで管理しやすい環境を構築しました。この新しいアプローチは、個々のサービスを分離しつつ、IPv6による柔軟なネットワーキングと、Rubyによる自動化を組み合わせています。
全文翻訳
Rebuilding My Homelab with Compose, Ruby, IPv6, and No Kubernetes
最終更新日 2026-07-10、10分で読めます
約1年前、私はこう書きました 以前の記事:
すべてが瓦礫の中だ。
1台のマシンは壊れて、おそらく復旧しない。サービスは生き残ったマシンにランダムに散らばっている。私のKubernetesプロジェクトは、まあ、一時停止中だ。
この記事はその続編で、ホームラボで「落ち着く」ことができる範囲で、私が最終的に落ち着いた構成の概要を説明します。
少しおさらいすると、前回の記事では、いくつかのマシンをまとめて、それらしいクラスターを構築していました:
hypnotoad、crushinator、そして薄型クライアント上で動作する不安定なコントロールプレーンVMlrrr、Proxmoxを実行するN150ボックスnibbler、クソみたいなやつ
これら4台のマシンのうち、lrrrだけが生き残りました。
Nibblerの問題
テレビ番組のNibblerは、フューチュラマに登場する愛らしい3つ目のキャラクターで、(ネタバレ注意ですが、20年も経っているので私のカットオフを過ぎています)タイムトラベルができる超知能生命体のメンバーであり、実はフライがクライオポッドに落ちた原因そのものです。
[画像: Futuramaの愛らしい3つ目のエイリアン、Lord Nibbler]
私の家の地下室のnibblerは、私が多くの希望を託したマシンでした。eBayで信じられないような安値で手に入れたLenovo M80s Gen3 SFFで、i7-12700とDDR5メモリを搭載していました(伏線)。メモリを128GBに、ストレージを3TBのNVMeにアップグレードし、残りはポケットマネーでまかないました。HBAカードを挿し、7台の16TBドライブを搭載したディスクシェルフを接続しました。これがコアサーバーとなり、すべての処理が行われるはずでした。
[画像: 2024年2月頃の私のホームラボスタック。大きな矢印がクソみたいなLenovoのnibblerを指している]
しかし、前述の通り、それはクソみたいなものでした。
何が問題だったのか、今でもよくわかりませんが、決して信頼できませんでした。再起動後に起動しないことがよくありました。たまにハードウェアを認識しなくなることもありました。
一度ならず、Jellyfinが何も再生できなくなったことを私や妻が発見し、地下室に降りてモニターとキーボードを接続すると、カーネルログに不可解なSASアダプタードライバーのエラーが記録され、ストレージディスクシェルフ全体がエラー状態になっていることが判明しました。
前回の記事を書いた頃、私はもっともらしいストーリーを組み立てました。eBayの出品者はこのマシンが悪いことを知っていたのに、「eBay認定整備済み」ラベルを貼って、安値で騙しやすい客に売りつけたのです。それに気づいた時には、マシンを大幅に改造してしまっていたため、返金請求はできませんでした。
Kubernetesの問題
nibblerの暴露と同時期に、もう一つの気づきがありました。Kubernetesは「複雑すぎる」ということです。私は、トラブルから抜け出すのに必要な時間やエネルギーなしではメンテナンスできないシステムを構築してしまったのです。クラスター内の他のすべてのマシンよりも多くのコアとメモリを持つマシンが、週に1〜2回自己破壊するようでは、実験全体に大きな水を差してしまいます。
私の応急処置は、Kubernetes以前の状態、つまり実質的にDocker Composeに戻すことでした。しばらく様子を見た後、そのまま続けることにしました。
一時的な解決策について、人は言う
今は2026年7月です。
lrrrは以前とほとんど同じ形で存在しています。まだProxmoxを実行していますが、仮想化されているのはOmadaを実行する1つのLXCと、エージェント的なライフスタイルに慣れるために使用している小さなVMだけです。また、Proxmoxフォーラムの荒らしが最も嫌うであろうことをしました。ホストにDockerをインストールし、Home Assistantなどをコアサービスとして実行しています。
hypnotoadとcrushinatorは電源オフ状態で、必要になるまでそのままです。
morboは、TrueNAS SCALEを実行し、ストレージ管理と邪魔にならないことだけを仕事とする、私にとっては新しいHP Elitedesk 800 G3 SFFで、素晴らしい仕事をしています。終わり。
ord-routerは、シカゴのデータセンターで動作するVMで、Comcastと直接ピアリングしています。これがパブリックイングレスマシンです。
nibblerは、古い部品と新しい部品の寄せ集めになりました。メモリ、ストレージは同じですが、新しいゲーマー風ケース、マザーボード、プロセッサー(Ryzen 9 9900X)になりました。最近では、ローカルLLM実験のためにRTX 5060ti 16GBビデオカードも追加されました。これは「その他すべて」のマシンです。家が家として機能するためにクリティカルなものや、ネットワークがネットワークとして機能するためにクリティカルなもの以外はすべてここで実行されます。
とりわけ、nibblerはForgejo、Minecraft、Jellyfinなどが動作する場所であり、その他多くのランダムなガラクタもここにあります。
このシステムで展開されているRaspberry Piクラスのデバイスもいくつかありますが、それらはアプライアンス的なことをしています。house-piはZ-Waveスティックを実行し、shed-piはADS-B受信機が接続されています。
Docker Composeに一手間加えたもの
風変わり?ええ、風変わりと言いましょう。
ホームラボを展開するソフトウェアスタックは、次のように構成されています。
- いくつかのスパイシーなDocker Composeスタック
- スパイスを実装するいくつかのRubyライブラリ
- ライブラリを駆動するRakefile
- 全体をまとめるYAMLファイル
スパイスとは何でしょうか?
- cronジョブ
- シークレット管理
- セキュアなデフォルト設定
- オプションの認証/認可およびオプションのパブリックIPを備えたCaddyによるHTTPイングレ
- Legoによる自動証明書管理
- バックアップ
- モニタリング
- ダッシュボード
- イングレスで提供される静的ウェブサイト
- スタック間の依存関係宣言
- クロスプラットフォームDockerイメージビルド
各Composeスタックは、Compose拡張機能(つまり、x-で始まるフィールド)を使用して、必要なものを宣言します。以下に簡単な例を示します。
services:
metube:
image: ghcr.io/alexta69/metube
container_name: metube
hostname: metube
restart: unless-stopped
x-security:
enabled: true
volumes:
- media-nfs:/media
environment:
DOWNLOAD_DIR: /media/youtube
HOST: '::'
x-backup:
enabled: false
x-web:
port: 8081
auth: true
dashboard:
name: MeTube
subtitle: Download YouTube Videos
category: Media and Games
x-depends:
- media-volume
これはMeTubeをセットアップします。これは様々なインターネットソースから動画を取得する小さなアプリです。セキュアなデフォルト設定を有効にし、バックアップは不要であることを宣言し、その後イングレを設定します。ここでは、x-webがポートを指定し、認証/認可が必要であること、そしてダッシュボードに表示されるべきであることを指定しています。
この例は、スタック間の依存関係も示しています。これはmedia-volumeスタックを取り込み、media-nfsボリュームをセットアップします。
すべてが機能するトリックは、デプロイ時にすべてのスタックが1つの大きなdocker-composeファイルにまとめられることです。つまり、外部ボリュームやネットワークを宣言するといった、みっともないことをする必要がありません。すべてがうまく連携します。
Networking Is Type Two Fun
通常のDocker Composeの世界では、スタック内のすべてのコンテナはブリッジネットワークを共有します。私の目的にはそれは意味がありません。例えば、昨日ダウンロードしたランダムなコードがlldapに直接話しかけられるようなことは望みません。
代わりに、個別のスタックを展開した場合に得られるものをエミュレートしています。各スタックは独自のブリッジネットワークを取得し、必要に応じて他のスタックのコンテナがそれに参加できます。
その場合、イングレスを実装する自然な方法は、ウェブサイトを提供するすべてのコンテナを共有イングレスブリッジに参加させることでしょう。しかし、これもまた、私の目指すものには合いません。スタック間の分離を維持したいので、ポップされたToDoリストマネージャーがすべてを脅かすような事態は避けたいのです。
私の解決策は、決定論的なIPv6です。
- フリート全体で/48のIPv6 ULAを取得します。これはRFC1918 IPv4ネットワーク(例:
10.10.10.0/24)の概念に似ていますが、はるかに大きなプールから取得されます。 - 各ホストは、ホスト名をハッシュしてソルトを加えて次の16ビットを取得することで/64を取得します。
- 各スタックは、スタック名をハッシュしてソルトを加えて次の32ビットを取得することで/96を取得します。
- 各サービスは、コンテナ名をハッシュしてソルトを加えて最後の32ビットを取得することで/128を取得します。
言い換えれば:
<48ビットULAプレフィックス>:<16ビットホスト>:<32ビットスタック>:<32ビットサービス>
Caddyはnetwork_mode: hostで実行され、生成されたすべてのアップストリームはコンテナに割り当てられたIPv6を指します。これは、ホストが自然にすべてのブリッジにアクセスできるため機能します。
私のセットアップのもう一つの奇妙/勇敢/愚かな点は、lrrrとnibblerの両方でポート80と443がIPv6経由でインターネットに公開されていることです。Caddyは、サービスがpublic: trueルートで明示的にオプトインしない限り、ローカル以外のトラフィックを拒否するように設定されています。これは主に利便性のために、JellyfinやダッシュボードにアクセスするためにモバイルデバイスでTailscaleを設定する必要がないようにするためです。
ああ、そしてTailscale。Tailscaleは素晴らしいです。私のiPhone上では、iPhoneが非常に熱くなりバッテリーを消耗する以外は。
Tailscaleは、いくつかの重要なもののバックホールです。ord-routerに到達するWebトラフィックは、Tailscale経由で地下室のホストにルーティングされます。また、各ホスト上のCaddyがlrrrで実行されている中央認証/認可システムと通信する方法でもあります。
今日学んだこと
第一に、私はKubernetesを構築しなかったということです。実行時に何も変更されないため、etcdやRaft、あるいはどのようなコンセンサスも必要ありません。すべてはリンターやテストなどの便利なツールで、事前に静的に決定されています。
第二に、失敗ドメインの概念は実際には実用的によく機能します。lrrrはクリティカルなものを最小限に抑えて管理するホームです。nibblerは、奇妙なワンオフアプライアンスではない「その他すべて」です。
nibblerがダウンしても、人々は悲しみますが怒りはしません。lrrrがダウンすると、HVACシステムは少し賢さを失い、猫が外にいることを知らせるLEDが機能しなくなります。
最後に、システムを完全に制御できるのは本当に素晴らしいことです。例えば、先日、イングレス経由で静的サイトを実装することにしました。5年前のKubernetesの議論を掘り下げて、それを現代に翻訳する必要はありませんでした。コードを書いて実現しただけです。IPv6についても同様です。それをスムーズに実行できるのは、完全な制御を持っていることの成果です。
ああ、そして、これらのどれもあなたにとって「タイプ1の楽しみ」に聞こえないなら、Kubernetesや人々が作り上げた数え切れないほどのDocker Composeマネージャーを使い続けることは完全に正当です。あなたを見ています。大丈夫です。
興味があれば、システム全体を構築するコードの、一般公開可能なスナップショットを私のForgejoに置いています。
このようなことについて話したいですか?私のソーシャルメディアなどへのリンクはフッターにあります。
2026年なので、これは明確にする必要があるでしょう。これらは職人的な、人間が生成した言葉です。機械が私のぎこちない決まり文句の修正案を提案しましたが、私はそれらの言葉を使いませんでした。