ページQuantCloud · 24 / 29

QuantCloud

QuantCloud は、ワークステーションの電源が切れていても、QuantCraft が閉じていても動き続ける専用のクラウドランナー上で、bulk forward ジョブを実行します。各ランナーは一度に 1 つの bulk forward ジョブを実行するため、ランナーごとに 1 つのバッチを設定・監視します。ランナーが実行するのは IDE のアルゴリズムのみで、エージェント(エージェントの bulk 実行を含む)は AutoTrading からローカルで実行されます。デスクトップアプリは、サインイン後にアカウント向けにプロビジョニングされたランナーに接続し、これらのジョブにはローカルの Python サービスを使用しません。

これは、同種のバッチをローカルマシンで実行する AutoTrading のクラウド版です。このページではアプリ内で行う操作を扱い、サーバーのセットアップや運用はこのドキュメントの対象外です。

QuantCloud ページとナビゲーション項目は、お使いのビルドで QuantCloud 機能が有効な場合に表示されます。

クラウドランナーの購入

Buy Cloud Runner をクリックして、次の手順に進みます。

マシンティアを選びます。各カードには、ティア名、価格($X/mo)、インスタンスタイプ、短い説明が表示されます。
Continue to payment(ティアを変更するなら ← Back)をクリックします。次のステップでは、注文の概要と PayPal サブスクリプションのボタンが表示されます。支払いは PayPal のサブスクリプションで、アプリがカード情報を直接収集することはありません。
承認後、ランナーがプロビジョニングされ、数分以内にページに表示されます。Refresh runners で確認してください。

QuantCloud を含む有効な QuantCraft サブスクリプションが必要です(ご利用のプランを確認してください)。

ランナーカード

各ランナーには、ラベルとエンドポイントとともにステータス(Warmup、Running、Loading…、Unavailable、Ready)が表示されます。新しくプロビジョニングされたランナーには、bulk 実行、依存関係のインストール、更新を一時的にブロックする warmup バナー(残り時間付き)が表示されます。

ランナーでの操作: Dependencies、New bulk run(ジョブが存在する場合は Edit / Stop / Delete / Resume)、Refresh。折りたたみ可能なフッターには、インストール済みの Packages と直近のインストールログが表示されます。

依存関係のインストール

ランナーの Dependencies をクリックして、PyPI パッケージをインストールします(ランナーは bulk/forward アルゴと同じ Python を使い、ローカル IDE の .venv は使いません)。アルゴが既定以外のパッケージ(たとえば pandas、numpy)をインポートする場合は、ここで追加してください。

カンマ区切りでパッケージ名を入力します。バージョンも任意で指定できます(例: pandas==2.1.0, numpy, scipy>=1.10)。新しいバージョンでパッケージを再インストールすると、古い固定が置き換えられます。
Install をクリックすると、ライブのインストールログを確認できます。インストール成功後は新しいパッケージがインポートされるようランナーが再起動します(最大 1 分程度かかる場合があります)。
bulk ジョブの実行中(先に停止してください)と warmup 中は、インストールがブロックされます。
インストール済みのパッケージは、Packages パネルに色分けされたバッジ(例: pandas 2.1.0)として表示されます。
追加したパッケージには、削除用の × ボタンがあります(Remove package? の確認後)。削除はランナーを再起動せず、次の実行から有効になります。bulk ジョブやインストールの実行中はブロックされます。

実行時にそれらのパッケージが必要な場合は、IDE の Packages(依存関係)で使っているのと同じライブラリをインストールしてください。

ランナーでのバッチ実行

アイドル状態のランナーで New bulk run をクリックします。そのランナーに紐づいた、AutoTrading と同じ New Run モーダルが開きます。Algorithm / Targets / Schedule & data タブについては AutoTrading を参照してください。Screener のターゲットスコープが利用でき、ワークステーションの電源がオフでも、クラウドジョブが保存済みスクリーンに一致する銘柄を取引し、独自のスケジュール(Refresh interval (days) / Refresh time (ET))で再スクリーニングできます。新しいランナーでの最初のスクリーナー実行は、ファンダメンタルズ全体のユニバースをダウンロードするため遅く、その後は UTC の 1 日に 1 回更新されます。ランナーは QuantCraft のサインインでダウンロードし、それを更新できないため、数日にわたる実行では、サインインの期限切れ後、再スクリーニングは最後のデータを使い続けます。スクリーナーを参照。
コンパイル済みアルゴ(.qcraft.json)、対象の銘柄またはスコープ、期間/時間足、任意のスクリプトパラメータを選びます。戦略が on_timer を定義している場合は timerIntervalMs を設定してください(戦略のライフサイクル)。
ランナーごとに 1 ジョブ: ジョブが存在すると、New の代わりに Edit run、Stop bulk run、Delete run、Resume bulk run が表示されます。Resume bulk run は pending resume のジョブ向けで、有効なトレーディングアカウントが必要です。
ランナーの bulk セクションには、Details と Logs(ローカルの bulk カードと同じレイアウト)が表示され、Pause / Resume(ライブログの追従のみを一時停止/再開します — ジョブは一時停止しません)、Refresh、Download logs(CSV)、Clear logs があります。

モーダル上部の Load / Save で、実行プリセット (.qcs) を再利用できます。既存の bulk 実行を編集する場合、アルゴリズム(algoId)は固定で、Load はターゲット、タイマー、ティックモード、params を更新しますが、アルゴのファイルは入れ替えません。

ログ

各 bulk forward 実行は、stdout、stderr、ステータスイベントを、QuantCloud のランナーの Logs タブにストリーミングします。

操作	動作
Live stream	実行中に新しいログ行が表示されます。
Pause / Resume	ライブログの追従のみを一時停止/再開します。ジョブは一時停止せず、ランナーは書き込みを続けます。
Refresh	ランナーから最近のログの末尾を再読み込みします。
Download logs	表示中の履歴を CSV としてエクスポートします。
Clear logs	画面上の一覧のみをクリアします。サーバー上の履歴は削除されません。

ログの量が多いと、古い行が削除されることがあります。全履歴の末尾しか見えていないと思われる場合は Refresh を使ってください。bulk 実行を削除すると、そのジョブの保存済みログファイルがランナー上から削除され、放棄されたジョブのログは約 7 日後に消去されることがあります。

監視と停止

bulk のステータスは、QuantCloud ページがアクティブな間は約 5 秒ごと、それ以外は約 30 秒ごとにポーリングされます。
Stop bulk run と Delete bulk forward run はそれぞれ確認を求めます。削除すると、ランナー上の保存済み状態がクリアされ、ジョブが一覧から削除されます。

ヒント

IDE とランナーのパッケージを揃える — Test がローカルで通るのにクラウド実行が ImportError で失敗する場合は、Dependencies から不足しているパッケージを追加してください。
on_timer はフォワード実行用 — IDE のバックテストダイアログではタイマーを設定しません。bulk forward モーダルで timerIntervalMs を設定してください。
フォワード実行での on_tick — アルゴの実行中、接続しているブローカーのブローカー価格の更新ごとに発火します。戦略のライフサイクルを参照。
ブローカーの認証情報 — ライブまたはペーパーで取引する bulk ジョブでは、実行ごとにブローカーの認証情報の送信が必要な場合があります。アカウントの種類に応じて、モーダルの指示に従ってください。
ワークスペースフォルダ — .qcs プリセットの保存には、リンクされたワークスペースフォルダが必要です。