【学习GitLab】常用设置
文章目录
- 1 前言
- 2 GitLab常用设置
-
- 2.1 语言
- 2.2 是否允许自注册
- 2.3 限制用户项目数量
- 2.3 仓库路径是否只隶属于某个用户
- 2.5 代码仓库可见性
- 2.6 仓库访问协议
- 2.7 禁用派生
- 2.8 哈希仓库存储路径
- 2.9 修改仓库路径(仓库路径是否安全)
- 2.10 申请加入/退出项目
- 2.11 能否禁用Web IDE直接修改并提交
- 2.12 自带的issue状态能否自定义
1 前言
最近在学习 GitLab，将学习成果做个简要总结，以供大家参考。如有错误，欢迎留言纠正！你的「点赞」或「打赏」将是对我最大的支持和鼓励！
- 官网地址：https://about.gitlab.com/
- 在线文档：https://docs.gitlab.com/ce/README.html
- 本地文档：用户登录后，点击右上角 Help 菜单
- 我的版本：GitLab Community Edition 13.3.4
本次系列文章包括：
- 【学习GitLab】初次安装
- 【学习GitLab】常用设置
- 【学习GitLab】角色与权限
- 【学习GitLab】hook
- 【学习GitLab】集成Jenkins
- 【学习GitLab】集成Redmine
2 GitLab常用设置
2.1 语言
用户可以自行选择默认语言，在「用户 > 设置 > 偏好 > 语言」里设置。
2.2 是否允许自注册
是否允许用户自己申请注册新账号，在「管理员 > 管理中心 > 设置 > 通用 > 注册限制 > Sign-up enabled」里设置。
2.3 限制用户项目数量
在创建用户时，可以通过「Access > Projects limit」限制用户可创建的项目个数，0为禁止创建项目。如果你不想让用户有新建项目的权限（哪怕私有项目也不行），那这个配置就能起到作用。
默认值可以通过「管理员 > 管理中心 > 设置 > 通用 > 帐户和限制 > Default projects limit」修改，如上图所示。注意，用户需要重新登录才能让看到新的配置生效。
限制的项目数包括私有、内部、公开三种类型的项目数量的总和。比如限制项目数为3，代表能且仅能创建3个任意类型（私有、内部、公开）的项目。
注意，这里的限制，是指当用户所拥有的项目数量（包括自己创建的项目和加入别人创建的项目）超过限制，则用户不能再新建项目，但依然可以加入别人的项目。
2.3 仓库路径是否只隶属于某个用户
创建项目时，默认是创建在个人用户名空间之下，从代码仓库的URL来看，就像是仓库隶属于某个用户。对于公司公共的项目，这样不太好。可以在GitLab群组之下创建项目来解决这个问题。群组可以在同一命名空间下存放几个依赖项目。
2.5 代码仓库可见性
代码仓库代码是否要在web上显示出来，哪些用户可见，哪些用户不可见，是可以配置的，见：「项目 > 设置 > 通用 > 可见性，项目功能，权限 > 仓库」。
2.6 仓库访问协议
在GitLab中允许有两种仓库访问协议：SSH和HTTP(S)，可以有选择性的只启用其中一种，或者两种都启用。管理员可以在 「管理中心 > 设置 > 通用 > 可见性与访问控制 > 启用 Git 访问协议」中配置。
如果要强制大家使用SSH协议，可以在这里配置。
2.7 禁用派生
每个用户都可以派生，会导致服务器空间难于控制，有以下两种方式可以禁用派生：
方式一，派生的项目，就相当自己的项目了，会占用个人仓库数量名额。个人仓库数量达限制上限时，就无法使用派生功能，派生会失败。个人仓库数量设置为0，就无法使用派生功能。
方式二，在「项目 > 设置 > 通用 > 可见性，项目功能，权限 > 仓库」中禁用派生权限。没法所有项目统一禁用，只能每个项目单独禁用。
2.8 哈希仓库存储路径
从 GitLab 13.0 版本起，哈希仓库存储路径（Hashed repository storage paths）已经是默认的仓库存储方式。这种方式的存储路径很难跟项目名称建立直观的联系，如果要查看某个项目对应的哈希仓库存储路径，可以到 Admin Area > Overview > Projects 打开项目，其中 Gitaly relative path 值就是，如下所示：
Gitaly relative path:
@hashed/4e/07/4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e4729b49fce.git
更多信息，见官网：https://docs.gitlab.com/ce/administration/repository_storage_types.html
2.9 修改仓库路径(仓库路径是否安全)
GitLab通过rpm包安装后，默认存储位置在「/var/opt/gitlab/git-data/repositories」，但仓库名采用的是 Hashed repository storage paths 方式，并不直观（我用的版本是 GitLab Community Edition 13.2.0）。
GitLab默认仓库路径有可能存在隐患，比如跟操作系统在同一分区，系统重装后数据会丢失。通常需要更改此路径到单独的一个分区来存储仓库的数据。
可按以下步骤修改存储位置：
1.新建新仓库目录
mkdir -p /path/gitlab/git-data
2.修改配置文件
vi /etc/gitlab/gitlab.rb
搜索 git_data_dir 关键词，修改成新目录。
3.停止gitlab，重新加载配置
gitlab-ctl stop
gitlab-ctl reconfigure
重新加载后，会发现在新目录下自动创建一个repositories目录。
4.数据迁移
如果原来目录已经存在Git仓库数据，你需要使用以下命令把数据迁移到新的位置。如果原来目录没有Gti仓库，可以跳过此步骤。
rsync -av /var/opt/gitlab/git-data/repositories/ /path/gitlab/git-data/repositories/
5.启动gitlab
gitlab-ctl start
2.10 申请加入/退出项目
非项目成员，可以申请加入项目（项目管理员审批），也可以退出项目。
注意：只有看得到的项目（内部项目或者公开项目），才可以在web上操作申请加入。对于私有项目，由于非项目成员看不到，也就无法申请加入。
2.11 能否禁用Web IDE直接修改并提交
GitLab可以在web上直接修改代码并提交，这个功能也叫做 Web IDE，是为了解决非程序员在编辑文件和提交变更上非常困难而发明的。
通过 Web IDE 直接修改提交，跟 git push 一样，也会经过 server hook 验证（比如pre-receive脚本）。
目前来看，好像无法禁用Web IDE提交代码。
2.12 自带的issue状态能否自定义
GitLab 自带有问题管理系统，但其issue状态比较简单，问题状态只有两个：Open和Close，还无法自定义扩展。