Gitlab Pages 启用

Gitlab Pages 启用

本文目标是在一台安装了gitlab系统上的服务器上，开启Gitlab Pages服务。

Gitlab CE 系统版本：11.8.1

准备事项

1. 开放服务器端口

   Gitlab Pages 服务默认:8090

2. 准备域名

   *.xx.com，最好是一个独立的域名，不要使用Gitlab系统的域名。

   可选，若是Gitlab Pages服务想要开启https，请准备通配域名证书。

3. DNS指向

   设置 IPv4 A类型，记录为*，IP指向GitLab服务器

4. 服务器上安装gitlab-runner

gitlab page 服务配置

Gitlab 配置文件地址

/var/opt/gitlab/gitlab.rb

启用服务

gitlab_pages['enable'] = true

服务域名https模式:

1. https模式设置：

   pages_external_url "https://xxx.com/"

2. http/2模式只有在https模式下激活:

   gitlab_pages['use_http2'] = true

3. 关联域名证书：

   pages_nginx['redirect_http_to_https'] = true
   pages_nginx['ssl_certificate'] = "/opt/gitlab/ssl/crt.pem"
   pages_nginx['ssl_certificate_key'] = "/opt/gitlab/ssl/key.pem"

服务域名http模式：

pages_external_url "http://xxx.com/"

启用访问控制

不启用的话，全部gitlab page静态站点都是公开的。

gitlab_pages['access_control'] = true

启用后，会根据仓库的权限进行控制访问。

同时也会自动在gitlab系统的应用中，建立一个用于认证回调的应用，该应用会在第一次访问静态站点的时候，须要登陆，受权赞成一次。

若是系统应用中没有自动建立，手动建立一个便可。

键名	键值	说明
名称	GitLab Pages	应用名称
Redirect URI	https://projects.xx.com/auth or http://projects.xx.com/auth	对应pages服务域名

启用跳转:

gitlab_pages['redirect_http'] = true

静态网站模版

静态网站模版，请查阅官方文档，注意环境的搭建。Gitlab Pages 服务文档

注意目前paths路径不能自定义指定，只能读取public文件夹路径