メインコンテンツまでスキップ

Remote Dev Environments のFAQ

はじめにClick to copy link​

Remote Dev Environment とは何ですか?

オンデマンドのクラウドマシンです。macOS または Linux を利用でき、Bitrise CI と同じインフラストラクチャ、スタック、キャッシュ上で動作します。セッションは数秒で作成でき、ターミナル、IDE、またはAIコーディングエージェントから接続し、使い終わったら終了します。永続ディスクは保持されるため、後でセッションを復元して作業を再開できます。

どうすれば利用できますか?

RDE を利用する方法は2つあります。

  • セルフサービス: Remote Dev Environments ページでサインアップします。
  • Enterprise: Bitrise の営業チームを通じて、workspaceで RDE が有効化されます。Bitriseにお問い合わせください。

どちらの場合も、workspaceで RDE User ロールが必要です。メンバーであるだけでは足りません。workspaceのオーナーまたはマネージャーが、Settings → Collaboration から、メンバーごとまたはグループごとにロールを付与します。workspaceで SCIM を使用している場合は、IDプロバイダーから rde:rde_admin ロールを割り当ててください。詳しくは、Managing RDE accessをご覧ください。

最も手早く試す方法は何ですか?

3つのコマンドで試せます。Bitrise CLIをインストールし、bitrise-cli auth login を実行し、リポジトリのフォルダーから bitrise-cli rde claude を実行します。これによりセッションが作成され、現在のブランチがクローンされ、クラウドマシン上の Claude Code に接続されます。詳しくは、Quickstartをご覧ください。

どのマシンを利用できますか?

Apple シリコン上の macOS(M2 Pro、M4、M4 Pro)と、2〜48 vCPU の Linux を、共有クラスターまたは専用クラスターで利用できます。利用可能なスタックとマシンタイプは workspace によって異なります。セッションの作成時に、製品内の一覧で確認してください。RDE の各購入方法に含まれる内容については、セルフサービスの場合は RDE pricing、Enterprise の場合は Bitrise pricing calculator をご覧ください。

セッション、ストレージ、保持期間Click to copy link​

セッションにはどのような状態がありますか?
  • Running: プロビジョニング済みで、接続可能な状態です。
  • Terminated: マシンは停止していますが、セッションと永続ディスクは保持されます。完全に元に戻せます。
  • Deleted: 完全に削除された状態です。削除できるのは、すでに終了しているセッションのみです。
セッションは自動的にシャットダウンされますか?

はい、2つの場合があります。すべてのセッションには自動終了タイマーがあり、デフォルトでは5日間操作がないと終了します。最大30日までの任意の期間に設定できるほか、タイマーをオフにしてセッションが自動終了しないようにすることもできます。無料トライアルの workspaces のセッションは8時間に制限されており、この設定は変更できません。

このタイマーとは別に、Bitrise は、インフラストラクチャのメンテナンスのために、長時間稼働しているマシンを随時停止します。該当するセッションはドレイン(シャットダウン)され、後で再起動できます。自動終了タイマーをオフにしても、この対象から除外されることはありません。

どちらの場合も、終了は削除ではありません。ディスクは保持されます。

終了したセッションはどのくらいの期間保持されますか?

削除しない限り、また、セッションの作成元のスタックが Bitrise で引き続き利用可能である限り、無期限に保持されます。終了したセッションが、操作がないことを理由に削除されることはありません。

自分で削除していないのに、セッションが削除されることはありますか?

はい、セッションの作成元のスタックが削除された場合です。セッションのディスクには、そのスタックイメージに対する変更内容のみが保存されているため、イメージがなくなるとセッションを起動できません。Stackの削除は、公開されているstack deprecation and removal policyに従い、少なくとも4週間前に通知されます。今後削除予定のスタックは upcoming stack deprecations ページに掲載されており、subscribe to RSS updates で更新情報を受け取れます。

その場合、作業内容はどうなりますか?

完全に消去され、復元できません。スタックの削除日までに、作業内容をリポジトリにコミットするか、エクスポートしてください。現行のスタックから、いつでも新しいセッションを作成できます。

既存のセッションを新しいスタックに移行できますか?

いいえ。セッションは、作成元のスタックのまま使用し続けます。新しいスタックに移行するには、そのスタックから新しいセッションを作成し、リポジトリを再度クローンしてください。

セッションのディスクはバックアップされますか?

いいえ。セッションのディスクは作業用のストレージであり、バックアップされません。サービスレベルの保証の対象外です。セッションのディスク上にのみ存在するデータは、未保存の作業として扱ってください。ブランチをプッシュしておきましょう。

永続ディスクには実際に何が保存されますか?

セッションの作成後に加えられた変更のみが、スタックイメージとの差分として保存されます。たとえば、クローンしたリポジトリ、ビルドの出力、ローカル設定などです。これにより復元が高速になりますが、同時に、セッションはそのイメージが存在し続けることに依存します。

セッションのストレージには追加料金がかかりますか?

現在、セッションのストレージは別途課金されません。Enterprise 契約では、ストレージの割り当て量と、それを超えた分の扱いが定められています。Enterprise 契約をご利用の場合は、Order Form をご確認ください。

メンバーが workspace を離れた場合、セッションはどうなりますか?

メンバーの RDE アクセス権を取り消しても、そのメンバーのセッションは削除されません。実行中のセッションは自動終了するまで継続し、終了済みのセッションは誰かが削除するまでディスクが保持されます。ストレージを解放するには、セッションを明示的に削除してください。

セッションはメンテナンスの影響を受けますか?

長時間稼働しているマシンは、インフラストラクチャのメンテナンスのために停止されることがあります。該当するセッションはドレイン(シャットダウン)され、後で再起動できます。

復元にはどのくらい時間がかかりますか?

イメージのサイズによりますが、通常は約20秒から数分です。

接続Click to copy link​

セッションに接続するにはどうすればよいですか?

4つの方法があります。

  • セッションの詳細ページにある、ブラウザーベースの Web ターミナル。
  • SSH。そこに表示されるアドレスとワンタイムパスワード、または bitrise-cli rde session view で確認できる情報を使用します。
  • VS Code。Open in VS Code から、Remote-SSH 拡張機能を使用します。
  • macOS セッションでグラフィカルなデスクトップを使用するための VNC。Linux セッションにはデスクトップがないため、VNC は利用できません。詳しくは、Connecting to a sessionをご覧ください。
毎回パスワードをコピーせずに接続できますか?

はい。SSH の公開鍵をsaved inputとして登録すると、Bitrise がその鍵をセッションの authorized keys に追加します。macOS セッションでは vagrant ユーザーとして、Linux セッションでは ubuntu ユーザーとしてサインインします。

CLI からインタラクティブなシェルを利用できますか?

bitrise-cli rde session exec は単一のコマンドを実行して出力をストリーミングで返すもので、インタラクティブなシェルではありません。インタラクティブなセッションには、SSH または Web ターミナルを使用してください。

リモートコマンドがタイムアウトします。上限を引き上げられますか?

はい。session exec は、デフォルトでは10分後にリモートコマンドを停止します。長時間のビルドには --timeout 30m を使用し、上限を無効にするには --timeout 0 を使用してください。

ファイルを送受信するにはどうすればよいですか?

bitrise-cli rde session upload と bitrise-cli rde session download を使用します。bitrise-cli rde claude で起動した AIエージェント を使用している場合は、普通の言葉で依頼してください。ファイルの転送や、ローカルマシンでの VNC ビューアーの起動を行えます。

セッションは SSH アクセスが可能な通常のマシンなので、すでに使い慣れているツールも利用できます。

  • 単一のファイルやフォルダーのコピーには scp を使用します。セッションの詳細ページまたは bitrise-cli rde session view で確認できる、セッションの SSH アドレスを指定します。
  • SSH 経由の rsync で、フォルダーを同期した状態に保ちます。ノートパソコンからでも、セッション内からでも、どちらの方向でも開始できます。
  • セッション内から、curl、wget、または git clone を使って、インターネットから直接取得します。セッションは Bitrise のインフラストラクチャ上にあるため、大きな依存関係やアーティファクトは、ノートパソコンからアップロードするよりも、通常はこの方法のほうがはるかに高速です。
  • セッション内から、オブジェクトストレージのバケットやアーティファクトサーバーなど、普段使っている保存先に結果をプッシュします。
  • 転送自体を省略し、セッション上のファイルを直接読み書きする VS Code Remote - SSHで、その場で編集します。

まず、SSH の公開鍵を saved inputとして登録してください。パスワードなしでアクセスできるため、ワンタイムパスワードを毎回コピーすることなく、スクリプトによる転送や繰り返しの転送を現実的に行えます。

VNC で macOS のデスクトップがロックされました。どうすれば再度ログインできますか?

RDE UI のセッション詳細ページに表示されている VNC パスワードを使用してください。

Git と認証情報Click to copy link​

プライベートリポジトリをクローンするにはどうすればよいですか?

GitHub integrationを有効にします。Bitrise は、新しいセッションごとに有効期間の短い GitHub トークンを配置します。このトークンは、個人の GitHub App 接続を通じて発行されるため、git clone、git push、および gh の CLI を、個人用アクセストークンや SSH キーなしで HTTPS 経由で利用できます。トークンの有効期間は最長8時間で、復元をまたいでも、セッションの存続期間中は自動的に更新されます。長期間有効な認証情報がマシンに保存されることはありません。

有効にしましたが、クローンが「repository not found」で失敗します。

Bitrise GitHub App が、そのリポジトリまたは Organization にインストールされていません。workspace レベルの GitHub App 接続は対象にならない点にご注意ください。この連携では、Account settings → Connected accounts にある個人の接続が使用されます。

コミットは自分のものとして記録されますか?

はい、あなたの GitHub アカウントに紐づけられます。その際は GitHub の noreply アドレスが使われるため、実際のメールアドレスが公開されることはありません。

その他の認証情報はどのように保存すればよいですか?

saved inputsとして保存します。API トークン、SSH キー、エージェントの認証情報などが対象です。これらは単一の workspace ではなくユーザーアカウントにスコープされ、シークレット値は保存時に暗号化されます。

AIコーディングエージェントClick to copy link​

どのエージェントを実行できますか?

Claude Code は第一級のサポート対象です。bitrise-cli rde claude を実行すると、セッションが作成され、ブランチがクローンされ、エージェントが起動します。その他のエージェントは、templateのウォームアップスクリプトからインストールできます。Model Context Protocol をサポートする AIエージェント であれば、RDE MCP serverを通じてセッションを操作できます。

自分の AI サブスクリプションが必要ですか?

はい。エージェントは、ご自身のサブスクリプションまたは API キーで動作します。初回の使用時には、CLI がローカルの Claude Code 認証情報を取得するか、ブラウザーを開いてサインインを促します。認証情報は保存されるため、以降のセッションは認証済みの状態で起動します。

エージェントはローカルマシンにアクセスできますか?

はい。作業中に CLI が維持する安全な接続を通じてアクセスできます。エージェントは、セッションのデスクトップに接続した VNC ビューアーを開いたり、ファイルをアップロードまたはダウンロードしたりできます。VNC パスワードはローカルにのみ保持され、セッションに送信されることはありません。

接続が切断された場合はどうなりますか?

CLI が自動的に再接続し、エージェントはセッション内で実行され続けます。bitrise-cli rde claude --continue は、そのリポジトリで直近のセッションと会話を再開します。--resume では、以前のものから選択できます。

機能と制限Click to copy link​

Docker を実行できますか?
  • Linux: はい、Docker を完全にサポートしています。
  • macOS: いいえ。Apple の仮想化ではネストされた仮想化を利用できないため、Docker、OrbStack、Android エミュレーターは macOS セッション内で実行できません。コンテナーを使う作業には、Linux セッションを使用してください。
iOS シミュレーターや Android エミュレーターを実行できますか?

はい。device sessionでは、セッションと同時にシミュレーターやエミュレーターが起動し、ブラウザーにストリーミングされます。また、device preview linkを使うと、Bitrise アカウントを持たない人でも、そのデバイス上でビルドを試せます。

RDE を使用すると、CI のビルドクレジットを消費しますか?

いいえ。RDE は別途課金され、ビルド時間やクレジットは消費されません。

プライベートネットワークや VPN にアクセスできますか?

はい。templateのカスタムスクリプトを使用します。CI のマシンと同じ方法です。専用の Step やワンクリックでのセットアップは、まだありません。

複数人で1つのセッションを共有できますか?

個人用セッションは、作成したユーザーが所有し、そのユーザーのみが管理できます。bitrise-cli rde session create --owner workspace で作成された、または device preview linkによって生成された workspace 所有のセッションは、workspace のすべてのメンバーが、Workspace sessions で確認および管理できます。

API はありますか?

はい。セッション、テンプレート、saved input のライフサイクル全体を操作できます。詳しくは、Remote Dev Environments APIをご覧ください。

料金Click to copy link​

RDE の料金体系はどうなっていますか?

RDE は Bitrise CI とは別に課金され、ビルドクレジットは消費されません。購入方法は2つあります。

  • セルフサービス: 料金は公開されています。RDE pricing をご覧のうえ、そこからサインアップしてください。
  • Enterprise: 料金は確約された容量に基づき、Bitrise の営業チームを通じて決定されます。Bitrise pricing calculator で試算し、Bitrise に見積もりをご依頼ください。

関連情報