至少输入两个字母,即可搜索文档的所有页面。

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

Git 访问

您的服务器会自行克隆和推送您的仓库,因此它需要自己的途径访问 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]。