Wiki
创建仓库
创建 uVersion 仓库:谁有权限、两种可行途径(管理面板或已有的项目文件夹),以及服务器自动完成的事情。
仓库是服务器端的项目:它保存着你生产内容的历史和文件。 workspace 是磁盘上与之对应的文件夹。两者是分开的:创建仓库不会在 你的机器上生成任何东西,反之亦然。
谁可以创建仓库
admin 角色可以创建仓库,无论采用哪种途径。lead 或
project_admin 都不行:服务器会返回 Admin role required,而
客户端只是对他们隐藏了按钮。如果你看不到下面描述的按钮,原因在于你的角色,而不是
显示故障。
uversion 命令行没有任何创建命令:它能克隆并在已有仓库中
工作,但不能创建仓库。请使用桌面客户端或 Web 界面。
两种途径
如何选择取决于你已经拥有什么:
- 你从零开始,或者你在准备一个团队之后会填充的项目:从管理面板创建 一个空仓库。这是唯一可以填写描述的途径。见下文。
- 你的磁盘上已经有一个 Unreal 项目,并且想把它纳入 uVersion 管理: 不要走这里,请按上传已有项目操作。这条途径一步就能 创建仓库并连接你的文件夹,不会移动任何东西。
从管理面板
1. 打开 Repositories 标签页
在侧边栏中打开 Admin,然后打开 Repositories 标签页。 注意选对行:面板有两行,SERVER 针对整个服务器相关的内容, PROJECT 只针对旁边所选的那个仓库。仓库在 SERVER 行中创建。
页眉显示活动仓库的数量。在全新的服务器上列表为空,+ Create Repository 按钮位于右上角。
2. 打开创建对话框
点击 + Create Repository。会打开一个带两个字段的对话框,其中灰色显示的 文字只是示例:没有任何内容被预先填入。
3. 为仓库命名并确认
填写 Name 字段。Description (optional) 字段是可选的, 而且这是你唯一可以填写它的地方。只要名称为空,Create 按钮就一直保持 不可用。
自动发生的事情
创建时,服务器会不经询问做三件事:
- 它创建对应的存储文件夹,其名称由你的名称派生而来:任何既不是字母也不是数字的字符 都会变成连字符;
- 它安装默认的验证规则。它们全部处于停用 状态:在管理员启用之前,不会运行任何检查;
- 它在审计日志中写入一条记录。
另一方面,不会设置任何权限。一个新仓库只有 admin 和
lead 角色可见:在你尚未对它授予任何权限之前,其他账户完全看不到它,连
只读也不行。这是接下来要做的第一件事,在 Permissions
标签页中完成。
常见陷阱
“Invalid repository name”
名称为空,或超过 255 个字符。没有其他约束:空格和重音字符都被接受,只有存储文件夹的 名称会被简化。
“Repository name already exists”
名称在整个服务器上是唯一的。检查在保存时进行,因此消息在点击 Create 之后才出现,而不是 在输入过程中。也别忘了已停用的仓库:它们仍然占用着各自的名称。
我创建了仓库却找不到我的文件
这是预期的行为:从管理界面创建只会在服务器上生成一个空仓库,绝不会触碰你的磁盘。你多半 是想把一个已经拥有的项目纳入 uVersion 管理。
空仓库不会妨碍任何人,也不消耗任何资源:不要下意识地删除它。有两个出口,按优先顺序排列:
- 用起来。 把它克隆到一个空文件夹中,把你项目的内容移进去,然后从 上传已有项目的上传步骤继续。什么都不会被销毁,仓库也会 保留你给它起的名称。
- 把它搁在一边,从上传已有项目重新开始, 它会从你的文件夹创建自己的仓库,不移动任何东西。你需要另起一个名称,因为这个已经被 占用了。
我的团队看不到新仓库
在尚未授予任何权限之前这是正常的。见 Permissions。