极狐GitLab 的安装方式灵活多样,支持 Omnibus、Docker、Helm 安装,而且安装过程也是非常方便的,堪比“一键式”安装。极狐GitLab 安装使用教程将会对于极狐GitLab(包括 Runner)的多种安装以及使用方式进行全方位的实操演示。
本文将演示使用 Omnibus
来在 Ubuntu
上安装和配置极狐GitLab 的过程。首先需要一个服务器用来安装极狐GitLab。
服务器配置
本文所采用的服务器配置如下,建议内存最少在 4GB 以上。OS 版本可以是 Ubuntu
、Debian
以及 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 也较多,如果看到如下的内容则认为安装成功
可以看到,上述极狐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
,接着输入用户名和密码即可。
登陆之后,可以进行初始密码修改,因为 /etc/gitlab/initial_root_password
文件会在 reconfigure 之后的 24h 被删除。因此,初始登陆成功之后,建议修改密码,方法如下面的视频所示:
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
进行登陆验证。
至此,极狐GitLab 的安装和 SSL
配置就完成了,接下来就可以正常使用了。