您的服务器会自行克隆和推送您的仓库,因此它需要自己的途径访问 GitHub、GitLab、Bitbucket 或您自己的 Git 服务器。公开仓库无需任何设置。对于私有仓库,只需为服务器提供一次密钥或令牌;之后的每个项目都能直接使用。
密钥和令牌保留在您的服务器上。rdev.cloud 只能看到公钥,您在面板中输入的令牌会在发送前于浏览器中针对您的服务器加密。
三种访问方式
| 方式 | 可访问 | 最适合 |
|---|---|---|
| 服务器密钥 | 您的 Git 账户能打开的所有仓库 | 一个个人账户 |
| 账户 | 您列出的所有者的仓库,每个账户有自己的 SSH 密钥或令牌 | 多个账户、工作和个人账户、其他主机 |
| 部署密钥 | 单个仓库 | 最小范围的访问,客户的仓库 |
服务器克隆时会选择第一个适用的方式:项目的部署密钥,其次是主机和所有者与 URL 匹配的账户,最后是服务器密钥。如果 SSH 克隆被拒绝且仓库是公开的,则回退到 HTTPS。每次克隆都会记住它是如何打开的,因此 git pull 和 git push 可以持续工作。
服务器密钥
在服务器下打开服务器,进入访问标签页,找到 Git 访问。首次请选择生成密钥,复制密钥并将其添加到您的账户:GitHub、GitLab 和 Bitbucket 各有一个按钮,可打开正确的页面。同一个密钥也可用于推送,因此您的 AI 智能体也可以推送。
在服务器的终端中:
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
账户
可以添加任意多个账户:两个 GitHub 账户、公司的 GitLab、Bitbucket 和自托管的 Gitea 可以并存。每个账户包含:
- 名称: 简短,例如
work或personal。 - 主机:
github.com、gitlab.com、bitbucket.org或您自己的主机,当 SSH 不在 22 端口时加上:port。 - 所有者: 可选的用户或组织。其名下的仓库使用此账户;没有所有者时,主机上的所有仓库都使用它。
- SSH 密钥或令牌: SSH 账户会获得自己的密钥,需添加到主机上。令牌账户使用个人访问令牌通过 HTTPS 克隆(GitHub 细粒度令牌、GitLab 个人或项目令牌、Bitbucket API 令牌、Azure DevOps PAT)。GitLab 需要用户名
oauth2,Bitbucket 需要您的电子邮件。
在面板中选择添加账户。在笔记本电脑应用中,同样的列表位于集成标签页。在终端中:
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
部署密钥
部署密钥只能打开一个仓库。在部署密钥下输入项目名称(现有项目或您即将添加的项目),选择生成部署密钥,然后将密钥添加到仓库的部署密钥中;如果智能体需要推送,请授予写入权限。添加项目时,勾选使用项目的部署密钥,或运行:
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。服务器会尝试读取它,并且如果您勾选了同时检查是否可以推送,还会尝试在不更改任何内容的情况下推送。结果会说明使用了哪个密钥或令牌,或下一步该怎么做。在终端中:rdev git test <url> [--write]。