GitLab → 搭建中常遇的问题与日常维护

2019/04/10 10:10
阅读数 24

开心一刻

  隔壁有一个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包方式安装)

原文出处:https://www.cnblogs.com/youzhibing/p/12572598.html

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部