GitLab → 搭建中常遇的问题与日常维护
青石路 人气:0开心一刻
隔壁有一个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 youzhibing2094@sina.com yzb2094 青石路
12345678 test1@qq.com test1 测试账号1 12345678 test2@qq.com 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 一样了
参考
GitLab Docs
Gitlab快速部署及日常维护(社区版RPM包方式安装)
加载全部内容