Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
李少辉-开发者
gitlab-foss
提交
58cf7db1
G
gitlab-foss
项目概览
李少辉-开发者
/
gitlab-foss
通知
15
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
G
gitlab-foss
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
58cf7db1
编写于
2月 16, 2017
作者:
A
Achilleas Pipinellis
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Simplify Pages admin Omnibus docs
[ci skip]
上级
58cc360a
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
88 addition
and
65 deletion
+88
-65
doc/administration/pages/index.md
doc/administration/pages/index.md
+88
-65
未找到文件。
doc/administration/pages/index.md
浏览文件 @
58cf7db1
# GitLab Pages
A
dministration
# GitLab Pages
a
dministration
> **Notes:**
-
[
Introduced
][
ee-80
]
in GitLab EE 8.3.
...
...
@@ -6,6 +6,7 @@
-
GitLab Pages
[
were ported
][
ce-14605
]
to Community Edition in GitLab 8.17.
-
This guide is for Omnibus GitLab installations. If you have installed
GitLab from source, follow the
[
Pages source installation document
](
source.md
)
.
-
To learn how to use GitLab Pages, read the
[
user documentation
][
pages-userguide
]
.
---
...
...
@@ -14,9 +15,6 @@ sure to read the [changelog](#changelog) if you are upgrading to a new GitLab
version as it may include new features and changes needed to be made in your
configuration.
If you are looking for ways to upload your static content in GitLab Pages, you
probably want to read the
[
user documentation
][
pages-userguide
]
.
## Overview
GitLab Pages makes use of the [GitLab Pages daemon], a simple HTTP server
...
...
@@ -32,7 +30,7 @@ In the case of custom domains, the Pages daemon needs to listen on ports `80`
and/or
`443`
. For that reason, there is some flexibility in the way which you
can set it up:
1.
Run the pages daemon in the same server as GitLab, listening on a secondary IP
1.
Run the pages daemon in the same server as GitLab, listening on a secondary IP
.
1.
Run the pages daemon in a separate server. In that case, the
[
Pages path
](
#change-storage-path
)
must also be present in the server that
the pages daemon is installed, so you will have to share it via network.
...
...
@@ -64,11 +62,11 @@ you need to add a [wildcard DNS A record][wiki-wildcard-dns] pointing to the
host that GitLab runs. For example, an entry would look like this:
```
*.example.io. 1800 IN A 1.
2.3.4
*.example.io. 1800 IN A 1.
1.1.1
```
where
`example.io`
is the domain under which GitLab Pages will be served
and
`1.
2.3.4
`
is the IP address of your GitLab instance.
and
`1.
1.1.1
`
is the IP address of your GitLab instance.
> **Note:**
You should not use the GitLab domain to serve user pages. For more information
...
...
@@ -78,101 +76,126 @@ see the [security section](#security).
## Configuration
Depending on your needs, you can install GitLab Pages in four different ways.
Depending on your needs, you can set up GitLab Pages in 4 different ways.
The following options are listed from the easiest setup to the most
advanced one. The absolute minimum requirement is to set up the wildcard DNS
since that is needed in all configurations.
###
Option 1. Custom domains with HTTPS support
###
Wildcard domains
| URL scheme | Wildcard certificate | Custom domain with HTTP support | Custom domain with HTTPS support | Secondary IP |
| --- |:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
`https://page.example.io`
and
`https://page.com`
| yes | redirects to HTTPS | yes | yes |
>**Requirements:**
-
[
Wildcard DNS setup
](
#dns-configuration
)
>
>---
>
URL scheme:
`http://page.example.io`
Pages enabled, daemon is enabled AND pages has external IP support enabled.
In that case, the pages daemon is running, NGINX still proxies requests to
the daemon but the daemon is also able to receive requests from the outside
world. Custom domains and TLS are supported.
This is the minimum setup that you can use Pages with. It is the base for all
other setups as described below. Nginx will proxy all requests to the daemon.
The Pages daemon doesn't listen to the outside world.
1.
Edit
`/etc/gitlab/gitlab.rb`
:
1.
Set the external URL for GitLab Pages in
`/etc/gitlab/gitlab.rb`
:
```ruby
pages_external_url "https://example.io"
nginx['listen_addresses'] = ['1.1.1.1']
pages_nginx['enable'] = false
gitlab_pages['cert'] = "/etc/gitlab/ssl/example.io.crt"
gitlab_pages['cert_key'] = "/etc/gitlab/ssl/example.io.key"
gitlab_pages['external_http'] = '1.1.1.2:80'
gitlab_pages['external_https'] = '1.1.1.2:443'
pages_external_url 'http://example.io'
```
where `1.1.1.1` is the primary IP address that GitLab is listening to and
`1.1.1.2` the secondary IP where the GitLab Pages daemon listens to.
1.
[
Reconfigure GitLab
][
reconfigure
]
###
Option 2. Custom domains without HTTP
S support
###
Wildcard domains with TL
S support
| URL scheme | Wildcard certificate | Custom domain with HTTP support | Custom domain with HTTPS support | Secondary IP |
| --- |:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
`http://page.example.io`
and
`http://page.com`
| no | yes | no | yes |
>**Requirements:**
-
[
Wildcard DNS setup
](
#dns-configuration
)
-
Wildcard TLS certificate
>
>---
>
URL scheme:
`https://page.example.io`
Pages enabled, daemon is enabled AND pages has external IP support enabled.
In that case, the pages daemon is running, NGINX still proxies requests to
the daemon but the daemon is also able to receive requests from the outside
world. Custom domains and TLS are supported.
Nginx will proxy all requests to the daemon. Pages daemon doesn't listen to the
outside world.
1.
Edit
`/etc/gitlab/gitlab.rb`
:
1.
Place the certificate and key inside
`/etc/gitlab/ssl`
1.
In
`/etc/gitlab/gitlab.rb`
specify the following configuration:
```ruby
pages_external_url "http://example.io"
nginx['listen_addresses'] = ['1.1.1.1']
pages_nginx['enable'] = false
gitlab_pages['external_http'] = '1.1.1.2:80'
pages_external_url 'https://example.io'
pages_nginx['redirect_http_to_https'] = true
pages_nginx['ssl_certificate'] = "/etc/gitlab/ssl/pages-nginx.crt"
pages_nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/pages-nginx.key"
```
where `
1.1.1.1` is the primary IP address that GitLab is listening to and
`1.1.1.2` the secondary IP where the GitLab Pages daemon listens to
.
where `
pages-nginx.crt` and `pages-nginx.key` are the SSL cert and key,
respectively
.
1.
[
Reconfigure GitLab
][
reconfigure
]
##
# Option 3. Wildcard HTTPS domain without custom domains
##
Advanced configuration
| URL scheme | Wildcard certificate | Custom domain with HTTP support | Custom domain with HTTPS support | Secondary IP |
| --- |:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
`https://page.example.io`
| yes | no | no | no |
In addition to the wildcard domains, you can also have the option to configure
GitLab Pages to work with custom domains. Again, there are two options here:
support custom domains with and without TLS certificates. The easiest setup is
that without TLS certificates.
Pages enabled, daemon is enabled and NGINX will proxy all requests to the
daemon. Pages daemon doesn't listen to the outside world.
### Custom domains
1.
Place the certificate and key inside
`/etc/gitlab/ssl`
1.
In
`/etc/gitlab/gitlab.rb`
specify the following configuration:
>**Requirements:**
-
[
Wildcard DNS setup
](
#dns-configuration
)
-
Secondary IP
>
---
>
URL scheme:
`http://page.example.io`
and
`http://domain.com`
```ruby
pages_external_url 'https://example.io'
In that case, the pages daemon is running, Nginx still proxies requests to
the daemon but the daemon is also able to receive requests from the outside
world. Custom domains are supported, but no TLS.
pages_nginx['redirect_http_to_https'] = true
pages_nginx['ssl_certificate'] = "/etc/gitlab/ssl/pages-nginx.crt"
pages_nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/pages-nginx.key"
1.
Edit
`/etc/gitlab/gitlab.rb`
:
```ruby
pages_external_url "http://example.io"
nginx['listen_addresses'] = ['1.1.1.1']
pages_nginx['enable'] = false
gitlab_pages['external_http'] = '1.1.1.2:80'
```
where `
pages-nginx.crt` and `pages-nginx.key` are the SSL cert and key,
respectively
.
where `
1.1.1.1` is the primary IP address that GitLab is listening to and
`1.1.1.2` the secondary IP where the GitLab Pages daemon listens to
.
1.
[
Reconfigure GitLab
][
reconfigure
]
###
Option 4. Wildcard HTTP domain without custom domains
###
Custom domains with TLS support
| URL scheme | Wildcard certificate | Custom domain with HTTP support | Custom domain with HTTPS support | Secondary IP |
| --- |:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
`http://page.example.io`
| no | no | no | no |
>**Requirements:**
-
[
Wildcard DNS setup
](
#dns-configuration
)
-
Wildcard TLS certificate
-
Secondary IP
>
---
>
URL scheme:
`https://page.example.io`
and
`https://domain.com`
Pages enabled, daemon is enabled and NGINX will proxy all requests to the
daemon. Pages daemon doesn't listen to the outside world.
In that case, the pages daemon is running, Nginx still proxies requests to
the daemon but the daemon is also able to receive requests from the outside
world. Custom domains and TLS are supported.
1.
Set the external URL for GitLab Pages in
`/etc/gitlab/gitlab.rb`
:
1.
Edit
`/etc/gitlab/gitlab.rb`
:
```ruby
pages_external_url 'http://example.io'
pages_external_url "https://example.io"
nginx['listen_addresses'] = ['1.1.1.1']
pages_nginx['enable'] = false
gitlab_pages['cert'] = "/etc/gitlab/ssl/example.io.crt"
gitlab_pages['cert_key'] = "/etc/gitlab/ssl/example.io.key"
gitlab_pages['external_http'] = '1.1.1.2:80'
gitlab_pages['external_https'] = '1.1.1.2:443'
```
where `1.1.1.1` is the primary IP address that GitLab is listening to and
`1.1.1.2` the secondary IP where the GitLab Pages daemon listens to.
1.
[
Reconfigure GitLab
][
reconfigure
]
## Change storage path
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录