写点什么

使用 Omnibus 安装极狐 GitLab

作者:极狐GitLab
  • 2021 年 11 月 24 日
  • 本文字数:2052 字

    阅读完需:约 7 分钟

使用 Omnibus 安装极狐GitLab

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


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

服务器配置


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

服务器配置

极狐 GitLab 的安装

极狐 GitLab 有针对不同系统的安装包,详细情况可以查看极狐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 安装成功显示界面

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


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

$ gitlab-ctl statusrun: alertmanager: (pid 17872) 60788s; run: log: (pid 16397) 60972srun: gitaly: (pid 14823) 61215s; run: log: (pid 14211) 61281srun: gitlab-exporter: (pid 17883) 60788s; run: log: (pid 16121) 60992srun: gitlab-workhorse: (pid 17885) 60788s; run: log: (pid 15988) 61006srun: grafana: (pid 104958) 39483s; run: log: (pid 16634) 60930srun: logrotate: (pid 253622) 3186s; run: log: (pid 14095) 61292srun: nginx: (pid 104950) 39483s; run: log: (pid 16034) 61002srun: node-exporter: (pid 17919) 60786s; run: log: (pid 16084) 60998srun: postgres-exporter: (pid 17925) 60785s; run: log: (pid 16442) 60966srun: postgresql: (pid 14450) 61276s; run: log: (pid 14480) 61275srun: prometheus: (pid 17938) 60785s; run: log: (pid 16278) 60980srun: puma: (pid 104894) 39494s; run: log: (pid 15914) 61016srun: redis: (pid 14149) 61288s; run: log: (pid 14162) 61287srun: redis-exporter: (pid 17955) 60784s; run: log: (pid 16179) 60984srun: 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'] = truenginx['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 https 登陆


SSL 还有另外一种更加方便的方法,就是直接使用 letscrypt 功能,直接在配置文件中 enable letscrypt 即可,配置如下:

external_url 'https://jh-xiaomage.gitlab.cn'letsencrypt['enable'] = trueletsencrypt['contact_emails'] = ['jhma@gitlab.cn']
复制代码

接着在浏览器中可以用 https://jh-xiaomag.gitlab.cn 来使用极狐 GitLab 实例。


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

发布于: 6 小时前阅读数: 7
用户头像

极狐GitLab

关注

开源开放,人人贡献 2021.05.19 加入

开放式一体化DevOps平台,助力行业高速协同增长!

评论

发布
暂无评论
使用 Omnibus 安装极狐GitLab