极狐GitLab 的安装方式灵活多样,支持 Omnibus、Docker、Helm 安装,而且安装过程也是非常方便的,堪比“一键式”安装。极狐GitLab 安装使用教程将会对于极狐GitLab(包括 Runner)的多种安装以及使用方式进行全方位的实操演示。

本文将演示使用 Omnibus 来在 Ubuntu 上安装和配置极狐GitLab 的过程。首先需要一个服务器用来安装极狐GitLab。

服务器配置

本文所采用的服务器配置如下,建议内存最少在 4GB 以上。OS 版本可以是 UbuntuDebian 以及 CentOS,本文先用 Ubuntu,其他系统的会在后续文章演示。

OS Version CPU RAM
Ubuntu 20.04 LTS 4 core 8 GB

安装

极狐GitLab 有针对不同系统的安装包,详细情况可以查看官网安装章节。本文以 Ubuntu 20.04 来演示极狐GitLab 的安装。

安装和配置必须的依赖项

执行如下命令完成依赖项的安装和配置

$ apt-get update
$ apt-get install -y curl openssh-server ca-certificates tzdata perl

下载极狐GitLab 安装包

找到自己想要安装的版本,直接下载安装包,比如要下载针对 Ubuntu 20.04 的安装包,执行如下命令即可完成下载:

$ wget https://omnibus.gitlab.cn/ubuntu/focal/gitlab-jh_14.5.0-jh.0_amd64.deb

安装极狐GitLab 安装包

执行如下命令即可完成极狐GitLab 的一键式安装,如果是初次安装,建议将极狐GitLab 实例的域名以环境变量的形式注入(比如export EXTERNAL_URL=jh-xiaomage.gitlab.cn),接着执行如下命令开始安装:

$ dpkg -i gitlab-jh_14.4.2-jh.0_amd64.deb

整个安装需要持续几分钟,输出的 log 也较多,如果看到如下的内容则认为安装成功

install-succ

可以看到,上述极狐GitLab 实例的登陆地址为:http://jh-xiaomage.gitlab.cn

安装完毕,可以看一下极狐GitLab 所有组件的状态,查看命令为 gitlab-ctl status

$ gitlab-ctl status
run: alertmanager: (pid 17872) 60788s; run: log: (pid 16397) 60972s
run: gitaly: (pid 14823) 61215s; run: log: (pid 14211) 61281s
run: gitlab-exporter: (pid 17883) 60788s; run: log: (pid 16121) 60992s
run: gitlab-workhorse: (pid 17885) 60788s; run: log: (pid 15988) 61006s
run: grafana: (pid 104958) 39483s; run: log: (pid 16634) 60930s
run: logrotate: (pid 253622) 3186s; run: log: (pid 14095) 61292s
run: nginx: (pid 104950) 39483s; run: log: (pid 16034) 61002s
run: node-exporter: (pid 17919) 60786s; run: log: (pid 16084) 60998s
run: postgres-exporter: (pid 17925) 60785s; run: log: (pid 16442) 60966s
run: postgresql: (pid 14450) 61276s; run: log: (pid 14480) 61275s
run: prometheus: (pid 17938) 60785s; run: log: (pid 16278) 60980s
run: puma: (pid 104894) 39494s; run: log: (pid 15914) 61016s
run: redis: (pid 14149) 61288s; run: log: (pid 14162) 61287s
run: redis-exporter: (pid 17955) 60784s; run: log: (pid 16179) 60984s
run: sidekiq: (pid 104859) 39501s; run: log: (pid 15940) 61012s

可以看到相关组件的状态以及进程信息。

登陆

可以用初始用户名和密码来进行登陆。初始用户名为 root,密码被存在了 /etc/gitlab/initial_root_password 文件中,直接获取即可。然后在浏览器中输入 http://jh-xiaomage.gitlab.cn,接着输入用户名和密码即可。

initial-login

登陆之后,可以进行初始密码修改,因为 /etc/gitlab/initial_root_password 文件会在 reconfigure 之后的 24h 被删除。因此,初始登陆成功之后,建议修改密码,方法如下面的视频所示:

change-initial-password

SSL 配置

上述安装完毕,登陆是用的 http,这是一种不安全的登陆方式,最好配置为 https 登陆,也就是需要配置 SSL。极狐GitLab 配置 SSL 有好几种方式,最简便的就是通过 nginx 来配置,因为极狐GitLab 安装的时候,安装了 nginx,只需要简单配置即可。

生成 ssl 证书

/etc/gitlab/ 目录下新建一个 ssl 文件夹,然后执行如下命令生成 ssl 证书

$ openssl genrsa -out ca.key 2048
$ openssl req -x509 -new -nodes -key ca.key -subj "/CN=jh-xiaomage.gitlab.cn" -days 10000 -out ca.crt

CN 配置为极狐GitLab 实例的域名名称,本文例子为 jh-xiaomage.gitlab.cn

配置 nginx

/etc/gitlab/gitlab.rb 文件中进行 nginx 配置修改:

nginx['enable'] = true
nginx['ssl_certificate'] = "/etc/gitlab/ssl/ca.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/ca.key"
nginx['ssl_protocols'] = "TLSv1.2 TLSv1.3"

上述基本配置完毕,然后执行 gitlab-ctl reconfigure 命令,让配置生效即可,然后用 https://jh-xiaomage.gitlab.cn 进行登陆验证。

https-login

至此,极狐GitLab 的安装和 SSL 配置就完成了,接下来就可以正常使用了。

60天免费试用极狐GitLab专业版

极狐GitLab不仅是源代码管理或CI/CD工具,它是一个覆盖完整软件开发生命周期和DevOps的开放式一体化平台。

企业版试用
售前咨询
联系电话
在线支持
预约演示