ドキュメントの全ページを検索するには、2文字以上入力してください。

↑ ↓ で移動 ↵ で開く esc で閉じる

rdev の使い方

プロジェクトとサイト

サーバー上のすべてのプロジェクトは、専用のアドレスと信頼された HTTPS を持つサイトになります。

サイトのアドレス

各プロジェクトには https://<name>.dev.test が割り当てられます。証明書はノートPCに信頼されているため、ブラウザーに警告は表示されず、ノートPCが tailnet に接続されている場所であればどこでもアドレスが機能します。

PHP

  • 7.4 から 8.5 までのすべての PHP バージョンを、サイトごとに選択できます。
  • Laravel と WordPress を第一級でサポートします。
  • ほかの PHP フレームワークや、素の PHP プロジェクトにも対応しています。
  • mongodb や xdebug などの拡張機能は、コマンド1つでインストールできます。PHP 拡張機能 を参照してください。

その他の言語

Python、Ruby、Node.js、Go、.NET、Java、Flutter のプロジェクトに対応しています。言語ランタイムは、既定ではインストールされていません。これらの言語のプロジェクトを追加すると、rdev がその時点で必要なランタイムをインストールし、以降のプロジェクトで再利用します。

これにより環境が小さく保たれ、使わないランタイムを更新する必要もありません。

データベースとサービス

すべてのプロジェクトで、MySQL、MariaDB、PostgreSQL、MongoDB、Redis、Meilisearch、Typesense、RustFS を選択したバージョンで利用でき、メールキャプチャとダンプサーバーも使えます。それぞれの用途、バージョン、.env の設定、一覧にないものを動かす方法は、サービス に記載されています。

プロジェクトを追加する

プロジェクトは3つの方法で追加できます。

  • AI エージェントに依頼する 方法。エージェントは MCP アクセスを通じてサイトを作成します。
  • サーバー上の rdev コマンドラインツール を使う方法。
  • Web パネル から追加する方法。

~/Code に作成したフォルダーはすぐに https://<folder>.dev.test として公開されるため、PHP プロジェクトをそこにクローンするだけで十分です。

フレームワークから始めるレシピ

レシピは、空の ~/Code/<name> フォルダーに、フレームワークから新しいプロジェクトを開始します。rdev が言語をインストールし、フレームワーク自身のインストーラーを実行し、開発サーバーのコマンドを設定して、アプリを https://<name>.dev.test で公開します。

言語 レシピ
PHP Laravel と WordPress(組み込み)、Symfony、Statamic、CodeIgniter、CakePHP、Drupal
Node.js Next.js、Nuxt、Astro、SvelteKit、React、Vue、Angular、Ionic(Capacitor 使用)、Expo(React Native)、NestJS、Express、空の Node.js プロジェクト
Python Django、Flask、FastAPI、空の Python プロジェクト(それぞれ専用の .venv 付き)
Ruby Ruby on Rails、Sinatra、空の Rack プロジェクト
Go Gin、Echo、Fiber、空の Go モジュール
.NET ASP.NET Core Web API、Blazor、空の ASP.NET Core アプリ
Java Spring Boot、Quarkus、Micronaut、空の Java プロジェクト
Flutter Web、Android、iOS 向けの Flutter アプリ(ライブ Web プレビュー付き);Dart の HTTP サーバー(shelf)

モバイル向けレシピ(Ionic、Expo、Flutter)は、アプリの Web プレビューをサーバー上で実行します。Android と iOS のビルドはノートPCで行います。tailnet 内のスマートフォンの Expo Go なら、Expo プロジェクトをサーバーから直接開くこともできます。

  • パネルで: サーバー でサーバーを開き、レシピ タブでレシピの プロジェクトを作成 を選ぶか、プロジェクトを追加 で種類としてレシピを選びます。プロジェクトは プロジェクト タブに表示されます。
  • サーバーで: rdev project recipes で一覧を表示し、rdev project add web --recipe nextjs で開始します。
  • エージェントから: プロジェクトを追加する MCP ツールは recipe を受け取るため、「api という名前の Django プロジェクトを開始して」と依頼できます。

Django と Rails は *.dev.test のアドレスを受け付けるよう設定され、Vite ベースの開発サーバー(Nuxt、Astro、SvelteKit)でも許可されます。レシピは rdev が署名したカタログから提供され、サーバーは署名が一致しないカタログを拒否するため、新しいフレームワークは rdev のアップデートなしで追加されます。レシピには rdev 0.2.0-beta.38 以降が必要です。

コマンドラインで

  • リポジトリをクローンして、プロジェクトとして公開する:

    rdev project add shop --git [email protected]:you/shop.git
    
  • ランタイム付きで、空の Python プロジェクトを開始する:

    rdev project add api --lang python
    
  • 別の PHP バージョンでサイトを公開する:

    rdev use shop 8.3
    

    パネルでは、サーバーの PHP カードの プロジェクト 列でプロジェクトをクリックします(PHP 拡張機能)。

rdev project list はプロジェクトを一覧表示し、rdev project start|stop|logs <name> は PHP 以外のプロジェクトの開発サーバーを制御し、rdev project remove <name> はプロジェクトを削除します(--delete-files を追加しない限り、ファイルは残ります)。

パネルから

ターミナルを開かずにプロジェクトを追加することもできます。サーバー でサーバーを開き、その プロジェクト タブの 追加 を選ぶか、ダッシュボードのサーバーの横の プロジェクトを追加 を選びます。名前を付けて種類を選びます:新しい Laravel アプリ、新しい WordPress サイト、git リポジトリのクローン、空の PHP プロジェクト、または レシピ のいずれかです。サーバーは約5分以内にリクエストを取り込み、https://<name>.dev.test で準備ができるとダッシュボードに表示されます。ダッシュボードの パネルから追加 テーブルには、リクエストしたすべてのプロジェクトとサービスが、サーバー、ステータス、失敗した場合はその理由とともに一覧表示されます。rdev がこのためにサーバーに接続することはありません。サーバーがリクエストを取りに来ます。 git リポジトリでは言語も選べます(PHP、Node.js、Python、Ruby、Go、.NET、Java)。自動判別 のままならサーバーがリポジトリのファイルから判断します。選択とファイルが合わない場合、サーバーは選択を優先し、そのことをプロジェクトの状態に表示します。

プロジェクト タブには、サーバーが報告するすべてのプロジェクトがアドレスとともに一覧表示され、リクエストしたもののうち、まだ処理中のものや失敗したものが、理由とともに表示されます。

修正、削除、エイリアス

プロジェクト タブにあるプロジェクトの ⋯ メニュー:

  • 編集して再試行(設定に失敗したプロジェクト): 依頼した内容(リポジトリ URL やレシピなど)が入った状態でフォームが開きます。修正して再送信してください。リストから削除 は失敗した依頼を非表示にします。
  • 編集して再インストール(サーバー上のプロジェクト): プロジェクトのフォルダを削除し、選んだタイプで最初から設定し直します。データは残るため、データベースも削除 にチェックしない限り、新しいプロジェクトは以前のデータを引き継ぎます(何が削除されるかは下記を参照)。先に作業内容を commit して push してください。git にないファイルは失われます。
  • 削除(データは保持) は ~/Code 内のプロジェクトのフォルダ、サイト、開発サーバーを削除します。データベースとストレージ内のファイルは残ります。完全に削除(データも削除) はプロジェクトのデータも削除します。同じ名前の MySQL、MariaDB、PostgreSQL、MongoDB のデータベース(my-shop は my_shop を使います)と、アップロードされたすべてのファイルを含む RustFS のバケット(my-shop)です。
  • エイリアスを追加 はプロジェクトにもう 1 つのアドレスを追加します。エイリアス store を追加すると、ノートPCと tailnet 上のすべてのデバイスで https://store.dev.test から同じサイトが開きます。ドットを使うと api.shop のようなサブアドレスになります。エイリアスはプロジェクトの下に表示され、横の × で削除できます。

サーバーは各操作を数秒以内に実行します。これには rdev 1.0.3 以降が必要で、MongoDB と RustFS のデータの削除には 1.0.4 以降が必要です。サーバー上では、rdev domain add <name> store.dev.test でエイリアスを追加でき、rdev project remove <name> --delete-files で rdev project add で作成したプロジェクトを削除できます(Laravel や WordPress のサイトは、フォルダを削除してください)。

データを削除する前に、何に影響するかを確認してください。

  • 元に戻せません。 Pro と Team の夜間バックアップにはデータベースが含まれるため、パネルから復元できます。RustFS のバケットは含まれないため、アップロードしたファイルは完全に失われます。必要なものは先にダウンロードしてください。
  • 所有者ではなく名前で削除されます。 rdev はプロジェクト名と同じ名前のデータベースとバケットを削除します。別のプロジェクトの .env が同じデータベースやバケットを指している場合、そのプロジェクトもデータを失います。
  • 停止しているサービスのデータは残ります。 rdev は実行中のサービスでのみ削除し、スキップしたサービスを知らせます。それらを起動してもう一度削除を実行するか、データを自分で削除してください。
  • Team プランでは、各メンバーの環境に専用のサービスがあります。自分の環境でプロジェクトを削除しても、所有者の共有サービスには一切影響しません。

プロジェクトにサービスを追加する

プロジェクトには、必要になったときに後からサービスを追加できます。

rdev project service shop postgres

パネルでは、プロジェクトの サービスを追加 またはサーバーの横の サービスを追加 を選びます。バージョンの選択、.env の設定、その他は サービス に記載されています。

パネルからの環境変数

ターミナルを開かずに API キーなどのシークレットを設定するには、サイドバーの サーバー からサーバーを開き、環境変数 を使います。プロジェクトを選び、追加または変更 に名前と値を入力して、暗号化して保存 を選びます。サーバーは数秒でそれをプロジェクトの .env に書き込みます。

値は、サーバー固有の鍵を使ってブラウザー内で暗号化されるため、rdev.cloud が値を見ることはなく、後から表示することもできません。現在の .env には名前だけが表示されます。値を変更するには、名前をクリックします。名前が 追加または変更 に移動するので、そこで新しい値を入力します。名前の × をクリックすると削除できますが、APP_KEY や DB_ の設定を削除すると、通常アプリは動作しなくなります。