Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
064d44c7
Commit
064d44c7
authored
Feb 22, 2017
by
Ben Bodenmiller
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
clarify custom domain details
parent
e7a64ec3
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
13 additions
and
10 deletions
+13
-10
doc/administration/pages/index.md
doc/administration/pages/index.md
+13
-10
No files found.
doc/administration/pages/index.md
View file @
064d44c7
...
@@ -26,22 +26,24 @@ it works.
...
@@ -26,22 +26,24 @@ it works.
---
---
In the case of custom domains, the Pages daemon needs to listen on ports
`80`
In the case of
[
custom domains
](
#custom-domains
)
(
but
not
and/or
`443`
. For that reason, there is some flexibility in the way which you
[
wildcard domains
](
#wildcard-domains
)
), the Pages daemon needs to listen on
can set it up:
ports
`80`
and/or
`443`
. For that reason, there is some flexibility in the way
which you can set it up:
1.
Run the
p
ages daemon in the same server as GitLab, listening on a secondary IP.
1.
Run the
P
ages daemon in the same server as GitLab, listening on a secondary IP.
1.
Run the
p
ages daemon in a separate server. In that case, the
1.
Run the
P
ages daemon in a separate server. In that case, the
[
Pages path
](
#change-storage-path
)
must also be present in the server that
[
Pages path
](
#change-storage-path
)
must also be present in the server that
the
p
ages daemon is installed, so you will have to share it via network.
the
P
ages daemon is installed, so you will have to share it via network.
1.
Run the
p
ages daemon in the same server as GitLab, listening on the same IP
1.
Run the
P
ages daemon in the same server as GitLab, listening on the same IP
but on different ports. In that case, you will have to proxy the traffic with
but on different ports. In that case, you will have to proxy the traffic with
a loadbalancer. If you choose that route note that you should use TCP load
a loadbalancer. If you choose that route note that you should use TCP load
balancing for HTTPS. If you use TLS-termination (HTTPS-load balancing) the
balancing for HTTPS. If you use TLS-termination (HTTPS-load balancing) the
pages will not be able to be served with user provided certificates. For
pages will not be able to be served with user provided certificates. For
HTTP it's OK to use HTTP or TCP load balancing.
HTTP it's OK to use HTTP or TCP load balancing.
In this document, we will proceed assuming the first option.
In this document, we will proceed assuming the first option. If you are not
supporting custom domains a secondary IP is not needed.
## Prerequisites
## Prerequisites
...
@@ -54,6 +56,7 @@ Before proceeding with the Pages configuration, you will need to:
...
@@ -54,6 +56,7 @@ Before proceeding with the Pages configuration, you will need to:
serve Pages under HTTPS.
serve Pages under HTTPS.
1.
(Optional but recommended) Enable
[
Shared runners
](
../../ci/runners/README.md
)
1.
(Optional but recommended) Enable
[
Shared runners
](
../../ci/runners/README.md
)
so that your users don't have to bring their own.
so that your users don't have to bring their own.
1.
(Only for custom domains) Have a
**secondary IP**
.
### DNS configuration
### DNS configuration
...
@@ -150,7 +153,7 @@ that without TLS certificates.
...
@@ -150,7 +153,7 @@ that without TLS certificates.
>
>
URL scheme:
`http://page.example.io`
and
`http://domain.com`
URL scheme:
`http://page.example.io`
and
`http://domain.com`
In that case, the
p
ages daemon is running, Nginx still proxies requests to
In that case, the
P
ages daemon is running, Nginx still proxies requests to
the daemon but the daemon is also able to receive requests from the outside
the daemon but the daemon is also able to receive requests from the outside
world. Custom domains are supported, but no TLS.
world. Custom domains are supported, but no TLS.
...
@@ -179,7 +182,7 @@ world. Custom domains are supported, but no TLS.
...
@@ -179,7 +182,7 @@ world. Custom domains are supported, but no TLS.
>
>
URL scheme:
`https://page.example.io`
and
`https://domain.com`
URL scheme:
`https://page.example.io`
and
`https://domain.com`
In that case, the
p
ages daemon is running, Nginx still proxies requests to
In that case, the
P
ages daemon is running, Nginx still proxies requests to
the daemon but the daemon is also able to receive requests from the outside
the daemon but the daemon is also able to receive requests from the outside
world. Custom domains and TLS are supported.
world. Custom domains and TLS are supported.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment