Perforce 指引

服务器

安装安装

参考Helix Core Quick Start Guide， 适用于 Ubuntu 发行版，需确保有 root 访问权限。其他操作系统请参阅：Helix Core Server Administrator Guide 中的 Install the server 一章

1
2
3
4
5
6
7
8
# 下载 perforce 公钥
wget https://package.perforce.com/perforce.pubkey
# 生成公钥指纹
gpg -n --import --import-options import-show perforce.pubkey
# 验证匹配
gpg -n --import --import-options import-show perforce.pubkey | grep -q "E58131C0AEA7B082C6DC4C937123CB760FF18869" && echo "true"
将公钥添加到 keyring
wget -qO - https://package.perforce.com/perforce.pubkey | sudo apt-key add -

完成上述命令后，新建一个文件 /etc/apt/sources.list.d/perforce.list，并在最后一行写入 deb http://package.perforce.com/apt/ubuntu focal release，用于配置 perforce 的源，之后使用包管理器安装 perforce 即可：

1
2
sudo apt update
sudo apt install helix-p4d

安装完成后，执行以下命令进入交互模式来配置 perforce 服务：

1
sudo /opt/perforce/sbin/configure-helix-p4d.sh

配置完毕后，执行以下命令运行 perforce 服务器：

1
p4 login

本地创建测试服务器时，我使用的是 WSL 安装 p4d，Windows 安装 p4v 并连接 WSL 中的 p4d 服务器
这里的服务器地址需要在 WSL 内执行 ifconfig 来获取 IP 地址，而不是在 Windows 中执行 ipconfig

用户和组的创建

在 P4Admin 工具中，单击 View->Users & Groups 选项，跳转到 Users & Groups 选项卡，左边为用户管理界面，右边为用户组管理界面，在对应的管理界面空白处右键，即可创建用户或用户组

image.png{:height 623, :width 1259}

权限管理

在 P4Admin 工具中，单击 View->Permissions 选项，可以对用户或者用户组进行权限配置，在下方可以看到一张权限表格，需要编辑这张表格来配置用户或者用户组的权限：

image.png

表格的默认内容如下：

Access Level User/Group Name Host Folder/File Comment
write user * * //…
no access user * * //spec/…
super user super * //…

表格一共有 6 列，这 6 列的含义如下：

  • Access Level：访问等级
  • User/Group：基于用户还是基于用户组来配置权限
  • Name：用户/用户组的名称
  • Host：不清楚
  • Folder/File：权限生效的路径（目录或文件）
  • Comment：注释

举例说明，默认的权限表内容有三行，分别代表的含义如下：

  • 第一行：访问等级为 write，基于用户来配置权限，名称为 *，权限生效的路径为 //…，这一行的含义为：
    • 所有的用户（因为是基于用户来配置权限，且名称为 * 表示所有用户）都具有所有路径（因为权限生效的路径配置为 //...）的 write 权限
  • 第二行：访问等级为 no access，基于用户来配置权限，名称为 *，权限生效的路径为 //spec/…，这一行的含义为：
    • 所有的用户都无法访问 spec 仓库
  • 第三行：访问等级为 super，基于用户来配置权限，名称为 super，权限的生效路径为 //…，这一行的含义为：
    • super 用户拥有所有仓库的 super 权限，即最高权限

当我们需要为新的用户或者新的用户组配置新的权限时，点击表格上方的 Insert line 按钮，创建新行并编辑内容，编辑完毕后，点击表格右上方的 Save Edits 按钮即可，比如，我们需要对 group0 的所有用户开启对 depot0 的 write 权限，则权限表格的配置内容如下：

Access Level User/Group Name Host Folder/File Comment
write group group0 * //depot0/…

仓库和仓库流的创建

创建仓库

  • 从 P4V 工具中单击 Tools > Administration 打开 P4Admin
  • 在 P4Admin 窗口中，单击 Depots 选项卡
  • 选择 File > New > Depot 新建仓库
  • 在对话框中，输入仓库名称后并点击 OK
  • 在新跳出的对话框中，将 Depot type 选择为 stream，单击 OK

创建 mainline

Stream 是 Perforce 中处理分支和合并的首选方式，要使用 stream 工作流，需要为仓库创建一个 mainline stream，才能添加其他的 stream 类型，任何对仓库具有写入权限的用户都可以创建 stream，创建 mainline stream 的步骤如下：

  • 在 P4V 界面中，单击 View > Stream Graph 选项打开 Stream Graph 界面，该界面会显示特定 depot 中所有的 stream
  • 右键单击 Stream Graph 界面中的空白处，并选择 New Stream
  • 在 Stream: New 对话框中，输入 Stream name
  • 在 Stream type 字段中，选择 mainline
  • 将 Parent view 选择为 inherit
  • 取消勾选 Create a new workspace to use with this stream
  • 取消勾选 Populate the mainline stream after it is created
  • 点击 OK 来完成创建

客户端

创建 workspace

参考