【2026年】自宅 Kubernetes（k3s）入門｜ホームラボでコンテナオーケストレーション

このように、k3s は学習用や小規模なホームラボ環境において、実用的かつ堅牢な選択肢となります。ただし、大規模なマルチクラウド構成では標準的な Kubernetes の機能が必要となる場合があるため、用途に応じて使い分ける必要がありますが、自宅での利用においては k3s が圧倒的に適していると言えます。

構築に必要な前提知識とハードウェア選定

Kubernetes を構築する前に、基本的な IT リテラシーを有しておくことが不可欠です。特に Docker や Linux コマンドラインの基礎知識は必須となります。Docker コンテナとは、アプリケーションとその依存関係を含む実行単位であり、OS のカーネルレベルで分離して動作します。k3s は Docker を直接使用しているのではなく、CRI-O や containerd といった CRI（Container Runtime Interface）対応ランタイムを使用していますが、コンテナイメージの Pull やコンテナ内の操作を理解しているとスムーズです。

また、Linux におけるネットワーク設定や権限管理についても理解が必要です。自宅サーバーを構築する際、多くのユーザーが Ubuntu Server や Debian、あるいは Linux を採用した Raspberry Pi OS を使用します。これらの OS で SSH 経由での接続、sudo 権限の付与、ファイアウォール設定（ufw など）が可能であることが前提となります。特に k3s は root ユーザーではなく通常ユーザでも実行可能ですが、ネットワークインタフェースへのアクセス権限やポート開放には適切な権限管理が必要です。

ハードウェア選定においては、用途に応じて最適なバランスを選ぶ必要があります。学習用や軽量な Web サービスのホスティングであれば、Raspberry Pi 4 または Raspberry Pi 5 がコストパフォーマンスに優れています。Pi 5 は USB 3.0 のサポートや GPIO コネクタの改良により、ストレージアクセス速度が向上し、k3s のパフォーマンスを大きく左右するディスク I/O 面でのボトルネックを緩和しています。

より安定した動作や、複数のノードを使用したクラスタ構築を目指す場合は、x86_64 アーキテクチャの小型 PC が推奨されます。具体的には、Intel NUC シリーズ（最新モデルは第 13 世代以降）や、Mini PC として人気の ASUS MiniPC や Beelink シリーズなどが挙げられます。これらの機器は x86_64 対応であり、仮想化技術（VT-x/AMD-V）を有効にすることで、さらに柔軟な環境構築が可能です。

ストレージについては、k3s の動作には高速な読み書きが求められます。特に永続ボリューム（Persistent Volume）を使用する場合や、Longhorn などの分散ストレージシステムを構築する場合は、NVMe SSD を使用することを強く推奨します。SSD のない SD カードのみでの運用は、OS の起動速度だけでなく、データベースアプリのレスポンスに深刻な影響を与える可能性があります。

シングルノード環境での k3s インストール手順

k3s のインストールは驚くほどシンプルです。Linux 環境でターミナルを開き、curl コマンドを使用して公式のスクリプトをダウンロード・実行するだけで完了します。このスクリプトは、自動的に必要な依存関係をインストールし、システムサービスとして k3s を登録してくれます。2026 年時点の標準的な手順では、以下のコマンドが最も一般的に用いられます。

curl -sfL https://get.k3s.io | sh -

このスクリプトを実行すると、k3s の最新安定版が自動的にインストールされ、システムデーモンとして起動します。ただし、自宅環境によっては特定のバージョンを指定したい場合や、デフォルトで含まれるコンポーネントを変更したい場合があります。例えば、組み込みのトラフィック管理ツールである Traefik を無効化し、外部の Ingress Controller を使用したい場合は --disable-traefik フラグを追加します。また、サーバーとしてのみ動作させたい場合は server 引数を使用します。

curl -sfL https://get.k3s.io | sudo sh -s - server \
    --disable traefik \
    --token YOUR_TOKEN_HERE \
    --write-kubeconfig-mode 644

このコマンドの解説を深掘りしてみましょう。--disable traefik は、k3s がデフォルトで持ってくるロードバランサー機能をオフにします。これは、より高機能な外部ツール（Nginx Ingress Controller など）を後から導入したい場合に有効です。また、--token 引数はクラスタの認証用トークンを指定するもので、複数ノードを追加する際に各ノードで同一のトークンを使用することでクラスタ参加が可能になります。YOUR_TOKEN_HERE の部分は実際にはランダムな文字列を生成するか、事前に設定した値を入力します。

インストールが完了すると、自動的に kubeconfig ファイルが作成されます。これは kubectl コマンドから k3s クラスタに接続するための設定ファイルであり、ユーザーのホームディレクトリ配下（~/.kube/config）に保存されます。このファイルの権限を適切に設定することで、root 権限を持たなくても kubectl を使用してクラスタを管理できるようになります。

sudo chmod a+x /etc/rancher/k3s/k3s.yaml

このコマンドは、ルートユーザーが作成した設定ファイルに対して、一般ユーザーも読み書きできる権限を与える処理です。これにより、通常ユーザとして kubectl コマンドを実行する際にエラーが発生しなくなります。インストール直後は k3s のサービスステータスを確認し、正常に起動しているかを確認してください。

sudo systemctl status k3s

このコマンドで Active: active (running) と表示されれば、k3s サーバーは稼働しています。また、docker コマンドを alias して使用することも可能です。k3s は Docker CLI と互換性があるため、alias docker=k3s の設定を行うことで、既存の Docker 知識を活かしながらコンテナ管理を行えます。

kubectl を使った基本操作とクラスタ状態確認

kubectl（Kubernetes command-line tool）は、Kubernetes クラスタに対してコマンドラインから通信するための標準的なツールです。インストール直後には、k3s の設定ファイルを読み込むことで自動的に kubectl が認識されますが、手動で指定する必要がある場合もあります。基本的な操作を正しく理解することは、トラブルシューティングやアプリケーションのデプロイにおいて不可欠となります。

まず最初に確認すべきは、クラスタの状態です。以下のコマンドを実行することで、ノードが正常に登録されているか、ネットワークアダプターの状態などを確認できます。

kubectl get nodes

出力結果には、ノード名、ステータス（Ready または NotReady）、年齢、バージョンなどが表示されます。「Ready」になっていれば、そのノード上で Pod をスケジュールして実行できる状態であることを意味します。もし「NotReady」となっている場合は、ネットワーク接続や CNI（Container Network Interface）の設定を見直す必要があります。

次に、クラスタ内のリソース全体を把握するためのコマンドです。以下は、ネームスペースごとに存在する各種リソースを一覧表示する代表的なコマンド群です。

kubectl get all --all-namespaces

このコマンドで確認できる主な項目には、Pod（アプリケーションの実行単位）、Service（内部通信のための仮想 IP）、Deployment（デプロイの管理定義）などがあります。また、kubectl get pods -A を実行することで、すべてのネームスペースにある Pod のステータスを確認できます。状態が Running であれば正常稼働中、Pending はスケジュール待ち、CrashLoopBackOff は起動失敗を意味します。

設定ファイルやリソースの詳細情報を取得する際にも kubectl は役立ちます。例えば、特定の Pod について詳細な情報を見るには以下のように記述します。

kubectl describe pod <pod-name> -n <namespace>

この describe コマンドは非常に重要で、イベントログやリソースの割り当て状況、エラーメッセージなどを詳しく表示してくれます。特にコンテナが起動しない場合など、トラブルシューティングの際には必須のコマンドとなります。また、リアルタイムでログを監視したい場合は以下のコマンドを使用します。

kubectl logs <pod-name> -f -n <namespace>

-f フラグは Follow を意味し、ログが流れ続けるのをリアルタイムで表示してくれます。コンテナ内でエラーが発生した際や、アプリケーションの出力を確認する際に頻繁に使用されます。

また、2026 年時点では kubectl の補完機能が標準的に利用可能です。Linux シェル（bash や zsh）に設定することで、コマンドやパラメータ名の自動補完が可能になります。これにより、手入力によるミスを減らし、効率的な操作が可能となります。

source <(kubectl completion bash)
echo "alias k=kubectl" >> ~/.bashrc

このように設定を保存しておけば、短縮形の k コマンドでも同様に操作を行えるようになり、CLI からの作業がさらに効率化されます。

基礎リソースの理解：Pod/Deployment/Service/Ingress

Kubernetes を扱う上で最も重要となるのが、その基本リソースの概念を理解することです。これらは YAML ファイルという構成定義ファイルを通じて管理され、Kubernetes の理想状態を維持するために使用されます。各リソースがどのような役割を担っているのかを深く理解することで、柔軟なシステム設計が可能になります。

Pod は Kubernetes における最小の実行単位であり、コンテナのグループとして機能します。通常は 1 つの Pod に Docker コンテナが 1 つ含まれますが、複数個のコンテナ（サイドカーパターンなど）を含むこともあります。Pod の寿命は一時的で、スケジュールミスや障害により再起動される可能性があり、その状態を維持する役割を持つのが Deployment です。

Deployment は、Pod のデプロイメントマニフェストです。これは Pod の複製数（レプリカセット）、バージョン管理、ロールアウト戦略などを定義します。例えば、Web サーバーを 3 つの Pod で運用し、1 つが落ちても自動で再作成するように設定できます。

Service は、Pod に対して安定した仮想 IP アドレス（ClusterIP）を提供し、内部通信や外部アクセスを仲介します。Pod の状態は動的に変化するため、その IP が不安定でも Service を通じてアクセスすることでアプリケーションへの接続を保続できます。また、LoadBalancer や NodePort タイプを使用することで、外部ネットワークから直接アクセス可能になるように設定も可能です。

Ingress は、HTTP および HTTPS トラフィックを管理するためのリソースです。Service で定義された内部の Web アプリケーションに対して、ドメイン名やパスに基づいてルーティングを行います。例えば、home.example.com でアクセスすると Web サーバーに、db.example.com でアクセスするとデータベースサーバーに転送するといった設定が可能です。

これらのリソースは YAML ファイルで記述され、kubectl apply コマンドによってクラスタへ適用されます。YAML の構造を誤るとエラーが発生するため、インデント（スペース）の指定には細心の注意が必要です。例えば、spec: の下の containers: には必ず 2 つのスペースが必要であり、これが崩れると定義ファイルとして認識されません。

Helm チャートを活用したアプリデプロイ

Kubernetes の設定ファイルを YAML で手書きするのは、複雑なアプリケーションを管理する際に非常に時間がかかります。そこで活躍するのが Helm です。Helm は Kubernetes 用のパッケージマネージャーであり、「チャート」と呼ばれるテンプレートパッケージを通じて、アプリケーションのデプロイを効率化します。これにより、Nextcloud や Gitea、データベースなどの複雑な構成も数行のコマンドで実現可能です。

まず Helm のインストールを行い、レポジトリ（アプリのカタログ）を追加する必要があります。2026 年時点では、公式の Helm レポジトリが標準的に利用可能であり、多くの人気アプリケーションが登録されています。以下は、Helm を更新し、公式レポジトリにアクセスする手順です。

helm repo update && helm repo add bitnami https://charts.bitnami.com/bitnami

Bitnami は非常に高品質なコンテナパッケージを提供しているチャートリードであり、HomeLab 環境での利用において最も信頼できるソースの一つです。次に、特定のアプリケーションを Helm チャートを使用してインストールする手順を示します。例えば、Nextcloud（ファイル共有サービス）をデプロイする場合の例です。

helm install my-nextcloud bitnami/nextcloud -n nextcloud --create-namespace

このコマンドは、my-nextcloud という名前で Nextcloud をインストールし、nextcloud というネームスペースを作成して配置します。Helm により、データベースのセットアップやストレージのマウント設定も自動的に処理されるため、手動での依存関係解決が不要になります。

さらに、カスタマイズされた設定を適用したい場合は values.yaml ファイルを使用します。例えば、メモリの割り当てや外部の S3 ストレージ連携などを変更するには、以下のコマンドでファイルを指定できます。

helm install my-nextcloud bitnami/nextcloud -f custom-values.yaml

custom-values.yaml には、デフォルト設定を上書きする値が記述されます。これにより、ハードウェアの仕様や運用ポリシーに合わせた柔軟なデプロイが可能となります。また、インストール後のアップデートも Helm を使用することで容易に行えます。

helm upgrade my-nextcloud bitnami/nextcloud -f custom-values.yaml

この upgrade コマンドを使用すると、設定変更を反映しながらアプリケーションのアップグレードや再構成が安全に行われます。Helm はロールバック機能も備えており、問題が発生した場合は以前の状態へ簡単に戻すことが可能です。これにより、自宅環境でのアプリケーション運用におけるリスク管理が強化されます。

永続ストレージの実装：Longhorn の導入

Kubernetes でコンテナを運用する際、コンテナ自体は削除されるとデータも消えてしまいます。これはデータベースやファイル共有アプリにとって致命的な問題です。これを解決するのが永続ボリューム（Persistent Volume, PV）の概念です。k3s にはデフォルトでストレージプロバイダーが含まれていないため、分散ストレージシステムである Longhorn を導入することで、柔軟かつ堅牢なデータ管理が可能になります。

Longhorn は、Kubernetes ネイティブの分散ブロックストレージソリューションであり、Rancher Labs が開発しています。ノード間でデータをレプリケーションし、ハードウェア障害に対しても高い可用性を提供します。自宅環境では RAID 構成をソフトウェアで実現するよりも、Longhorn を使用した方が管理が容易です。

インストールには Helm を使用するのが一般的です。以下は、Longhorn を longhorn-system ネームスペースにデプロイする手順です。

helm install longhorn longhorn/longhorn \
    --namespace longhorn-system \
    --create-namespace

このコマンドを実行すると、Longhorn のマネージャーと各ノードのドライバーが自動的に起動します。その後、ストレージクラス（StorageClass）が定義され、PVC（Persistent Volume Claim）を作成することで動的にボリュームを割り当てることができます。

永続データが必要なアプリケーションに対しては、以下のような PVC を作成する必要があります。例えば、データベース用として 10Gi のストレージを確保する YAML です。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-db-storage
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: longhorn
  resources:
    requests:
      storage: 10Gi

この設定により、アプリケーションは Longhorn ボリュームにデータを保存できるようになります。Longhorn の特徴として、バックアップ機能やスナップショット機能が組み込まれている点が挙げられます。これにより、データ損失のリスクを最小限に抑えることが可能です。

また、自宅環境では SSD を直接マウントするのではなく、Longhorn を介して管理することで、ストレージの統合的な可視化が可能になります。例えば、どのノードのディスクが満杯になりそうか、レプリケーションの状態はどうかを UI から監視できます。これにより、インフラ全体の健全性を保ちやすくなります。

セキュリティと SSL 化：cert-manager と Ingress Controller

自宅サーバーで Web サービスを公開する際、SSL/TLS 証明書による暗号化は必須です。Let's Encrypt を使用した自動的な証明書の更新は、セキュリティ上好ましいですが、手動設定は複雑になりがちです。これらを自動化するのが cert-manager です。k3s の標準的な Ingress Controller（Traefik）と連携することで、ドメイン名へのアクセス時に自動的に HTTPS 化を実現できます。

まずは cert-manager をインストールする必要があります。これも Helm を使用することで簡単に行えます。

helm install cert-manager jetstack/cert-manager \
    --namespace cert-manager \
    --create-namespace \
    --set crds.enabled=true

このコマンドは、cert-manager のカスタムリソース定義（CRD）をインストールし、Kubernetes 内で利用可能な状態にします。インストール後、Ingress Controller が SSL 証明書を取得するためのクラスター設定が必要です。

次に、Ingress リソースと Certificate リソースを作成します。以下は、example.local というドメインに対して証明書を発行する YAML の例です（自宅環境では DNS レコーダーが未登録の場合も多いですが、仮に公開用とする場合の構成です）。

apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: tls-cert-example
spec:
  secretName: example-tls-secret
  issuerRef:
    name: letsencrypt-prod
    kind: ClusterIssuer
  commonName: example.local
  dnsNames:
    - example.local

この設定により、cert-manager は DNS レコードの確認を行い、証明書を自動的に取得・更新します。自宅環境では Cloudflare や DuckDNS などのサービスと連携して、外部からのアクセスを許可する設定が必要です。

また、Ingress Controller の設定においては、TLS セキュリティポリシーを厳格化することが推奨されます。HTTP から HTTPS への自動リダイレクトや、強力な暗号スイートの指定などを行うことで、セキュリティレベルを向上させます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
spec:
  rules:
    - host: example.local
      http:
        paths:
          - pathType: Prefix
            path: /
            backend:
              service:
                name: my-service
                port:
                  number: 80

このように設定することで、セキュリティリスクを最小化しつつ、ユーザーに安全な接続環境を提供できます。自宅サーバーは外部からアクセス可能な場合が多いため、証明書の管理はインフラの根幹となる重要な要素です。

クラスタの健全性を保つ：モニタリング設定 (Prometheus+Grafana)

Kubernetes の運用において「見える化」は非常に重要です。クラスタの状態を把握し、パフォーマンスボトルネックを検出するためには、監視システムが不可欠です。Prometheus は時系列データベースとしてメトリクスを収集し、Grafana はそのデータを可視化するダッシュボードを提供します。この組み合わせは、Kubernetes 環境の標準的な監視方式となっています。

k3s クラスタに Prometheus と Grafana をデプロイするには、Helm チャートを利用するのが最も効率的です。まず Prometheus のインストールを行い、メトリクス収集の設定を行います。

helm install prometheus prometheus-community/prometheus \
    --namespace monitoring \
    --create-namespace

このコマンドにより、Prometheus サーバーと Grafana がデプロイされます。k3s クラスタ自体のメトリクス（CPU 使用率、メモリ使用量など）は、kube-state-metrics や node-exporter などのコンポーネントが自動的に収集します。これらは k3s の標準設定に含まれていることが多いですが、明示的に追加することでより詳細なデータが取得可能になります。

Grafana を利用すると、複雑なメトリクスをグラフやダッシュボードとして視覚化できます。例えば、各ノードの CPU 使用率トレンドや、ディスクの I/O スループットをリアルタイムで確認可能です。これにより、リソース不足やボトルネックを事前に対処することが可能になります。

kubectl port-forward svc/prometheus-grafana -n monitoring 3000:80

このコマンドは、ローカル PC から Grafana の Web UI にアクセスするためのポートフォワードです。ブラウザで http://localhost:3000 を開き、デフォルトのログイン情報（admin/admin）で入力することでダッシュボードを確認できます。

また、2026 年時点では AlertManager も組み込みやすい設計になっています。特定の条件（例：CPU 使用率が 90% を超えた場合）に達した際に、メールや Slack に通知を飛ばす設定も可能です。これにより、自宅サーバーが停止する前にユーザーが気づく仕組みを構築できます。

拡張性の壁を越える：マルチノードクラスタへ

シングルノード環境は学習には最適ですが、高可用性（HA）を実現するには複数のノードが必要です。k3s はマルチノード構成への移行が容易に設計されています。サーバーとワーカーノードに分けることで、負荷分散や障害耐性を高めることが可能です。

マルチノードクラスタを構築する際、最初のステップはサーバーノードの IP を固定し、各ノード間で通信可能なネットワーク環境を整えることです。ホームラボでは、192.168.x.x のプライベートネットワークを使用することが一般的ですが、ファイアウォール設定が適切にされていないと通信エラーが発生します。

次に、ワーカーノードとして使用する PC に k3s をインストールし、サーバーノードに追加する手順を行います。サーバー側で生成されたトークンを使用することで、ワーカーノードの登録が可能になります。

curl -sfL https://get.k3s.io | sh -s - agent --server https://<SERVER_IP>:6443 --token <TOKEN>

このコマンドは、新しい PC をクラスタに参加させるためのものです。--server 引数にはサーバーノードの IP アドレスを指定し、--token にはサーバー側で生成された認証トークンを入力します。これにより、複数の PC が連携してリソースを共有するクラスタが形成されます。

負荷分散を行うためには、サービス定義においてレプリカ数を増やすことが有効です。複数のノードがあることで、Pod は異なるマシン上で並列に実行され、リソースの制約を超えた処理が可能になります。

また、高可用性を実現するには、Etcd データベースを分散配置する必要があります。k3s ではサーバーノードが複数ある場合、自動的にレプリケーションが行われますが、障害時のフェイルオーバー設定には注意が必要です。例えば、3 つ以上のサーバーノードを用意し、過半数（Quorum）が生存していればクラスタが稼働するように設計することが推奨されます。

まとめ

自宅 Kubernetes（k3s）環境の構築は、現代の IT エンジニアにとって非常に価値の高い学習体験です。本記事では k3s の特徴から始め、インストール手順や基本的なリソース管理について解説しました。以下に重要なポイントをまとめます。

• k3s の適性: 軽量で ARM/x86 を問わず動作するため、ホームラボ環境に最適な Kubernetes ディストリビューションです。
• 前提知識の重要性: Docker や Linux コマンドの基礎を理解しておくことで、トラブルシューティングがスムーズになります。
• 基本リソースの理解: Pod、Deployment、Service、Ingress の役割を把握し、YAML ファイルで定義する能力が不可欠です。
• Helm と永続ストレージ: Helm を活用してアプリ管理を効率化し、Longhorn でデータの耐久性を確保することが重要です。
• セキュリティと監視: cert-manager による SSL 化と Prometheus/Grafana による監視は、運用の安定性を支える基盤です。
• 拡張性: マルチノード構成へ移行することで、高可用性と負荷分散を実現し、本格的な学習環境が整います。

この技術を習得することは、クラウド時代のインフラエンジニアとしてのスキルを確実に高めることに繋がります。自宅という安全な環境で試行錯誤しながら、未来の技術基盤を築いていきましょう。