GitLab → 搭建中常遇的问题与日常维护
- 2020 年 4 月 2 日
- 筆記
开心一刻
隔壁有一个80多岁的老大爷，昨天在小区的一棵树下发现一条黑色的蛇，冻僵了，大爷善心大发，就把蛇揣在了怀里，想给它一点温暖。
今天一大早看到大爷在树上挂了一个牌子，写到：不准随地大小便！
搭建中遇到的问题
楼主的搭建过程算比较顺利（GitLab → 搭建私有的版本控制的托管服务平台），没有遇到太多问题，只遇到了如下两个问题
安装卡住
这基本是内存不足导致
楼主一开始比较任性，没按官方的推荐（内存最少 4G）来，弄了个 2G 内存，一顿操作猛如虎，定睛一看原地杵，特么的竟然像泰山一样稳，进度在那一动不动
直接卡住是比较烦的，因为不能直观地看出是否真的是卡住了，还是在安装中，只能凭感觉、经验来判断；如果出现如下类似错误信息
* execute[clear the gitlab-rails cache] action run ================================================================================ Error executing action `run` on resource 'execute[clear the gitlab-rails cache]' ================================================================================
这也是内存不足所致
502
当我们成功安装、配置 GitLab 后，不一定就万事大吉了，访问 GitLab 的时候可能会出现如下错误
GitLab 所需内存最低为 4G，若服务器配置太低会出现 502 错误
GitLab 新装或重启后，需要等待 1 分钟才能使用
对于单核 CPU 的服务器，Unicorn and Sidekiq 服务启动最少需要一分钟
这个问题楼主没有遇到，因为开始的时候，楼主就给虚拟机分了 4 核 CPU
那么说白了，只要我们的虚拟机（或真实机器）环境足够干净，硬件资源（内存和 CPU）足够好，就不太会出现如上的错误
日常维护
重置管理员的密码
由于 root 账户用的很少，所以我们容易忘记它的密码，但不代表它不重要，类似 linux 的 root 账户；一旦我们忘记了 root 账号的密码，我们需要知道重置的方法，方法如下
1、进入 GitLab 控制台
[root@localhost ~]# gitlab-rails console -e production
GitLab 版本不同，命令会有所不同（网上说的而基本都是 gitlab-rails console production ），推荐大家直接上 GitLab 官网去找对应版本的命令
当出现如下信息表示我们成功登入控制台
[root@localhost ~]# gitlab-rails console -e production -------------------------------------------------------------------------------- GitLab: 12.8.7 (b679f55a199) FOSS GitLab Shell: 11.0.0 PostgreSQL: 10.12 -------------------------------------------------------------------------------- Loading production environment (Rails 6.0.2) irb(main)
执行命令： user = User.where(id: 1).first ，此 user 则表示 root 用户
3、修改密码
执行命令： user.password = ‘secret_pass‘ 修改密码， user.password_confirmation = ‘secret_pass‘ 确认密码
4、保存密码
执行命令： user.save!
5、退出控制台
执行命令： exit
完整过程类似如下：
官方示例：How to reset your root password
重置成功后，我们就可以用新密码来登录 root 账号了
偏好设置
GitLab 提供了很多的设置，楼主这里偷个懒，只教大家如何设置语言（虽然楼主知道大家的英语都很棒，但我相信大家的中文更棒），当语言变成我们最擅长的中文时，相信大家都能很好的进行偏好设置了；语言设置过程如下
看着熟悉的中文，倍感亲切，但是要注意： 此功能当初处于实验阶段，翻译尚未全部完成 ，也就是说语言功能尚未全部完成
批量添加账号
我们用 SVN 或 Git 的时候，账号往往不是自己注册的，而是统一分配的；而我们搭建的又是私服，不对外提供服务，所以无需注册功能，那么我们用 root 账号来关闭注册功能，很简单，流程如下
取消 Sign-up enabled 前的复选框勾选，保存就好了
退出登录后可以发现，登录页的注册功能没了，既然不能注册了，那么就需要通过 root 用户来添加账号了
添加单个账号的话，可以直接通过管理中心来添加，具体如下图
单个账号的添加还可以通过 api 来实现，具体可查看：Users API
如果账号少的话，通过单个添加的方式来添加是可以的，如果账号特别多的话，那就有点费时了，所以需要通过脚本的方式来批量添加账号了，具体我们往下看
1、创建账户文本
在 /opt 目录下创建 account_info.txt
12345678 [email protected] yzb2094 青石路
12345678 [email protected] test1 测试账号1 12345678 [email protected] test2 测试账号2
4 列分别代表：登录密码 邮箱 用户名 别名
一行代表一个账户
2、获取 root 用户的 private_token
获取方式比较简单，如下图所示
如果访问令牌已经存在，则不需要新建；示例中的令牌： cwUxu3-2kiamVyKJQpW5
3、创建执行脚本
在 /opt 目录下创建 batch_add_account.sh
#!/bin/bash #gitlab用户文本 accountinfo="account_info.txt" while read line do password=`echo $line | awk '{print $1}'` mail=`echo $line | awk '{print $2}'` username=`echo $line | awk '{print $3}'` name=`echo $line | awk '{print $4}'` curl -d "password=$password&email=$mail&username=$username&name=$name&private_token=cwUxu3-2kiamVyKJQpW5" "http://192.168.0.115/api/v4/users" done < $accountinfo
private_token 的值就是上面 root 的访问令牌
4、执行脚本
赋予 batch_add_account.sh 可执行权限： [root@localhost opt]# chmod +x /opt/batch_add_account.sh
再执行 batch_add_account.sh： [root@localhost opt]# sh /opt/batch_add_account.sh
然后我们就可以在用户列表界面看到我们刚刚添加的账户了
批量创建用户，还是通过 Users API 来完成的，也会是说底层还是一个一个添加的
5、新账户登录
我们用账号：yzb2094 登录下，发现登录不了，提示： You have to confirm your email address before continuing.
提示需要邮箱验证，登录下邮箱，还真有一封验证邮件
我们点击下其中的链接，完成验证之后就可以正常登录了，然后我们就可以在 GitLab 创建工程了， 后续操作就与 GitHub、Gitee 一样了
参考
