LearnHouse Enterprise Editionには、Kubernetes 1.25以降向けの公式Helmチャートがあります。1つのリリースで、専用のnamespaceに1つのLearnHouse環境が動きます。Webアプリ、API、コラボレーションサーバーはそれぞれ別のDeploymentとして、1つのIngressの背後で動作します。Community Editionは、代わりにCLIとDockerでインストールします。
namespace: academy
web
Next.js
api
FastAPI
collab
Hocuspocus
ingress-nginxとcert-managerをインストールし、空のデータベースを作成して、設定をvaluesファイルに書き込んでから、チャートをインストールします。事前にプリフライトスクリプトがクラスタ、DNS、Issuer、ストレージ、ライセンス、レジストリへのアクセスをチェックします。このスクリプトは何も変更しません。
helm repo add learnhouse https://partners.learnhouse.app/chartshelm repo updatehelm install academy learnhouse/learnhouse-ee -n academy --create-namespace -f academy.yaml| 構成要素 | スケールアウト |
|---|---|
| web | 可能。ステートレスなので、オートスケーラーとDisruption Budgetを使ってください。 |
| api | 可能。S3ストレージかReadWriteManyのボリュームが必要です。単一ノードのボリュームでは1レプリカのままです。 |
| collab | 不可。編集中のドキュメントはメモリ上に保持されるため、レプリカは1つにしてください。 |
| PostgreSQL, Redis | チャートの外で管理します。プロバイダーの高可用性オプションを使ってください。 |
Podは非rootユーザーで動き、権限昇格は無効、capabilityはすべて削除されています。これはKubernetesのPod Security Standardのrestrictedを満たします。サービスアカウントのトークンはアプリにマウントされません。任意のNetworkPolicyで受信トラフィックをIngressコントローラーからのものに限定でき、独自のシークレットマネージャーも使えます。
Kubernetesが適しているとき
社内ですでにクラスタを運用している場合、WebアプリとAPIのレプリカを複数のゾーンに分散させたい場合、または既存のGitOpsとシークレット管理の仕組みにLearnHouseを組み込む必要がある場合に選んでください。
公式チャートはEnterprise Edition向けで、ライセンスキーを使ってイメージを取得します。Community EditionはCLIとDocker Composeでインストールします。
簡単な評価用であれば、チャートでPostgreSQLとRedisを単一のPodとして動かせます。レプリケーションもバックアップもないため、本番環境ではマネージドサービスを使ってください。
イメージのタグを変更してhelm upgradeを実行します。APIは起動時にデータベースをマイグレーションします。任意のpre-upgrade Jobで先にマイグレーションを実行することもできます。リリースをまたいでアップグレードする前に、データベースのバックアップを取ってください。
サーバーを運用したくない場合は、LearnHouse Cloudが同じプラットフォームを代わりに運用します。アップデート、バックアップ、TLSの対応も含まれます。
Cloudのプランを見る