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

Documentation Index

Fetch the complete documentation index at: https://factory-changelog-may14.mintlify.app/llms.txt

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

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

Droid Computerの種類

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

セッションでDroid Computersを使用する

Factory App

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

Slack

Droid Computersは、Slack連携を介してセッションを作成する際にも選択できます。

Droid Computersの管理

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

独自マシンの使用(BYOM)

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

Managed Droid Computers

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

CLIコマンド

一般

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

BYOMセットアップ

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

SSHオプション

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

監視

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

デーモンの更新

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

Git認証情報

  • BYOM — Droidはマシンに既に設定されているgit認証情報を使用します。
  • Managed Droid 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リモートセッションを開くことができます。

セキュリティ

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