如何在龙蜥 OS（AliOS）上安装极狐GitLab？

本文分享如何在龙蜥操作系统（AliOS）（包括 RHCK 和 ANCK 两种，两种方式的安装流程一样）上安装极狐GitLab？

前提条件

• 一个安装了龙蜥操作系统的云服务器

可以查看 /etc/os-release中的信息，确认操作系统信息：

NAME="Anolis OS"
VERSION="8.9"
ID="anolis"
ID_LIKE="rhel fedora centos"
VERSION_ID="8.9"
PLATFORM_ID="platform:an8"
PRETTY_NAME="Anolis OS 8.9"
ANSI_COLOR="0;31"
HOME_URL="https://openanolis.cn/"

或

NAME="Anolis OS"
VERSION="8.8"
ID="anolis"
ID_LIKE="rhel fedora centos"
VERSION_ID="8.8"
PLATFORM_ID="platform:an8"
PRETTY_NAME="Anolis OS 8.8"
ANSI_COLOR="0;31"
HOME_URL="https://openanolis.cn/"

安装流程

第一步：安装依赖

执行如下命令即可完成依赖安装：

sudo yum update
sudo yum install -y curl policycoreutils-python-utils openssh-server perl
sudo systemctl enable sshd
sudo systemctl start sshd

如果依赖安装过程中出现错误，根据错误信息进行修复即可。

第二步：下载安装包

下载适用于龙蜥操作系统的极狐GitLab 安装包，这个需要根据自身情况选择合适的极狐GitLab 版本，比如以极狐GitLab 17.7.0 为例，针对 x86_64 架构，执行如下命令即可完成下载：

curl -LOS https://packages.gitlab.cn/repository/el/8/gitlab-jh-17.7.0-jh.0.el8.x86_64.rpm

第三步：安装极狐GitLab

执行如下命令即可完成极狐GitLab 的安装：

export EXTERNAL_URL="http://gitlab.example.com" && rpm -ivh gitlab-jh-17.7.0-jh.0.el8.x86_64.rpm

安装成功后，可以查看极狐GitLab 各组件状态：

run: alertmanager: (pid 86234) 45735s; run: log: (pid 86154) 45745s
run: gitaly: (pid 72373) 60976s; run: log: (pid 72401) 60974s
run: gitlab-exporter: (pid 86207) 45737s; run: log: (pid 85959) 45763s
run: gitlab-kas: (pid 85644) 45857s; run: log: (pid 85657) 45856s
run: gitlab-workhorse: (pid 86179) 45739s; run: log: (pid 85866) 45782s
run: logrotate: (pid 138459) 3388s; run: log: (pid 72345) 60988s
run: nginx: (pid 86193) 45738s; run: log: (pid 85892) 45777s
run: node-exporter: (pid 86201) 45738s; run: log: (pid 85946) 45769s
run: postgres-exporter: (pid 86244) 45735s; run: log: (pid 86188) 45739s
run: postgresql: (pid 85481) 45863s; run: log: (pid 85533) 45861s
run: prometheus: (pid 86219) 45736s; run: log: (pid 86024) 45753s
run: puma: (pid 85779) 45796s; run: log: (pid 85786) 45795s
run: redis: (pid 72355) 60982s; run: log: (pid 72361) 60981s
run: redis-exporter: (pid 86210) 45737s; run: log: (pid 86008) 45757s
run: sidekiq: (pid 85800) 45790s; run: log: (pid 85816) 45789s

所有组件运行成功，即可用用户名 root和存储在 /etc/gitlab/initial_root_password中的初始化密码登录极狐GitLab 实例（链接为 http://gitlab.example.com）。

接着就可以体验一体化 DevOps 平台的奇妙了。

故障排查

安装过程中可能会出现如下错误：

[2025-01-17T17:12:03+08:00] FATAL: Mixlib::ShellOut::ShellCommandFailed: execute[/opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8] (postgresql::enable line 59) had an error: Mixlib::ShellOut::ShellCommandFailed: Expected process to exit with [0], but received '1'
---- Begin output of /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/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.
STDERR: initdb: error: invalid locale settings; check LANG and LC_* environment variables
---- End output of /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 ----
Ran /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 returned 1

解决方案为，在命令行中执行如下命令：

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

然后重新配置极狐GitLab 即可：

sudo gitlab-ctl reconfigure

或者在安装之前，先执行环境变量注入，再执行安装。

关于其他操作系统的安装指南，可以查看极狐GitLab 官网安装教程。