要件

単一の仮想マシンまたはベアメタルサーバーで OpenLM Platform を実行するには、クリーンな RHEL 系マシン、DNS、TLS 証明書を準備します。デプロイスクリプトは、クリーンな RHEL 系 OS の上に Kubernetes（K3s）、データベース、メッセージブローカー、キャッシュ、すべての OpenLM サービスをインストールします。実行にあたって、Kubernetes、Ansible、Helm の経験は不要です。

このページでは、開始前に準備しておく必要がある内容を一覧にまとめています。インストールについては、デプロイ を参照してください。

ライセンス

OpenLM Platform の利用には、有効な OpenLM ライセンスが必要です。本番環境へのデプロイ前に、sales@openlm.com までライセンスの取得または延長をお問い合わせください。

システム要件

次の表に、最小構成と推奨構成のリソースを示します。

リソース	最小（評価用）	推奨（本番用）
CPU	4 vCPU	8 vCPU 以上
RAM	32 GB	64 GB
ストレージ	空き容量 200 GB の SSD	500 GB 以上の SSD
ネットワーク	100 Mbps	1 Gbps

インストーラーは他の処理に先立って CPU と RAM を検査し、いずれかが不足する場合は即座に失敗します。ネットワーク帯域の数値は、イメージ取得とエージェント通信のための目安であり、強制チェックの対象ではありません。

ディスク空き容量はチェックされません

インストーラーは、ディスクの空き容量を検証しません。容量が不足していてもインストールは成功し、後になってディスク枯渇による Pod の退避（eviction）として現れるため、原因の切り分けが難しくなります。開始前に、/var/lib/rancher を含むファイルシステムに 200 GB の空き容量があることを確認してください。

警告

最小構成は、負荷の低い評価、デモ、概念実証（PoC）環境に適した構成です。稼働中の Broker やユーザーが存在する本番用途では、推奨構成以上を使用してください。

オペレーティングシステム

次の OS がサポートされています。

• 正式サポート: RHEL 9、AlmaLinux 9、または Rocky 9（RHEL 系 9.x）。
• 実際に検証済み: AlmaLinux 9。特に希望がなければ AlmaLinux 9 を使用してください。

Ubuntu、Debian、SUSE はサポートされていません。RHEL 系の旧メジャーバージョン（7、8）および RHEL 系 10 は、正式な検証対象ではありません。

注意

インストーラーが確認するのは OS が RHEL 系であることのみです。メジャーバージョンは確認しません。そのため RHEL 系 8 や 10 でもインストーラーは開始されますが、これらは未検証かつサポート対象外です。

ユーザーアカウント

VM 上に、sudo 権限を持つ非 root ユーザーアカウントが必要です。インストーラーは sudo パスワードを 2 回要求します。1 回目は OS パッケージのインストール時（開始直後）、2 回目は数分後に Ansible playbook が開始するときです。playbook が動き出すまでは端末の前を離れないでください。

ネットワーク要件

VM には、インストール中の送信アクセスと、運用中の受信ポートが必要です。

送信（インストール中）

インストーラーが Kubernetes、コンテナイメージ、Helm チャートを取得できるよう、VM から以下のホストへの HTTPS 送信アクセスが必要です。

• ディストリビューションのパッケージミラー: インストーラーが dnf update と Python 3.12 のインストールを実行します。
• pypi.org、files.pythonhosted.org: Ansible とその Python 依存パッケージ。
• get.k3s.io: K3s インストーラー。
• get.helm.sh: Helm バイナリ。
• public.ecr.aws: OpenLM コンテナイメージ。
• docker.io: インフラストラクチャ用コンテナイメージ（Redis、Kafka、MongoDB、MariaDB、PostgreSQL）。bitnamilegacy リポジトリで公開されています。
• openlm-helm.github.io: umbrella チャートのサブチャートメタデータ（OpenLM Platform チャートのインストール時）。

VM が HTTPS プロキシ越しにある場合は、インストーラーを実行する前にシェルで HTTPS_PROXY と NO_PROXY を設定してください。

インストール後について

public.ecr.aws と docker.io は、Pod の再スケジュール、再起動、アップグレード時にイメージを取得できるよう、デプロイの運用期間中ずっと必要です。その他はインストール時のみ必要です。

受信（運用中）

VM の手前に配置されているファイアウォールで、以下のポートを開放してください。

ポート	送信元	用途
443	エンドユーザー	OpenLM Platform の UI と API 向けの HTTPS
80	エンドユーザー	443 への HTTP リダイレクト
6443	管理者	Kubernetes API（VM 外からの kubectl アクセス用）
30432	BI ツール	レポーティングデータベース（PostgreSQL）。Power BI などから接続
22	管理者	SSH

VM 自身の firewalld で 80、443、30432 を開放してください

インストーラーは VM 上の firewalld を設定しますが、開放するのは 6443（Kubernetes API）のみです。OpenLM Platform の通信に使うポートは開放されないため、インストールが成功しても、以下を実行するまで UI には到達できません。

sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --permanent --add-port=30432/tcp   # Only if BI tools need the reporting DB
sudo firewall-cmd --reload

DNS

openlm.yourcompany.com のように、VM を指す完全修飾ドメイン名（FQDN）が必要です。インストーラーを実行する前に、FQDN を VM の IP アドレスへ向ける A レコードを作成してください。

VM 上ではなく、クライアントマシンから名前解決を確認してください。

dig openlm.yourcompany.com +short
# Should print the VM's IP address.

DNS レコードを公開できないエアギャップネットワークに VM がある場合は、構成リファレンスの add_coredns_hosts_entry パターン を参照してください。

TLS 証明書

PEM 形式の TLS 証明書と一致する秘密鍵が必要です。次のいずれでも構いません。

• パブリック認証局（CA）（Let's Encrypt、DigiCert など）が発行した証明書
• 社内または企業の CA が発行した証明書
• 自己署名証明書（評価用途では許容されますが、ブラウザに警告が表示されます）

証明書の Common Name または Subject Alternative Name は、設定する FQDN を含んでいる必要があります。

インストール前に、証明書と鍵が一致していることを確認します。

openssl x509 -noout -modulus -in tls.crt | md5sum
openssl rsa  -noout -modulus -in tls.key | md5sum

2 つの出力は同一でなければなりません。

キャパシティ上の考慮事項

このデプロイパスは、小規模な顧客環境、評価、PoC を対象として設計されています。すべてのサービスが単一マシンを共有するため、マルチノードクラスタ構成と比べて、処理できる負荷には実用上の上限があります。

環境が単一 VM の容量を超える場合は、マルチノードのデプロイパスへの移行を検討してください: オンプレミスマシン、AWS、または Azure。