公司的前任配置管理员安装的 gitlab 使用的是 bitnami 出品的全家桶，和官方的 gitlab 安装方式完全不同，包括配置文件、启动的方式、各种命令行工具都不相同。
他离职之后，gitlab 就交给新配置管理员了，但是对方对 gitlab 了解有限，基本上有什么疑难杂症还得找我。
我们的 gitlab 使用的是版本为 8.5.1，安装在 /opt 目录。
因为我们 gitlab 接入了 ldap，并且将 ldap 中的一个用户设置成了管理员，而这次又不知道是什么原因导致它被锁定了。锁定之后无法解锁，报 This user cannot be unlocked manually from GitLab 这样的错，同时也无法删除该用户，因为使用它创建了很多的组。
谷歌了一下，解决办法是通过 gitlab-rails 命令手动修改用户的状态，但是我根本没有找到这个命令。后来不死心，仔细找了找，终于在 /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/bin/ 找到了 rails 命令。
不过执行直接报错：
# /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/bin/rails
/usr/bin/env: ruby: No such file or directory
复制代码需要 ruby 环境。虽然可以直接 yum install ruby 来安装，但是自带的版本才 1.8.7，不用装我也知道太老，于是找安装 ruby 的方法。在官网上找到了一种 RVM 安装的方式，这种方式类似于 Python 的 pyenv，可以管理多个 ruby 版本。那没什么好想的，就它了。
安装 ruby
# curl -sSL https://rvm.io/pkuczynski.asc | gpg2 --import -
# \curl -sSL https://get.rvm.io | bash -s stable
复制代码安装在 /usr/local/rvm。安装完成之后提示要将使用 rvm 的用户加入到 rvm 组，不过我这里使用 root，就不管了。
接着就是安装 ruby 了，安装什么版本呢？我也不知道，但是 rvm 知道，执行下面命令即可。
cd /opt/gitlab-8.5.1-0/apps/gitlab/htdocs
/usr/local/rvm/bin/rvm list known
复制代码紧接着你就能够看到提示：
Required ruby-2.1.8 is not installed.
To install do: 'rvm install "ruby-2.1.8"'
复制代码当然下面还有很多内容，我们不用管，rvm 自动提示我们需要安装 2.1.8 版本的 ruby。之所以会出现这样的情况，我猜测是因为当前目录下存在 Gemfile、Gemfile.lock 等文件。
安装 ruby 2.1.8，请确保 yum 源可用：
/usr/local/rvm/bin/rvm install "ruby-2.1.8"
复制代码安装的位置为 /usr/local/rvm/rubies/ruby-2.1.8/bin/ruby。
安装完成之后我们修改 /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/bin/rails 文件，将第一行改为 /usr/local/rvm/rubies/ruby-2.1.8/bin/ruby，然后执行 rails 同样会失败，报对应的组件不存在。
安装依赖
不用慌，因为它依赖的包我们还没有装，这时返回到它的上级目录，就是 htdocs，它下面存在 Gemfile。
然后执行下面命令：
/usr/local/rvm/wrappers/ruby-2.1.8/bundle install
复制代码它开始安装 Gemfile 里面的依赖包，安装过程中难为会报错，因为总有些开发包你没有安装。报错了也不用慌，基本上它都会讲解决办法告诉你。
比如我这里安装 charlock_holmes 失败：
Fetching charlock_holmes 0.7.3
Installing charlock_holmes 0.7.3 with native extensions
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
current directory: /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/vendor/bundle/ruby/2.1.0/gems/charlock_holmes-0.7.3/ext/charlock_holmes
/usr/local/rvm/rubies/ruby-2.1.8/bin/ruby -r ./siteconf20190319-934-13vhsli.rb extconf.rb
checking for main() in -licui18n... no
which: no brew in
(/usr/local/rvm/gems/ruby-2.1.8/bin:/usr/local/rvm/gems/ruby-2.1.8@global/bin:/usr/local/rvm/rubies/ruby-2.1.8/bin:/usr/lib64/qt-3.3/bin:/usr/local/jdk1.7.0_79/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin)
checking for main() in -licui18n... no
# 这里已经告诉你解决办法
***************************************************************************************
*********** icu required (brew install icu4c or apt-get install libicu-dev) ***********
***************************************************************************************
*** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers. Check the mkmf.log file for more details. You may
need configuration options.
Provided configuration options:
--with-opt-dir
--without-opt-dir
--with-opt-include
--without-opt-include=${opt-dir}/include
--with-opt-lib
--without-opt-lib=${opt-dir}/lib
--with-make-prog
--without-make-prog
--srcdir=.
--curdir
--ruby=/usr/local/rvm/rubies/ruby-2.1.8/bin/ruby
--with-icu-dir
--without-icu-dir
--with-icu-include
--without-icu-include=${icu-dir}/include
--with-icu-lib
--without-icu-lib=${icu-dir}/lib
--with-icui18nlib
--without-icui18nlib
--with-icui18nlib
--without-icui18nlib
To see why this extension failed to compile, please check the mkmf.log which can be found here:
/opt/gitlab-8.5.1-0/apps/gitlab/htdocs/vendor/bundle/ruby/2.1.0/extensions/x86_64-linux/2.1.0/charlock_holmes-0.7.3/mkmf.log
extconf failed, exit code 1
Gem files will remain installed in /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/vendor/bundle/ruby/2.1.0/gems/charlock_holmes-0.7.3 for inspection.
Results logged to /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/vendor/bundle/ruby/2.1.0/extensions/x86_64-linux/2.1.0/charlock_holmes-0.7.3/gem_make.out
An error occurred while installing charlock_holmes (0.7.3), and Bundler cannot continue.
Make sure that `gem install charlock_holmes -v '0.7.3' --source 'https://rubygems.org/'` succeeds before bundling.
In Gemfile:
gitlab_git was resolved to 8.2.0, which depends on
github-linguist was resolved to 4.7.5, which depends on
charlock_holmes
复制代码上面已经说了要我们 brew install icu4c or apt-get install libicu-dev，这里是 macOS 和 Ubuntu 的解决办法，CentOS 的解决方法则是 yum install libicu-devel。
有些报错可能不会直接将解决办法告诉你，但是它也将原因告诉你了，比如这个报错：
Fetching rugged 0.24.0b13
Installing rugged 0.24.0b13 with native extensions
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
current directory: /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/vendor/bundle/ruby/2.1.0/gems/rugged-0.24.0b13/ext/rugged
/usr/local/rvm/rubies/ruby-2.1.8/bin/ruby -r ./siteconf20190319-2037-829l33.rb extconf.rb
checking for gmake... yes
checking for cmake... no
ERROR: CMake is required to build Rugged.
*** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers. Check the mkmf.log file for more details. You may
need configuration options.
复制代码说缺少 cmake，那我们直接 yum install cmake。
接下来还遇到两次报错，一次是 mysql2，提示 yum install mysql-devel；还有一次是 pg，说是找不到 libpq-fe.h，使用 yum provides "*/libpq-fe.h"，可以找到是 postgresql-devel，yum insall 完事。
需要注意的是，你最好一次性都安装成功，如果只安装一半，会影响 gitlab 的正常使用。最大的体现就是无法合并分支，而且拉分支的话会报 Branch creation was rejected by Git hook 这样的错。
安装 nodejs
再次执行 rails 会报错，提示没有 nodejs 运行环境：
# ./rails console
...
/opt/gitlab-8.5.1-0/apps/gitlab/htdocs/vendor/bundle/ruby/2.1.0/gems/execjs-2.6.0/lib/execjs/runtimes.rb:48:in `autodetect': Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes. (ExecJS::RuntimeUnavailable)
from /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/vendor/bundle/ruby/2.1.0/gems/execjs-2.6.0/lib/execjs.rb:5:in `'
复制代码既然没有，那就下一个呗：
wget https://nodejs.org/dist/v10.15.3/node-v10.15.3-linux-x64.tar.xz
tar xf node-v10.15.3-linux-x64.tar.xz -C /usr/local
cd /usr/local
ln -s node-v10.15.3-linux-x64/ node
ln -s `pwd`/node/bin/node /usr/bin/node
复制代码修改 postgresql 配置
再次运行 ./rails console 成功进入。但是一旦你执行命令，它会报错，连不上 postgresql：
2.1.8 :001 > User.find_by_any_email("EMAIL")
PG::ConnectionBad: could not connect to server: No such file or directory
Is the server running locally and accepting
connections on Unix domain socket "/tmp/.s.PGSQL.5432"?
复制代码默认通过 Unix 域套接字来连接数据库，但是这个套接字文件不在 /tmp 下。这个问题解决起来也简单，只需要找到现在的套接字文件，然后连接到 /tmp 目录下即可。当然，你也可以直接修改 pgsql 的配置文件，一次性解决问题。无论如何，我们都得先找到它的配置文件。
其实只要在 gitlab 的安装目录稍微找找就能够找到，我这里就直接打开了：
vim /opt/gitlab-8.5.1-0/postgresql/data/postgresql.conf
# 这行就指定了套接字的目录
unix_socket_directories = '/opt/gitlab-8.5.1-0/postgresql'
复制代码看到之后，你可能立即就 ls 这个目录了，咦，怎么啥都没有？因为这个文件是以 . 开头，你要通过 -a 参数才能看到，域套接字的格式就是 .s.PGSQL. + 端口。
找到之后，我们直接做个软连接：
ln -s /opt/gitlab-8.5.1-0/postgresql/.s.PGSQL.5432 /tmp/
复制代码继续执行 rails 命令：
# ./rails console
2.1.8 :001 > User.find_by_any_email("EMAIL")
PG::ConnectionBad: fe_sendauth: no password supplied
复制代码又 ™ 报错了，说没有指定密码。pgsql 虽然连上了，但是却没有密码，于是我赶紧看了下 rails 的使用帮助，但是并没有找到有输入密码的地方，而且我也不知道它的密码是啥。。
又仔细的看了下 rails 命令的输出，于是发现了这行：
Loading development environment (Rails 4.2.5.1)
复制代码说是加载了开发环境的配置，它竟然还有环境之分，这我也是第一次知道，毕竟对 gitlab 了解不多。于是又翻了翻 gitlab 的配置文件，找到了数据库方面的配置，我这里就直接打开了。
# vim /opt/gitlab-8.5.1-0/apps/gitlab/htdocs/config/database.yml
#
# PRODUCTION
#
production:
adapter: postgresql
encoding: unicode
database: 手动打码
pool: 10
username: 手动打码
password: 手动打码
host: 127.0.0.1
port: 5432
# port: 5432
#
# Development specific
#
development:
adapter: postgresql
encoding: unicode
database: 手动打码
pool: 5
username: 手动打码
password: 手动打码
复制代码环境挺多，这里只列出了开发和生成环境，因为我这里的开发环境的密码没有配置，所以才会出现上面没有认证的情况。解决办法就是直接使用生产环境的配置，于是看了看 rails 的用法，找到了指定生产环境的方法。
# ./rails console -e production
2.1.8 :002 > user = User.find_by_any_email("MAIL")
复制代码顺利的找到一堆结果，然后修改下用户的状态就能够将用户解锁：
2.1.8 :003 > user.state = "active"
2.1.8 :004 > user.save
2.1.8 :005 > exit
复制代码ok，文章到此结束。