カスタムドメイン

runlot domain add app.example.com

コマンドを実行すると、次の DNS 設定を案内します。

DNS に以下の 2 行を追加してください:

  CNAME  app.example.com  →  apps.runlot.app
  TXT    _runlot-verify.app.example.com  →  <トークン>

CNAME はアプリへの接続に使用し、TXT はドメインの所有確認に使用します。DNS 設定が反映されたあと、`runlot domain verify app.example.com` ですぐに確認でき、システムも 1 分ごとに自動で確認します。

TXT レコードだけを設定した場合、所有確認はできますがアプリには接続できません。CNAME と TXT レコードの両方を設定してください。

状態の確認

runlot domain list

ホスト                 種類      状態
app.example.com       カスタム   接続済み
my-app.me.runlot.app  既定      接続済み

既定 の行は、すべてのプロジェクトに作成されるアドレスです。

状態が 接続済み のアドレスにのみトラフィックを転送します。

すぐに確認する

runlot domain verify app.example.com

システムは 1 分ごとに自動で確認します。DNS レコードを設定した直後は、このコマンドですぐに確認してください。

接続の解除

runlot domain rm app.example.com

コマンドを実行すると確認を求めます。接続を解除すると、そのアドレスでアプリにアクセスできなくなります。

TLS

TLS 証明書は自動で発行・更新します。個別に管理する必要はありません。

制約

• *.runlot.app および *.runlot.dev のサブドメインは接続できません。
• ワイルドカードホスト（*.example.com）には対応していません。
• 国際化ドメイン名は punycode に正規化します。
• カスタムドメインは HTTP 専用 です。psql はカスタムドメインではなく、プロジェクトの wire アドレス (<プロジェクト>--<組織>.wire.runlot.app) に接続してください。

所有確認を別途行う理由

TXT による所有確認がないと、他人のドメインを先に登録されてしまう問題が起こり得ます。これを防ぐため、runlot がドメインの所有有無を追加で確認します。