パッケージでインストール

パッケージは runlot-cp と runlot-node の2つに加え、両方を1台のマシンにまとめ、PostgreSQL と MinIO も同居させる3つ目の runlot-eval があります。すべてのパッケージには共通のインストールコア runlot-admin が含まれ、マシンのチェック・設定の書き込み・サービスの起動を行います。postinstall はこのコマンドそのものであり、ご自身で実行できないことをシェルで行うことはありません。

リポジトリ

curl -fsSL https://packages.runlot.io/gpg/runlot-archive-keyring.gpg \
  | sudo tee /usr/share/keyrings/runlot.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/runlot.gpg] https://<token>@packages.runlot.io/deb stable main" \
  | sudo tee /etc/apt/sources.list.d/runlot.list
sudo apt update

sudo tee /etc/yum.repos.d/runlot.repo <<'EOF'
[runlot]
name=Runlot
baseurl=https://<token>@packages.runlot.io/rpm/el/x86_64
gpgcheck=1
gpgkey=https://packages.runlot.io/gpg/runlot-archive-keyring.gpg
EOF

<token> はライセンスに付属します。これはダウンロードできる人を決めるだけで、他には何も影響しません。トークンのないマシンにコピーしたパッケージも、同じようにインストールされます。リポジトリホストが稼働するまでは、パッケージを署名付きバンドルとしてお送りします。インストール行以降の手順は、以下と同じです。バンドルの検証については エアギャップ を参照してください。

コントロールプレーン

sudo mkdir -p /etc/runlot/license
sudo cp license /etc/runlot/license/license
sudo apt download runlot-cp && sudo dpkg --unpack runlot-cp_*.deb    # unpacks the example without configuring
sudo cp /usr/share/runlot/site.env.cp-example /etc/runlot/site.env
sudo chmod 0640 /etc/runlot/site.env
sudoedit /etc/runlot/site.env

sudo apt install runlot-cp

sudo dnf install runlot-cp

sudo dpkg --configure -a

sudo /opt/runlot/bin/runlot-admin install cp --etc /etc/runlot --state /var/lib/runlot

各データノード

sudo cp /usr/share/runlot/site.env.node-example /etc/runlot/site.env
sudoedit /etc/runlot/site.env

sudo apt install runlot-node      # or: sudo dnf install runlot-node

sudo /opt/runlot/bin/runlot-admin bootstrap --nodes node-1=icn/KR/do,node-2=fsn/DE

評価用マシン

sudo cp /usr/share/runlot/eval-site.env /etc/runlot/site.env
sudoedit /etc/runlot/site.env          # the master key; the join token after the control-plane half installs
sudo apt install runlot-eval

runlot-cp・runlot-node・ディストリビューションの postgresql-18 に依存し、MinIO の unit を同梱しています。MinIO のバイナリは再配布されません。AGPL のため、ダウンロードはお客様ご自身で行ってください。/opt/runlot/bin/minio に配置して systemctl enable --now minio を実行します。ファイルがない場合は、postinstall がその旨を表示します。

1 台のマシン、1 つのディスク、すべてループバックです。本番向けの構成ではありません。

初回ログイン

1. RUNLOT_ADMIN_EMAILS に含まれるアドレスは、ダッシュボードの URL でメールとパスワードを使ってサインアップします。デフォルトの RUNLOT_SIGNUP=invite では、これが唯一許可されるサインアップで、それ以外のユーザーはダッシュボードから招待します。
2. 運用コンソールは、RUNLOT_ADMIN_HOST の Host で振り分けられる同一オリジンです。別のアドレスはありません。
3. CLI をお使いのインストールに向けて、何かをデプロイします。

runlot login --api https://runlot.acme.example
npm create runlot@latest hello && cd hello && runlot deploy