GitLab Pages 配置 SSL/https

[xuxiaowei]

配置 GitLab Pages 域名的 SSL 证书，以实现开启静态页面的功能

文档

1. GitLab 页面管理
   1. GitLab 中文文档
2. GitLab 页面管理-前提条件
   1. GitLab 中文文档
3. GitLab 页面管理-自定义域名
   1. GitLab 中文文档
4. GitLab 页面管理-通配符域名
   1. GitLab 中文文档
5. https://blog.csdn.net/weixin_39926613/article/details/116840085
6. 自签名证书或自定义证书颁发机构

说明

1. 证书申请请看上文：GitLab 配置 https

2. 根据上方文档中的说明，要求如下

   1. GitLab 使用域名 http://example.com ，GitLab Pages
      使用域名 http://example.io 是可以的
   2. GitLab 使用域名 http://example.com ，GitLab Pages
      使用域名 http://gitlab.example.com 是不可以的
   3. GitLab 使用域名 http://gitlab.example.com ，GitLab Pages
      使用域名 http://gitlab.example.com 是可以的
   4. GitLab Pages 需要使用与 GitLab 不同的IP地址
      • 网络配置
        1. 固定 IP
        2. 临时增加 IP
        3. 永久增加 IP
   5. 域名
   

3. 修改 gitlab.rb 文件

   vim /etc/gitlab/gitlab.rb
   

4. 修改配置如下

   # 配置 GitLab 的域名
   # 填写你的域名
   external_url 'https://gitlab.example.com'
   
   # 对应上方域名的证书
   # 将证书放在 /etc/gitlab/ssl 文件夹中
   nginx['ssl_certificate'] = "/etc/gitlab/ssl/server.crt"
   nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/server.key"
   
   # 限制 GitLab 实例的 Nginx 监听的 IP，防止与 GitLab Pages 冲突
   nginx['listen_addresses'] = ['192.168.80.14']
   
   # 限制 GitLab Registry 的 Nginx 监听的 IP，防止与 GitLab Pages 冲突
   # GitLab 实例、GitLab Registry 可以使用相同的 IP
   # registry_nginx['listen_addresses'] = ['192.168.80.14']
   
   # http 重定向到 https
   nginx['redirect_http_to_https'] = true
   
   # 这里必须填写域名
   pages_external_url "https://pages.example.com"
   # 此处 GitLab Pages 的 IP 应该与 GitLab 的 IP 不同
   gitlab_pages['external_https'] = ['192.168.80.140:443']
   pages_nginx['enable'] = false
   
   # GitLab Pages 域名证书
   # 此处应该使用通配证书
   # 本文档中，为了方便，使用的是相同的证书
   gitlab_pages['cert'] = "/etc/gitlab/ssl/server.crt"
   gitlab_pages['cert_key'] = "/etc/gitlab/ssl/server.key"
   

5. 重新配置

   sudo gitlab-ctl reconfigure
   

6. 查看 GitLab 各服务的状态，确保都在运行，否则可能是配置错误造成的

   sudo gitlab-ctl status
   

7. 在项目的设置中，即可看到 Pages 设置菜单了