サーバーはリポジトリを自分でクローンして 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] です。