メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.factory.ai/llms.txt

Use this file to discover all available pages before exploring further.

Droid Computersは、Droidがセッション間で接続して作業できる永続的なコンピュート環境です。各セッション後に破棄される一時的なクラウドテンプレートとは異なり、コンピューターは状態を保持します。インストールされたパッケージ、ファイル、実行中のサービス、設定はすべてセッション間で永続化されます。

​
コンピュータータイプ

Factoryは、Droid Computersを使用する2つの方法をサポートしています:
  • Bring Your Own Machine (BYOM) — VPS、ワークステーション、オンプレミスサーバーなど、既に管理しているマシンを登録します
  • Managed Computers — Factoryが基盤となるクラウドコンピューターをプロビジョニングし、管理します
両方のタイプは設定 → Droid Computersに表示され、Droidセッションの長期間使用可能なターゲットとして使用できます。

​
セッションでコンピューターを使用する

​
Webアプリ

新しいセッションモーダルで、Computerタブを選択し、アクティブなコンピューターを選択して、作業ディレクトリ（例: /home/factory-user/projects/my-app）を設定し、セッションを開始します。 接続ステータス（接続中 / 接続済み / エラー）がリアルタイムで表示されます。

​
Slack

コンピューターは、Slack連携を介してセッションを作成する際にも選択できます。

​
コンピューターの管理

設定 → Droid Computersから、以下の操作ができます:
  • 独自のローカルコンピューターを設定
  • 利用可能なコンピューターを参照
  • コンピューター名を変更
  • コンピューターを削除
  • ステータスと接続情報の詳細ページを開く（Managed Computersのみ）

​
独自マシンの使用（BYOM）

VPS、クラウドVM、オンプレミスサーバーなど、所有している任意のマシンをDroid Computerとして登録できます。完全なBYOMセットアップフロー、リモートアクセスガイダンス、管理に関する注意事項については、独自マシンの使用（BYOM）を参照してください。

​
マネージドコンピューター

開始する最も速い方法は、Factory Webアプリからコンピューターを直接作成することです。
  1. 設定 → Droid Computersに移動します。
  2. 作成をクリックします。
  3. コンピューターに名前を付けます。
Factoryは自動的にクラウドコンピューター（4 CPU、8GB RAM、6GBスワップ）をプロビジョニングします。プロビジョニングの進行状況は、UIで以下のステップを通してライブ追跡されます:
  1. コンピューター作成中 — クラウドコンピューターの割り当て
  2. ユーザー設定中 — sudo権限を持つfactory-userアカウントの作成
  3. 環境設定中 — 環境設定、SSHキー、サービスファイルの書き込み
  4. Droidインストール中 — Droidバイナリのダウンロードとインストール
  5. サービス開始中 — SSHとDroidデーモンサービスの起動
プロビジョニングが完了すると、コンピューターのステータスがアクティブに変わり、セッションで使用可能になります。プラットフォーム管理のコンピューターは、アイドル時に自動一時停止し、新しいセッションがそれらをターゲットにすると自動再開します。また、プロビジョニングの詳細、リソースメトリクス、リモート更新フローも公開されます。

​
CLIコマンド

​
一般

コマンド説明
droid computer listすべてのコンピューターを一覧表示（名前、ID、ステータスを表示し、現在のマシンをマーク）
droid computer ssh <name>任意のコンピューターへのインタラクティブSSHセッションを開く

​
BYOMセットアップ

コマンド説明
droid computer register [name]現在のマシンをBYOMコンピューターとして登録
droid computer remove現在のマシンの登録を解除し、ローカル設定をクリーンアップ

​
SSHオプション

sshサブコマンドは以下のフラグをサポートします:
  • --proxy — stdioプロキシとして実行（ProxyCommandとして使用）
  • --port <port> — リモートマシンのターゲットポート（デフォルト: 22）
  • --debug — 詳細接続ログを有効化

​
監視

設定 → Droid Computersで任意のコンピューターをクリックして、詳細ページを開きます。プラットフォーム管理のコンピューターの場合、詳細ページにライブリソースメトリクスが表示されます:
  • CPU使用率 — 時間経過におけるパーセンテージ使用率
  • メモリ使用量 — 使用済み vs. 総メモリ
  • ディスク使用量 — 使用済み vs. 総ディスク容量
詳細ページには、現在のデーモンバージョンと接続ステータスも表示されます。可能なコンピューターステータスは:
  • プロビジョニング中 — 初期セットアップが進行中
  • アクティブ — セッション準備完了
  • エラー — プロビジョニングまたはランタイム障害

​
デーモンの更新

コンピューター詳細ページには、実行中のデーモンバージョンが利用可能な最新バージョンと並んで表示されます。更新が利用可能な場合、更新ボタンが表示されます。クリックするとリモート更新がトリガーされ、デーモンが新しいバイナリをダウンロードし、再起動して自動的に再接続します。

​
Git認証情報

  • BYOM — Droidはマシンに既に設定されているgit認証情報を使用します。
  • Managed Computers — Factoryとの個人GitHub連携がある場合、認証されたリポジトリアクセスのために認証情報が自動的に追加されます。新しいGitHub Appインストールを追加したり、リポジトリアクセスを変更したりすると、次回のセッション接続時に認証情報が自動的に更新されます。

​
SSH & IDE連携

droid computer ssh <name>は、デーモンを通じてセキュアなWebSocketトンネルを確立します。直接SSHポートの公開は必要ありません。Factoryは専用のEd25519 SSHキーペアを生成・管理し（~/.factory/.ssh/に保存）、個人のSSHキーとは分離されます。公開キーは各接続時にパスワードなし認証のために注入されます。

​
VS Code Remote-SSH

VS Code Remote-SSHのProxyCommandとしてdroid computer sshを使用できます： 
Host factory-mycomputer
  ProxyCommand droid computer ssh mycomputer --proxy
  User factory-user
  IdentityFile ~/.factory/.ssh/id_ed25519
  IdentitiesOnly yes
  StrictHostKeyChecking no
  UserKnownHostsFile /dev/null
これにより、Droid Computer上でフルなVS Codeリモートセッションを開くことができます。

​
セキュリティ

  • ファイアウォール — プラットフォーム管理のコンピューターはiptablesルールを使用して、デーモンポートのみへのインバウンドトラフィックを制限します。他のすべてのポートはデフォルトでブロックされます。factory-userはパスワードなしでsudoアクセス権を持ち、これらのルールを変更できることにご注意ください。ハードなネットワークレベルの境界には、インフラストラクチャレベルですべてのパブリックトラフィックをブロックするリレーモードを使用してください。
  • SSH強化 — rootログインとパスワード認証は無効化されています。
  • リレーモード — BYOMコンピューターはすべてのトラフィックをFactoryのリレーサービス経由でルーティングするため、パブリックポートは公開されません。プラットフォーム管理のコンピューターも、より厳格なネットワーク分離のために組織レベルでリレーモードを使用するよう設定できます。
  • Git認証情報 — プラットフォーム管理のコンピューター上で、認証されたリポジトリアクセスのためにユーザーごとに自動的に設定されます。