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文件夾路徑