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

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

rdev の使い方

Git アクセス

サーバーはリポジトリを自分でクローンして push するため、GitHub、GitLab、Bitbucket、または独自の Git サーバーに入るための独自の手段が必要です。公開リポジトリには何も必要ありません。プライベートなリポジトリには、サーバーに鍵またはトークンを一度渡せば、以降のすべてのプロジェクトがそのまま動作します。

鍵とトークンはサーバー上に残ります。rdev.cloud が見るのは公開鍵だけで、パネルに入力したトークンは、送信前にサーバー用にブラウザー内で暗号化されます。

3つの方法

方法 アクセス先 向いているケース
サーバーキー Git アカウントが開けるすべてのリポジトリ 個人アカウント1つ
アカウント 指定したオーナーのリポジトリ。それぞれ専用の SSH 鍵またはトークン付き 複数のアカウント、仕事用と個人用、ほかのホスト
デプロイキー 単一のリポジトリ 最小限のアクセス、クライアントのリポジトリ

サーバーがクローンするときは、合うものを順に選びます。プロジェクトのデプロイキー、次に URL のホストとオーナーが一致するアカウント、最後にサーバーキーです。SSH でのクローンが拒否され、リポジトリが公開されている場合は、HTTPS にフォールバックします。各クローンは開いた方法を記憶するため、git pull と git push は引き続き動作します。

サーバーキー

サーバー からサーバーを開き、アクセス タブに進んで Git アクセス を見つけます。初回は キーを作成 を選び、キーをコピーしてアカウントに追加します。GitHub、GitLab、Bitbucket にはそれぞれ、正しいページを開くボタンがあります。同じキーで push もできるため、AI エージェントも push できます。

サーバーのターミナルからは次のとおりです。

rdev git key            # print the key (made on first use)
rdev git key --rotate   # make a new one; remove the old one from your hosts

アカウント

アカウントはいくつでも追加できます。2つの GitHub アカウント、会社の GitLab、Bitbucket、セルフホストの Gitea を並べて使えます。各アカウントには次の項目があります。

  • 名前: work や personal のような短い名前。
  • ホスト: github.com、gitlab.com、bitbucket.org、または独自のホスト。SSH が22番ポートでない場合は :port を付けます。
  • オーナー: 任意のユーザーまたは組織。その配下のリポジトリはこのアカウントを使います。オーナーを指定しない場合は、ホスト上のすべてのリポジトリが使います。
  • SSH 鍵またはトークン: SSH アカウントには、ホストに追加するための専用の鍵が割り当てられます。トークンアカウントは、パーソナルアクセストークン(GitHub のファイングレインドトークン、GitLab のパーソナルまたはプロジェクトトークン、Bitbucket の API トークン、Azure DevOps の PAT)を使って HTTPS でクローンします。GitLab ではユーザー名に oauth2、Bitbucket ではメールアドレスを指定します。

パネルでは アカウントを追加 を選びます。ノートPCアプリでは、同じ一覧が 連携 タブにあります。ターミナルからは次のとおりです。

rdev git account add work --host github.com --owner acme
echo "$TOKEN" | rdev git account add lab --host git.example.com --token --user oauth2
rdev git account list
rdev git account remove lab

デプロイキー

デプロイキーは1つのリポジトリを開きます。デプロイキー の下にプロジェクトの名前(既存のプロジェクト、またはこれから追加するプロジェクト)を入力して デプロイキーを作成 を選び、そのキーをリポジトリのデプロイキーに追加します。エージェントに push させたい場合は、書き込み権限を付けてください。プロジェクトを追加するときに プロジェクトのデプロイキーを使用 にチェックを入れるか、次を実行します。

rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key

ホストを信頼する

サーバーは、GitHub、GitLab、Bitbucket の鍵をすでに知っています。ほかのホストに初めて接続するときは、盲目的に接続せず、そのホストがフィンガープリントとともに 信頼待ちのホスト に表示されます。Git ホストが公開しているものと比較して 信頼する を選ぶか、rdev git trust git.example.com --fingerprint SHA256:… を実行してください。

アクセスのテスト

プロジェクトを追加する前に、アクセスをテスト の下にその URL を貼り付けます。サーバーは読み取りを試み、push できるかも確認する にチェックを入れた場合は、何も変更せずに push も試みます。結果には、どの鍵またはトークンを使ったか、または次に何をすべきかが示されます。ターミナルからは rdev git test <url> [--write] です。