homelab-ops

Homelab-Opsは、Proxmox VE 8上で動作する単一のIntel i5ミニPC（16GB RAM、256GB NVMe、1TB SATA）に、Oracle Cloud InfrastructureとGoogle Cloud Platformのクラウドリソースを併用して、自己ホスト型Kubernetesプラットフォームを実行するための文書化された参照アーキテクチャです。 READMEに記載されている主な機能は以下の通りです。 - ネットワーキング：Cloudflare Zero Trust Anycastトンネル（cloudflared）が送信専用QUICイングレスを提供し、CGNAT背後でのポート転送を回避します。Traefikがクラスタ内ルーティングを処理します。Tailscaleエフェメラルメッシュは、管理アクセスとCIランナーに使用されます。 - GitOps配信：Flux CD v2とKustomizeが、Gitからプラットフォーム層とアプリケーション層を調整し（プラットフォームがアプリより先に）、順序付けられた依存関係を持ちます。Mozilla SOPSとAgeがGit内のシークレットを暗号化し、クラスタ内で復号化します。 - ストレージとデータ：デュアル層ストレージは、OS、K3s状態、PostgreSQL用のNVMeと、ドキュメントとメディア用の1TB SATAディスクを分離します。CloudNativePGオペレーターがPostgreSQLのライフサイクル、フェイルオーバー、WALアーカイブを管理します。 - レジリエンス：独立したOCI VMがUptime Kumaを実行し、帯域外ヘルスチェックを行います。Terraform状態はOCIオブジェクトストレージにリモートロック付きで保存されます。夜間の暗号化Resticバックアップは3-2-1ルールに従います。 - アプリケーションフリート：cloudflared、CloudNativePG、Homepage、Prometheus/Grafana、kwatch、MkDocsドキュメント、n8n、PDF生成マイクロサービス、Paperless-ngx、BookOrbit、Audiobookshelf、Miniflux、Linkding、Ryot/wger。 - ドキュメント：16件のADR、7つの実行フェーズマニュアル、Proxmoxセットアップとリカバリ、Terraformモジュール化、シークレットハイドレーション、K3s最適化、WANデバッグをカバーするエンジニアリングガイド。 このリポジトリは主に、インフラストラクチャ・アズ・コードとドキュメントのプロジェクト（Terraform、Ansible、Kubernetesマニフェスト）であり、パッケージ化されたアプリケーションではありません。制約のあるハードウェア上でのGitOps、ゼロトラストイングレス、ハイブリッドクラウドレジリエンスの実例を求めるプラットフォームエンジニアやホームラボオペレーターに適しています。