要件
始める前に、このページのすべての行を確認してください。インストールの失敗のほとんどは要件の不足が原因で、インストール作業そのものが失敗することはまれです。
クラスター
クラスターは次の要件を満たす必要があります。
| 項目 | 要件 |
|---|---|
| Kubernetes | バージョン 1.29 以降。このガイドは Amazon EKS、Azure AKS、Red Hat OpenShift 4.18 以降(ROSA と ARO を含む)、K3s を対象としています。 |
| 標準コンポーネントセットに必要な容量 | Pod 全体で約 10 vCPU と 22 GiB のメモリを要求し、最大で約 55 GiB まで増えることがあります。少なくとも 24 vCPU と 96 GiB のワーカー容量を見込んでください。例: 8 vCPU / 32 GiB のノード 3 台。ライセンスサーバーが 100 台以上のサイトでは、さらに多くの容量が必要です。サイジング を参照してください。 |
| ノードあたりの Pod 数 | 合計で約 85 個の Pod に加え、API ゲートウェイとクラスター自身のシステム Pod があります。クラスターのノードあたりの Pod 数の上限を確認してください。EKS ではインスタンスタイプによって異なります。EKS を参照してください。 |
| ノードの OS 設定 | すべてのノードで fs.inotify.max_user_instances を 8192 以上にします。約 85 個のサービスが同時に起動するため、既定値の 128 では不足します。 |
| ストレージ | ReadWriteOnce ボリュームを作成できる StorageClass。OpenLM Platform には 50 MiB のボリュームが 3 つ必要です。 |
| Ingress | Ingress コントローラー(Traefik、ingress-nginx、またはクラウドのコントローラー)、または OpenShift のルート。Ingress を参照してください。 |
| 権限 | namespace openlm で Deployment、Service、ConfigMap、Secret、Ingress(またはルート)、PersistentVolumeClaim を作成する権限。 |
データサービス
次の 4 つのデータサービスを用意してください。
| サービス | 要件 |
|---|---|
| SQL Server | SQL Server 2019 以降、または Azure SQL Database / Amazon RDS for SQL Server。4 つのデータベースを所有する SQL ログイン(データサービス を参照)。 |
| MongoDB | MongoDB 6.0 以降(7.0 を推奨)と、データベースを作成できるユーザー。レプリカセットは不要です。Azure Cosmos DB と Amazon DocumentDB は、MongoDB と完全には互換性がないため、サポートされません。 |
| Kafka | Kafka 3.x または 4.x(KRaft または ZooKeeper)。平文または TLS。OpenLM Platform はインストール中に必要なトピックを自ら作成します。 |
| Redis | Redis 7.x または互換サービス(Amazon ElastiCache、Azure Cache / Azure Managed Redis)。平文または TLS で、パスワードを設定します。 |
ネットワークアクセス
次の接続を許可してください。
| 接続元 | 接続先 | 目的 |
|---|---|---|
| クラスターのノード | public.ecr.aws(HTTPS) | OpenLM のイメージをプルします(レジストリミラー を使用する場合を除く) |
| クラスターのノード | docker.tyk.io(HTTPS) | API ゲートウェイのイメージをプルします(レジストリミラーを使用する場合を除く) |
| Pod | SQL Server、MongoDB、Kafka、Redis | データ |
| Pod | OpenLM Platform の Web アドレス(https://openlm.example.com) | サービスはこのアドレスでサインイントークンを検証します。ネットワーク を参照してください。 |
| ユーザーのブラウザー | OpenLM Platform の Web アドレス、ポート 443 | OpenLM Platform を使用します |
OpenLM Platform は、外部接続を必要とする連携(ServiceNow など)をオンにしない限り、これ以外の外向き接続を行いません。
DNS 名と証明書
DNS 名と、その名前の証明書を用意します。
- DNS 名: OpenLM Platform 用の DNS 名を 1 つ用意します。例:
openlm.example.com。50 文字未満にしてください。 - TLS 証明書: その名前に対する証明書です。公的な認証局(CA)の証明書が最も簡単です。社内の CA の証明書も、手順を 1 つ追加すれば使用できます。選ぶ前に TLS 証明書 をお読みください。
ワークステーションのツール
ワークステーションに次のツールをインストールしてください。
| ツール | バージョン | 用途 |
|---|---|---|
kubectl(OpenShift では oc) | クラスターに合わせたバージョン | すべての作業 |
helm | 3.12 以降 | チャートのインストール |
openssl | 任意 | パスワードの生成、証明書の確認 |
sqlcmd、または SQL Server Management Studio (SSMS) などの SQL Server クライアント | sqlcmd は 18 以降 | データベースの作成、レポートスクリプトの実行 |
base64 | 任意 | SQL パスワードのエンコード |
このガイドのコマンドは、Linux または macOS のシェル(bash または zsh)向けに記述しています。Windows では WSL または Linux の踏み台ホストを使用してください。
確認
次のコマンドを実行します。どのコマンドもバージョンを表示し、エラーを出さないことを確認してください。
kubectl version
helm version
kubectl auth can-i create deployments -n openlm
最後のコマンドは yes を表示する必要があります。namespace がまだ存在しない場合は、ステップ 1 で作成するまで no と表示されることがあります。
ドキュメントチームは、大規模言語モデルを使ってこのページを下書きすることがあります。公開前に、テクニカルライターがすべてのページをレビューし、製品と照らし合わせて検証します。最終的な判断は人間が行います。