開発

Rancherとは?Helmでのインストール手順とクラスタ登録・RBAC・OpenShiftとの違い【v2.15系】

Rancherとは?Helmでのインストール手順とクラスタ登録・RBAC・OpenShiftとの違い【v2.15系】

Rancherは、SUSEが開発するKubernetesの管理ツールで、EKS・GKE・オンプレミスなど場所の違うクラスタを1つの画面と1つの認証基盤で束ねます。この記事では、Kubernetes・RKE2・K3sとの役割分担を押さえたうえで、HelmとK3sを使ったRancherのインストール手順、既存クラスタのインポート、クラスタロールとプロジェクトロールによるRBAC設計を、コマンド付きで順に説明します。版情報は2026年11月時点のv2.15系の公式ドキュメントとリリースノートで確かめた内容です。後半ではOpenShiftとの違いと、Rancherを入れるべき組織・見送るべき組織の線引きも示します。

まとめ:Rancherが向く構成と、Helmで導入してクラスタを束ねるまでの要点

Rancherはクラスタそのものではなく、複数のKubernetesクラスタの上に立つ管理層です。クラスタが2本以上に増え、クラウドやチームをまたいで認証と権限を揃えたくなった段階で効き目が出ます。

導入は「Rancherを載せるクラスタを用意する → cert-managerを入れる → Helmでrancherチャートを入れる」の3段です。検証ならK3sの単一ノードで十分動きます。v2.15系ではHelm 3.18以上と、土台クラスタのAPI Aggregation Layerが前提になりました。

既存のEKSやGKEは画面に表示されるkubectlコマンドを流すだけでインポートでき、権限はクラスタロールとプロジェクトロールの2階層で割り当てます。EKSが1本だけの会社や、Rancher自体を保守する人を置けない体制では見送りが妥当です。

RancherとKubernetes・RKE2・K3sの役割分担を構成図の言葉で整理する

Rancher Managerが受け持つ機能:クラスタ作成・インポート・認証の一元化

SUSEの公式ドキュメントは、Rancherを「どこでも、どのプロバイダー上でもクラスタをデプロイして実行するためのKubernetes管理ツール」と説明しています(SUSE Rancher Primeとは(公式ドキュメント))。コンテナを動かすのはKubernetesで、Rancherはその外側から操作する立場です。

実務で使う機能は次の4つに集約されます。

  • クラスタの新規作成:EKS・AKS・GKEなどのマネージドサービスや、自前のノードにRKE2・K3sを入れて作る
  • 既存クラスタのインポート:どこで動いているクラスタでも管理下に入れる
  • 認証とRBACの一元化:Active DirectoryやSAMLなどの外部IdPを1回つなげば全クラスタに効く
  • Fleetによる複数クラスタへの一括デプロイと、ダッシュボードでの稼働状況の確認

優先度が高いのは3番目です。クラスタごとにkubeconfigを配り、退職者のたびに全クラスタの権限を外す運用から抜けられる点が、Rancherを入れる一番の理由になります。Kubernetesそのものの仕組みはコンテナオーケストレーションの仕組みとツール比較、自社に要るかの判断で整理しています。

RKE2・K3sとRancherの関係と、RKE1が2025年7月31日に終了した影響

RKE2とK3sは、Rancherと同じ開発元が出しているKubernetesディストリビューションです。RKE2はセキュリティ要件の厳しい本番向け、K3sは単一バイナリで軽く動くエッジや検証向けという住み分けで、どちらもRancherの土台にも管理対象にもなります。

注意したいのは旧世代のRKE1です。Rancher v2.15.3のリリースノートによると、RKE1は2025年7月31日にEOLを迎え、Rancher 2.12.0以降ではRKE1の下流クラスタを作成も管理もできません。アップグレード前にはRKE1リソースの検証チェックが走り、残っていれば失敗します。2.11系以前でRKE1を抱えている場合、Rancherの更新より先にRKE2への移行計画が必要です。

2026年11月時点の版:Latestはv2.15.3、2.11〜2.14系も並行保守

SUSEのサポートマトリクスには2.4系から2.15系までの版が並び、2026年10月29日には v2.15.3・v2.14.7・v2.13.11・v2.12.15・v2.11.19 が同時に出ています。新規導入なら2.15系を選び、既存環境はマイナー版を1つずつ上げるのが公式の推奨経路です。

v2.15.3がRKE2・K3sで扱えるKubernetesは、既定がv1.36.5で、ほかにv1.35.9とv1.34.12です。マネージドサービス側の認定範囲は版ごとに違うため、サポートマトリクスの表を必ず確認してから土台クラスタの版を決めます。

Rancherをインストールする前に揃える前提条件とバージョン要件の確認

Helm 3.18以上・API Aggregation Layer・DNS名の3条件表

v2.15系で詰まりやすいのは、Helmクライアントの版と土台クラスタの設定です。リリースノートと公式インストール手順から、作業前に確認する項目を表にしました。

確認項目 v2.15系の要件 満たさない場合
Helmクライアント 3.18以上 2.12系以降を管理できない
API Aggregation Layer 土台クラスタで有効 拡張APIを登録できない
ホスト名 LBを指すDNS名 証明書と画面URLが合わない
cert-manager Rancher証明書か自動証明書の時 証明書の発行に失敗する
ノード空き容量 更新前に確認 Podの退避が起きる

表の上2行は、v2.12系以降の更新で新たに求められるようになった条件です。古い手順書のまま作業すると、ここで止まります。ホスト名は社内DNSに登録できる名前を先に決めておくと、後で証明書を作り直す手戻りを避けられます。

K3sとHelmでRancherをインストールしてダッシュボードへログインする手順

検証環境:K3s単一ノードにcert-managerとRancherを入れるコマンド一式

公式のHelm CLIクイックスタートは、Linuxマシン1台にK3sを入れ、その上にRancherを載せる構成です。Kubernetes APIは6443番ポートで受けます。K3sの版はサポートマトリクスで土台として認定された版を指定してください。

# 1. Linuxマシン上でK3sを入れる(--cluster-init は組み込みetcdを使う指定)
curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=<K3S_VERSION> sh -s - server --cluster-init

# 2. 手元のPCにkubeconfigを持ってきて、server の値を <IP>:6443 に書き換える
scp root@<IP>:/etc/rancher/k3s/k3s.yaml ~/.kube/config

# 3. チャートリポジトリと名前空間
helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
kubectl create namespace cattle-system

# 4. cert-manager(CRDをチャートから入れる)
helm repo add jetstack https://charts.jetstack.io
helm repo update
helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace \
  --set crds.enabled=true

# 5. Rancher本体(検証用に1レプリカ、ホスト名は sslip.io の疑似ドメイン)
helm install rancher rancher-latest/rancher \
  --namespace cattle-system \
  --set hostname=<IP>.sslip.io \
  --set replicas=1 \
  --set bootstrapPassword=<初期パスワード>

完了後、ブラウザで https://<IP>.sslip.io を開き、bootstrapPasswordで指定した値でadminとしてログインします。自己署名証明書なのでブラウザの警告が出ますが、検証用途ではそのまま進めて構いません。手元のPCだけでKubernetesを触りたい段階なら、kindでローカルにk8sクラスタを作る手順から始めるほうが早く済みます。

本番環境:rancher-stableリポジトリと証明書3方式を選び分ける基準

公式のインストール手順では、チャートリポジトリが3種類あります。本番向けはrancher-stable、新機能を試すならrancher-latest、rancher-alphaは実験版で、alpha絡みのアップグレードはサポート外です。

証明書はingress.tls.sourceで3方式から選びます。

  • rancher(既定):Rancherが自前のCAで発行する。cert-managerが要る
  • letsEncrypt:公開DNSと80番ポートの開放が条件。Ingressクラス名をletsEncrypt.ingress.classで合わせる
  • secret:社内CAなど自前の証明書を使う。プライベートCAならprivateCA=trueを足し、cert-managerは不要

社内システム向けの閉じた環境ではsecret方式が現実的です。インターネットから到達できない環境でLet’s Encryptを選び、HTTP-01の検証が通らずに止まる例は典型的な失敗パターンです。インストール時に渡した--setの値は、Helmでのアップグレード時にも同じものが要るので、値ファイルにしてGitで管理しておきます。

rollout statusとprogress deadline超過時の原因確認

Helmのコマンドが返っても、Rancherの起動はまだ途中です。次のコマンドで展開の完了を待ちます。

kubectl -n cattle-system rollout status deploy/rancher
# 正常時: deployment "rancher" successfully rolled out

# "exceeded its progress deadline" と出たら、DESIRED と AVAILABLE を比べる
kubectl -n cattle-system get deploy rancher
kubectl get pods --namespace cert-manager

DESIREDとAVAILABLEが一致していれば、時間がかかっただけで動いています。一致しない場合は、cert-managerのPodがRunningになっているか、土台クラスタのAPI Aggregation Layerが有効かを順に確かめます。

既存のEKS・GKE・オンプレのクラスタをRancherへインポートして束ねる

インポートの流れと、cluster-adminを持たないGKEで先に打つコマンド

以前「クラスタ登録」と呼ばれていた機能は、新しい版のドキュメントでは「インポート」に名前が変わりました(既存のクラスターの登録(公式ドキュメント))。操作は「クラスター管理」から「既存クラスターのインポート」を選び、クラスタの種類とメンバーを指定して「作成」を押すと、対象クラスタで流すkubectlコマンドが表示される流れです。

実行するユーザーには対象クラスタのcluster-admin権限が要ります。GKEは既定でこの権限を付けないため、先に次を流します。

# kubeconfig がインポート対象のクラスタを向いているか先に確かめる
kubectl get nodes

# GKE などで cluster-admin が無い場合に付与する
kubectl create clusterrolebinding cluster-admin-binding \
  --clusterrole cluster-admin \
  --user <USER_ACCOUNT>

EKS・AKS・GKEは管理ノードグループが1つ以上必要で、GKE Autopilotはインポートの対象外です。AKSはローカルアカウントが有効な場合だけ取り込め、Microsoft Entra ID認証のみの構成ではエラーになります。EKSとGKEの構成そのものはAmazon EKSの仕組みとクラスター作成手順、GKEのAutopilotとStandardの違いで扱っています。

「保留中」から進まないときに接続先と自己署名証明書を確かめる順番

インポート直後のクラスタは「保留中」になり、Rancherが管理用のリソースを配置し終えると「アクティブ」に変わります。アクティブになったクラスタにはDefaultとSystemの2つのプロジェクトが自動で作られ、System側にcattle-system名前空間が入ります。

保留中のまま動かない原因は、ほとんどが通信です。対象クラスタ内のエージェントがRancherのserver-urlへ到達できているか、プロキシ環境ならHTTP_PROXY・HTTPS_PROXY・NO_PROXYをエージェントの環境変数に設定したかを見ます。自己署名証明書のRancherでは、画面に出るcurl始まりのコマンドを使わないと証明書の検証段階で接続が拒否されるためです。なお、インポートしたクラスタをRancherから削除しても切り離されるだけで、クラスタ自体は残ります。

RancherのRBACでクラスタロールとプロジェクトロールを割り当てる設計

既定ロール5種の権限範囲と開発チームへの付与時に見る選定基準

Rancherの権限は、クラスタ単位とプロジェクト単位の2階層です。プロジェクトは複数の名前空間をまとめる、Rancher独自の単位になります。公式のCluster and Project Rolesに載っている既定ロールは次のとおりです。

ロール 範囲 できること
Cluster Owner クラスタ 全リソースを完全に管理
Cluster Member クラスタ 大半を閲覧し、プロジェクト作成
Project Owner プロジェクト メンバー管理を含め全権
Project Member プロジェクト 名前空間とワークロードを管理
Read Only プロジェクト 閲覧のみ

開発チームに渡すのはProject Memberが基本です。Cluster Memberは見落としやすい落とし穴で、自分で作ったプロジェクトではProject Ownerになるため、実質的に権限を広げられます。外部の協力会社にはRead Onlyから始め、必要な名前空間だけを含むプロジェクトにProject Memberで追加する順番が安全です。

プロジェクト別チーム分離とPod Security Admissionの特権コンテナ制限

公式ドキュメントは、Pod Security StandardsやPod Security Admissionで制限していない場合、Project Memberでも特権コンテナを動かせる可能性があると注意しています。RBACだけではノードへの侵入経路を塞げません。

実務では、本番の名前空間にrestricted、開発用にbaselineのPod Security Standardsを当て、プロジェクト単位でチームを分けるのが扱いやすい構成です。監査面では、v2.12系以降のRancherがAPI監査ログの既定レベルでもリクエストとレスポンスのメタデータを記録するようになった点も覚えておくと、誰がどのクラスタを触ったかを後から追えます。クラスタの稼働監視はKubernetes監視の設計とアラート設定とあわせて組み立てます。

RancherとOpenShiftの違いを管理範囲・提供形態・GitOps手段で比べる

「クラスタを束ねる管理層」と「クラスタそのもの」という立ち位置の差

比較でよく混同されますが、RancherとOpenShiftは同じ層の製品ではありません。OpenShiftはRed HatのKubernetesディストリビューションで、OS・レジストリ・ルーティングまで含んだ「クラスタそのもの」です。Rancherは既存のどのクラスタも束ねる管理層で、OpenShiftのクラスタをインポートすることもできます。

観点 Rancher OpenShift
製品の層 複数クラスタの管理層 Kubernetesディストリビューション
開発元 SUSE Red Hat
管理対象 EKS・GKE・AKS・RKE2等 主に自身のクラスタ
GitOps手段 Fleetを同梱 OpenShift GitOps
商用サポート Rancher Prime サブスクリプション

選定の分かれ目は「すでにクラウドごとのマネージドKubernetesがあるか」です。EKSとGKEが混在していて束ねたいならRancher、アプリ基盤一式を1社のサポートで揃えたいならOpenShiftが筋になります。OpenShiftをマネージドで使う場合の料金と構築はAzure Red Hat OpenShiftの料金とaz aro createでの構築手順、GitOps側の違いはOpenShift GitOpsとupstream Argo CDの違いで詳しく比べています。

FleetとArgo CDの併用可否と、デプロイ手段を1本に絞る判断

RancherにはFleetというGitOpsツールが同梱され、Gitリポジトリの内容を複数クラスタへ一括で配れます。すでにArgo CDで運用している場合、両方を同じ名前空間に向けると、どちらが正の状態かが曖昧になり、互いに上書きし合います。

結論として、デプロイ手段は1本に絞ります。クラスタが数十本あり、同じ構成を一斉に配るならFleet。アプリ単位の同期状態を細かく見たいならArgo CDを残し、Fleetは使わない設定にします。Argo CD側の構成はArgoCDのインストール手順とSync設定を参照してください。

Rancherを採用すべき組織と見送るべき組織を分けるクラスタ数と体制の基準

採用する場面:3クラスタ以上・複数クラウド・認証を1か所に寄せたい組織

Rancherの採用を勧めるのは、次の条件のうち2つ以上に当てはまる場合です。

  • 本番・ステージング・開発でクラスタが3本以上ある
  • AWSとGoogle Cloud、またはクラウドとオンプレミスにクラスタが分かれている
  • 社内のActive DirectoryやIdPで、全クラスタのログインと権限を管理したい
  • 工場や店舗などのエッジにK3sを多数置き、まとめて更新したい

この規模になると、kubeconfigの配布と権限の棚卸しだけで担当者の手が埋まります。Rancherの保守コストを払っても、認証とRBACが1か所にまとまる効果のほうが上回ります。

見送る場面:EKS1本の構成や、Rancher自体の更新を担う人員がいない体制

反対に、EKSやGKEが1本だけなら、Rancherは過剰です。クラウド側のコンソールとIAMで権限管理は足り、Rancherを入れるとその土台クラスタという管理対象が1つ増えるだけになります。

もう1つの見送り条件は保守体制です。Rancherは2.11〜2.15系が同時に保守されるほど更新が速く、マイナー版を1つずつ上げる作業と、そのたびのHelmやKubernetesの版合わせが発生します。この作業を四半期ごとに担える人がいない場合、導入から数年後に旧版のまま身動きが取れなくなるおそれがあるため、更新作業を担えるかどうかが導入の判断基準です。クラスタ設計そのものから外部に相談したい場合は、一創のAWS・Google Cloud・Azureのインフラ構築支援でマルチクラスタ構成の要否から検討できます。

よくある質問

Rancherの導入を検討する段階でよく出る疑問に、2026年11月時点の公式情報をもとに答えます。

Rancherは無料で使えますか?

Rancher本体はオープンソースとして公開されており、Helmチャートを使えばライセンス費用なしでインストールできます。費用が発生するのは、SUSEの商用サポート付き版であるRancher Primeを契約する場合です。Primeでは専用のチャートリポジトリとSUSE Customer Centerの認証情報を使います。Prime を契約しない場合、障害時の問い合わせ先とパッチ提供の保証は無いため、その部分は社内の運用体制で補います。

Rancherの最新バージョンはいくつですか?

2026年11月22日時点で、GitHubのリリース一覧でLatestになっているのはv2.15.3(2026年10月29日公開)です。同じ日にv2.14.7・v2.13.11・v2.12.15・v2.11.19も出ており、複数のマイナー系統が並行して保守されています。新規導入は2.15系を選び、既存環境は現在のマイナー版の最新パッチから次のマイナー版の最新パッチへ、1段ずつ上げるのが公式に検証された経路です。

Rancherを動かすのに必要なマシンの台数は?

検証ならLinuxマシン1台で足ります。K3sを単一ノードで入れ、Rancherをreplicas=1で載せる構成が公式クイックスタートの手順です。本番では、Rancherを載せる土台クラスタを複数ノードで組み、Rancherのレプリカも複数にして可用性を確保します。CPUやメモリの具体値は、管理するクラスタ数とノード数で変わるため、公式のInstallation Requirementsの表で規模に合う値を確認します。

RancherとKubernetesの違いは何ですか?

Kubernetesはコンテナの配置・再起動・スケールを担うオーケストレーションの仕組みで、Rancherはそのクラスタを外側から作成・登録・管理するツールです。Kubernetesだけでもアプリは動きますが、クラスタが増えると認証と権限の管理がクラスタごとにばらばらになります。Rancherはその管理を1つの画面とRBACに集めるための道具なので、Kubernetesの代わりにはなりません。

RKE1で作ったクラスタはRancherの最新版で管理できますか?

管理できません。RKE1は2025年7月31日にEOLとなり、Rancher 2.12.0以降ではRKE1の下流クラスタを作成も管理もできなくなりました。RKE1のリソースが残っているとアップグレード前の検証で失敗するため、先にRKE2へ移行してからRancherを2.12系以降へ上げる順番になります。移行中は2.11系に留め、その間に新しいRKE2クラスタへワークロードを移すのが現実的な進め方です。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.09 テックブログ teket不正アクセス:ログインできない理由と再開見通し、入場・退会・偽メールの確認【11月16日時点】
  2. 2024.08.22 テックブログ Bokehとは?Pythonでの使い方と2軸グラフの作り方【3.10.1対応】
  3. 2026.11.20 テックブログ 六花亭の不正アクセス:第二報で氏名・住所も流出の可能性、カード情報約8,000件と改ざん検知の手順【11月22日時点】
  4. 2026.08.04 テックブログ SCADAとは?スキャダの仕組みとPLC・DCS・MESとの役割分担を実装目線で解説
  5. 2026.11.20 テックブログ Gemini 4 Neonとは?HydrogenとCarbonとの違い・料金・3.1 Pro Previewからの移行を実装目線で解説【2026年11月】

RELATED POSTS 関連記事

目次