Bot (常駐プロセス)

Bot は外向き通信だけを行う常駐プロセスを動かす機能です。 コンテナイメージを用意する必要はなく、コード (と依存のpackage.json) を渡すだけで起動します。

• 向いているもの: Discord / Slack bot、定期実行、キューの consumer、外部 API の監視
• 向いていないもの: Web サイト、API サーバ — 公開 URL を持てません。それらは Web サービス を使ってください

• Bot のライセンス (料金プラン から購入)
• ランタイムは現在 Node.js のみ
• Git から動かす場合は公開ホスト (GitHub 等) のリポジトリ

作成画面の最初で、コードをどこから持ってくるかを選びます。

リポジトリの条件は次の 3 つです。

• リポジトリ直下に index.js があること (これが起動されます)
• 依存があるなら直下に package.json
• https:// で始まる URL (ssh は非対応)

your-repo/
├── index.js        ← 起動されるファイル
├── package.json    ← 依存があれば
└── package-lock.json

モノレポの一部を使う場合は「サブディレクトリ」を指定します。 指定した階層がコードの root として扱われるので、index.js と package.json はその中にあれば 足ります (repo を分ける必要はありません)。

your-monorepo/
├── README.md
└── bots/
    └── notifier/        ← サブディレクトリに "bots/notifier" を指定
        ├── index.js     ← これが起動される
        └── package.json

作成時に ref (ブランチ / タグ / commit) を解決して commit を固定します。リポジトリを更新しても動いているコードは変わりません — 取り込むには 設定タブの「Git から取り直す」を押します。

サンプルは examples/discord-bot にあります (ping に応答する Discord bot)。

アクセストークンを登録すると非公開リポジトリからも取得できます。 登録は Git アクセストークン (作成画面からも開けます) で行います。

• GitHub: fine-grained PAT で対象リポジトリのみ、Contents は Read-only。ユーザー名は省略可
• GitLab: deploy token の read_repository。ユーザー名にトークン名を入れてください

トークンはホストごとに 1 つで、同じホストのリポジトリを使う Bot すべてで共有されます。登録後は表示できません (末尾 4 文字だけ 照合用に残ります)。更新すると、そのホストを使っている Bot が新しいトークンで 起動し直します。

画面のエディタで書く方式です。雛形を 3 種類用意しているので、まず選んでから 書き換えるのが早いです。

• 動作確認 — 1 分ごとに生存ログを出すだけ。まず動かしてみる用
• Discord bot — discord.js で ping に応答する
• 定期実行 — 一定間隔で外部 API を叩く。依存ゼロ

制約:

• ファイルはフラット構成のみ (src/foo.js のようなディレクトリは作れません)
• 合計サイズにプランごとの上限があります (下記)
• 起動されるのは index.js です

保存すると再起動します。旧プロセスが止まってから新しい プロセスが起動するので、同じ Bot が二重に動く瞬間はありません。

トークンなどの秘密はコードに書かず環境変数で渡します。 作成画面と設定タブで KEY=value 形式で指定でき、process.env から読めます。

DISCORD_TOKEN=xxxxxxxx
LOG_LEVEL=info

設定漏れは起動時に落として理由を出すのがおすすめです。Bot には URL も probe も無いため、黙って接続に失敗すると画面には「再起動を繰り返して いる」ことしか出ません。

if (!process.env.DISCORD_TOKEN) {
  console.error('DISCORD_TOKEN が設定されていません');
  process.exit(1);
}

package.json があれば、起動前の init コンテナが 自動で install します。package-lock.json があればnpm ci、無ければ npm install です。

• install は --ignore-scripts で走ります。ビルドが要る native モジュール (node-gyp を使うもの) は動きません
• devDependencies は入りません (--omit=dev)
• 2 回目以降はキャッシュが効きます。キャッシュ用のディスクはプランに含まれ、ストレージ枠の外です

Bot には公開 URL が無いので、状態・再起動回数・稼働時間・ログの 4 つで確認します。

• ステータスタブ: 稼働中 / エラー / 停止中、再起動回数、稼働時間、取得元の commit
• ログタブ: 出力を切り替えて見られます
  • Bot 本体 — console.log の出力
  • リポジトリ取得 (init) — clone のログ (Git 取得のときだけ)
  • 依存 install (init) — npm のログ

レプリカは 0 か 1 です (同じ Bot の二重起動を避けるため)。台数を増やすには プランを変更してください。