环境
系统：Ubuntu 20.04.1 x64
gitlab 版本：14-1-stable
本来打算通过源码安装，看了教程之后，果断放弃，太复杂了，且中间容易出错，所以选择使用安装包来安装。
安装步骤
1、下载安装包
gitlab 官网寻找适合自己系统的安装包：https://packages.gitlab.com/gitlab/gitlab-ce，由于我的服务器系统是 ubuntu，所以我选择了如下的安装包下载：
下载命令点击进去右边都有，如图所示：
由于我是直接在服务器上下载，所以选择 wget 方式下载，下载的命令:
wget --content-disposition https://packages.gitlab.com/gitlab/gitlab-ce/packages/ubuntu/focal/gitlab-ce_14.0.6-ce.0_amd64.deb/download.deb
复制代码
2、安装包完整性校验
下载完成后，校验文件的完整性，与官网上的 md5 进行比较，服务器下计算文件 md5 的命令为：
md5sum gitlab-ce_14.0.6-ce.0_amd64.deb
复制代码
输出为：
544856bf0d857b335d00ce6ba0604b75 gitlab-ce_14.0.6-ce.0_amd64.deb
与官网的文件 md5 进行对比，相同即可。
3、安装 gitlab
使用离线安装包安装，不需要联网直接安装即可，由于我的服务器是 ubuntu 系统，安装包是 deb 宝，需要使用 dpkg 命令运行安装（dpkg 需要用到超级权限），我在安装 gitlab 的时候已经使用 sudo 命令切换到超级用户下，安装命令如下：
dpkg -i gitlab-ce_14.0.6-ce.0_amd64.deb
复制代码
4、安装成功
出现以下界面，表示安装成功！
5、配置修改
安装完成后，我们就可以开始使用了，但所有的配置都是默认的，我们需要将 git-data 目录改到更大的磁盘目录下，且同时需要把 postgresql 的数据及账号密码等信息进行修改。
gitlab 配置文件的位置在：/etc/gitlab/gitlab.rb
1、修改 git-data 的存储目录
打开/etc/gitlab/gitlab.rb 文件，全局搜索 git_data_dirs，找到取消注释，并将默认路径改为自己要设置的磁盘即可，我的配置如下：
2、修改 postgresql 的数据存储目录
打开/etc/gitlab/gitlab.rb 文件，全局搜索 postgresql，找到取消注释，改成自己要设置的目录即可，我的配置如下：
安装过程中的问题
1、STDERR: initdb: error: encoding mismatch
详细错误日志如下：
Running handlers:There was an error running gitlab-ctl reconfigure:
execute[/opt/gitlab/embedded/bin/initdb -D /data/postgresql/data -E UTF8] (postgresql::enable line 49) had an error: Mixlib::ShellOut::ShellCommandFailed: Expected process to exit with [0], but received '1'---- Begin output of /opt/gitlab/embedded/bin/initdb -D /data/postgresql/data -E UTF8 ----STDOUT: The files belonging to this database system will be owned by user "gitlab-psql".This user must also own the server process.
The database cluster will be initialized with locale "en_US".STDERR: initdb: error: encoding mismatchThe encoding you selected (UTF8) and the encoding that theselected locale uses (LATIN1) do not match. This would lead tomisbehavior in various character string processing functions.Rerun initdb and either do not specify an encoding explicitly,or choose a matching combination.---- End output of /opt/gitlab/embedded/bin/initdb -D /data/postgresql/data -E UTF8 ----Ran /opt/gitlab/embedded/bin/initdb -D /data/postgresql/data -E UTF8 returned 1
Warnings:Environment variable LANG specifies a non-UTF-8 locale. GitLab requires UTF-8 encoding to function properly. Please check your locale settings.
Notes:Default admin account has been configured with following details:Username: rootPassword: You didn't opt-in to print initial root password to STDOUT.Password stored to /etc/gitlab/initial_root_password. This file will be cleaned up in first reconfigure run after 24 hours.
NOTE: Because these credentials might be present in your log files in plain text, it is highly recommended to reset the password following https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.
复制代码
解决方案：
1、执行命令：dpkg-reconfigure locales，选择 en_US.UTF-8，然后看是否可以，如果不行，按照步骤 2 尝试；
2、执行命令查看当前的配置：export | grep LANG，然后执行下列命令修改：
declare -x LANG="en_US.UTF-8"
复制代码
2、配置 nginx gzip 报错
报错详情
Running handlers:There was an error running gitlab-ctl reconfigure:
Removed configurations found in gitlab.rb. Aborting reconfigure.
Removals:* nginx['gzip'] has been deprecated since 13.12 and was removed in 14.0. The config has been deprecated. Value for this directive in NGINX configuration will be controlled by `nginx['gzip_enabled']` setting in `/etc/gitlab/gitlab.rb`.
Running handlers completeChef Infra Client failed. 0 resources updated in 05 seconds
复制代码
解决方案：
1、将配置修改为：nginx['gzip_enabled']='on' 即可。
参考链接
1、gitlab 源码：https://gitlab.com/gitlab-org/gitlab-foss/-/tree/14-1-stable
2、如何搭建 gitlab 服务器--使用离线安装包部署：https://zhuanlan.zhihu.com/p/338882906
3、STDERR: initdb: error: encoding mismatch 错误解决：https://forum.gitlab.com/t/installation-errors/42730
评论