软件需求：
- Ruby versions
GitLab 12.2 之后，需要 Ruby (MRI) 2.6 版本。 - Go versions
Go需要1.13以上版本。 - Git versions
GitLab 11.11 之后，仅支持 Git 2.24.x 以上版本。 - Node.js versions
GitLab 12.9 之后，需要node.js 10.13.0 以上版本。建议Node 12.x，更快。 - Redis versions
需要Redis 5.0+，从GitLab 13.0开始，低版本不支持了。
硬件需求：
- 存储
存储大小取决于你需要存储在仓库的内容多少。
如果考虑存储需要平滑的增长，可以考虑LVM技术。
除了本地磁盘系统，你还可以使用网络文件系统（NFS），NAS、SAN、AWS_EBS等等。
如果内存和CPU都不错，瓶颈在磁盘寻道时间。那么高转速硬盘（7200转以上）或SSD硬盘会提升Gitlab的响应速度。
注意：
因为文件系统性能会影响 GitLab 的总体性能，我们不建议使用 AWS EFS （NFS云服务）作为存储.
CPU
CPU需求取决与用户数和期望的负载。
4 cores 最低配置，支持 500 users。
8 cores 支持 1000 users。
更多 users? 参见 reference architectures page内存
内存需求取决与用户数和期望的负载。
4GB RAM 最低配置，支持 500 users。
8GB RAM 支持 1000 users。
更多 users? 参见 reference architectures page数据库
仅支持PostgreSQL数据库。自GitLab 12.1后就不支持MySQL了。
PG需要5-10GB磁盘空间。
如下是版本建议
| GitLab version | Minimum PostgreSQL version |
|---|---|
| 10.0 | 9.6 |
| 12.10 | 11 |
| 13.0 | 11 |
GitLab database必须开启 pg_trgm 扩展。使用PostgreSQL super user 开启扩展 。
有些系统，还需要安装额外的包来支持扩展功能 (for example, postgresql-contrib) 。
GitLab Geo，Puma ，Unicorn Workers，Redis and Sidekiq，Prometheus and its exporters，GitLab Runner
参见官方文档浏览器
GitLab 13.0 (May 2020) 已经停止了对IE11的官方支持。GitLab 13.4 (September 2020) 会移除所有支持IE11的代码。
支持如下浏览器:
- Mozilla Firefox
- Google Chrome
- Chromium
- Apple Safari
- Microsoft Edge
Omnibus packages 安装 Gitlab
Install self-managed GitLab
官方强烈建议使用官方Linux包安装，更快安装、更易升级， 并且它包含了其他安装方式没有的特性来加强可靠性。强烈 建议最少 4GB 可用内存 运行Gitlab。
基于CentOS7 安装
1. 安装依赖项
关闭selinux
关闭firwalld
[root@VM_2_12_centos ~]# yum install -y curl policycoreutils-python openssh-server
安装Postfix
[root@VM_2_12_centos ~]# yum install postfix
[root@VM_2_12_centos ~]# systemctl enable postfix
[root@VM_2_12_centos ~]# systemctl start postfix
2. 配置 GitLab 仓库并安装软件
- 配置仓库
[root@VM_2_12_centos ~]# curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
[root@VM_2_12_centos ~]# yum repolist
Loaded plugins: fastestmirror, langpacks
Loading mirror speeds from cached hostfile
repo id repo name status
epel/7/x86_64 EPEL for redhat/centos 7 - x86_64 13,327
extras/7/x86_64 Qcloud centos extras - x86_64 397
gitlab_gitlab-ee/x86_64 gitlab_gitlab-ee 584
gitlab_gitlab-ee-source gitlab_gitlab-ee-source 0
os/7/x86_64 Qcloud centos os - x86_64 10,070
updates/7/x86_64 Qcloud centos updates - x86_64 759
repolist: 25,137
[root@VM_2_12_centos ~]#
- 安装gitlab-ee
说明：
官方推荐命令sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-ee
该命令在安装阶段即指定了EXTERNAL_URL变量用于配置文件。这里还指定了https，会在gitlab自带的nginx上配置证书。这里的默认设置是gitlab服务器配置公网地址、域名、https对外提供服务。如果需要使用自己的证书，前置负载均衡，建议手动配置。
这里使用腾讯云CVM+负载均衡CLB+证书。所以不带参数安装，参数手动配置。
[root@VM_2_12_centos ~]# yum install -y gitlab-ee
[root@VM_2_12_centos ~]# rpm -ql gitlab-ee-13.0.6-ee.0.el7.x86_64 |more
/opt
/opt/gitlab
... omitted ...
可以看到安装文件都部署于/opt/gitlab目录下
[root@VM_2_12_centos ~]# ls /opt/gitlab/
bin dependency_licenses.json embedded etc init LICENSE LICENSES service sv version-manifest.json version-manifest.txt
3. 配置文件
https://docs.gitlab.com/omnibus/README.html#installation-and-configuration-using-omnibus-package
配置文件 /etc/gitlab/gitlab.rb
- 外部域名
external_url "http://gitlab.example.com"
执行gitlab-ctl reconfigure使配置生效
- Git data 存储位置
默认，Omnibus GitLab 将 Git repository data 存储在 /var/opt/gitlab/git-data。
仓库作为子目录存储在该目录下。
在配置文件 /etc/gitlab/gitlab.rb 增加如下行，变更git-data目录的位置：
git_data_dirs({ "default" => { "path" => "/mnt/nas/git-data" } })
也可以添加多个 Git data 目录，配置如下：
git_data_dirs({
"default" => { "path" => "/var/opt/gitlab/git-data" },
"alternative" => { "path" => "/mnt/nas/git-data" }
})
- SMTP
官方文档列出了多个邮件服务商的配置方式
国内office365是由世纪互联运营的，配置略有变更：
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.partner.outlook.cn"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "[email protected]"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_domain'] = "yourdomain.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_openssl_verify_mode'] = 'peer'
gitlab_rails['gitlab_email_from'] = '[email protected]'
- 修改代理配置（前置负载均衡作为代理）
官方Nginx配置 Change the default proxy headers
修改访问地址：
nginx['enable'] = true
nginx['proxy_set_headers'] = {
"Host" => "$http_host_with_default",
"X-Real-IP" => "$remote_addr",
"X-Forwarded-For" => "$proxy_add_x_forwarded_for",
"X-Forwarded-Proto" => "$scheme",
"X-Forwarded-Ssl" => "on",
"Upgrade" => "$http_upgrade",
"Connection" => "$connection_upgrade"
}
- 根据配置文件进行gitlab参数配置
[root@VM_2_12_centos gitlab]# gitlab-ctl reconfigure
... omitted ...
Running handlers:
Running handlers complete
Chef Client finished, 545/1498 resources updated in 03 minutes 37 seconds
gitlab Reconfigured!
附件： 我的配置文件
[root@VM_2_12_centos gitlab]# cat gitlab.rb |grep -v '#' |sed '/^$/d' external_url 'http://gitlab.xxx.com' git_data_dirs({ "default" => { "path" => "/lvmdata/git-data" } }) gitlab_rails['smtp_enable'] = true gitlab_rails['smtp_address'] = "smtp.partner.outlook.cn" gitlab_rails['smtp_port'] = 587 gitlab_rails['smtp_user_name'] = "[email protected]" gitlab_rails['smtp_password'] = "密码不能告诉你" gitlab_rails['smtp_domain'] = "xxx.com" gitlab_rails['smtp_authentication'] = "login" gitlab_rails['smtp_enable_starttls_auto'] = true gitlab_rails['smtp_tls'] = false gitlab_rails['gitlab_email_from'] = "[email protected]" nginx['enable'] = true nginx['proxy_set_headers'] = { "Host" => "$http_host_with_default", "X-Real-IP" => "$remote_addr", "X-Forwarded-For" => "$proxy_add_x_forwarded_for", "X-Forwarded-Proto" => "$scheme", "X-Forwarded-Ssl" => "on", "Upgrade" => "$http_upgrade", "Connection" => "$connection_upgrade" }
4. 配置克隆地址：
默认使用externel_url作为克隆地址。
但是在本架构中，Gitlab仅提供http访问，https服务通过前置负载均衡提供。
那么，需要在/etc/gitlab/gitlab.rb内配置http地址，克隆地址配置为负载均衡提供的https访问地址。
克隆地址配置文件/opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml。
在/etc/gitlab/gitlab.rb初始化后，再手动配置。
手动修改克隆地址后，不能再执行 gitlab-ctl reconfigure。gitlab-ctl reconfigure会使用 /etc/gitlab/gitlab.rb覆盖所有配置。
或者执行gitlab-ctl reconfigure后，再手动配置下也行
修改配置文件/opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml：
## GitLab settings
gitlab:
## Web server settings (note: host is the FQDN, do not include http://)
host: git.wodedizhi.com
port: 443
https: true
4. 启动服务
在使用 gitlab-ctl reconfigure命令初始化配置的时候，创建了gitlab-runsvdir.service
可以使用如下命令启动/停止服务
[root@VM_2_12_centos ~]# systemctl status gitlab-runsvdir.service
[root@VM_2_12_centos ~]# systemctl stop gitlab-runsvdir.service
查看服务状态
[root@VM_2_12_centos ~]# gitlab-ctl status
run: alertmanager: (pid 16432) 560s; run: log: (pid 15884) 636s
run: gitaly: (pid 16349) 563s; run: log: (pid 15114) 754s
run: gitlab-exporter: (pid 16356) 563s; run: log: (pid 15762) 654s
run: gitlab-workhorse: (pid 16322) 563s; run: log: (pid 15617) 678s
run: grafana: (pid 16488) 559s; run: log: (pid 16256) 580s
run: logrotate: (pid 15661) 669s; run: log: (pid 15677) 666s
run: nginx: (pid 15631) 675s; run: log: (pid 15647) 674s
run: node-exporter: (pid 16336) 563s; run: log: (pid 15720) 660s
run: postgres-exporter: (pid 16481) 560s; run: log: (pid 15939) 631s
run: postgresql: (pid 15236) 749s; run: log: (pid 15286) 748s
run: prometheus: (pid 16369) 562s; run: log: (pid 15830) 643s
run: puma: (pid 15516) 693s; run: log: (pid 15537) 690s
run: redis: (pid 15048) 761s; run: log: (pid 15068) 760s
run: redis-exporter: (pid 16359) 562s; run: log: (pid 15795) 648s
run: sidekiq: (pid 15545) 687s; run: log: (pid 15561) 684s
5. 初始化登录配置
第一次登陆，会重定向到重设密码页面。输入初始管理员密码，然后会返回到登陆页面。默认账户root。
See our documentation for detailed instructions on installing and configuration.
6. Set up your communication preferences
7. Configure sign-up restrictions and sign-in preferences.
After completing your installation, consider the recommended practices to secure your GitLab instance.