Commit 8442e3f0 authored by Achilleas Pipinellis's avatar Achilleas Pipinellis Committed by James Edwards-Jones

Add sections on custom domains

[ci skip]
parent 231e3a2b
...@@ -212,7 +212,7 @@ pages: ...@@ -212,7 +212,7 @@ pages:
- master - master
``` ```
### How `.gitlab-ci.yml` looks like when using a static generator #### How `.gitlab-ci.yml` looks like when using a static generator
In general, GitLab Pages support any kind of [static site generator][staticgen], In general, GitLab Pages support any kind of [static site generator][staticgen],
since the Runner can be configured to run any possible command. since the Runner can be configured to run any possible command.
...@@ -299,6 +299,9 @@ also includes `.gitlab-ci.yml`. ...@@ -299,6 +299,9 @@ also includes `.gitlab-ci.yml`.
## Next steps ## Next steps
So you have successfully deployed your website, congratulations! Let's check
what more you can do with GitLab Pages.
### Example projects ### Example projects
Below is a list of example projects for GitLab Pages with a plain HTML website Below is a list of example projects for GitLab Pages with a plain HTML website
...@@ -313,6 +316,9 @@ or various static site generators. Contributions are very welcome. ...@@ -313,6 +316,9 @@ or various static site generators. Contributions are very welcome.
- [Metalsmith](https://gitlab.com/gitlab-examples/pages-metalsmith) - [Metalsmith](https://gitlab.com/gitlab-examples/pages-metalsmith)
- [Harp](https://gitlab.com/gitlab-examples/pages-harp) - [Harp](https://gitlab.com/gitlab-examples/pages-harp)
Visit the gitlab-examples group for a full list of projects:
<https://gitlab.com/groups/gitlab-examples>.
### Add a custom domain to your Pages website ### Add a custom domain to your Pages website
If this setting is enabled by your GitLab administrator, you should be able to If this setting is enabled by your GitLab administrator, you should be able to
...@@ -322,11 +328,27 @@ see the **New Domain** button when visiting your project's **Settings > Pages**. ...@@ -322,11 +328,27 @@ see the **New Domain** button when visiting your project's **Settings > Pages**.
--- ---
You are not limited to one domain per can add multiple domains pointing to your You can add multiple domains pointing to your website hosted under GitLab.
website hosted under GitLab. Once the domain is added, you can see it listed under the **Domains** section.
![Pages multiple domains](img/pages_multiple_domains.png)
---
As a last step, you need to configure your DNS and add a CNAME pointing to your
user/group page. Click on the **Details** button of a domain for further
instructions.
![Pages DNS details](img/pages_dns_details.png)
### Secure your custom domain website with TLS ### Secure your custom domain website with TLS
When you add a new custom domain, you also have the chance to add a TLS
certificate. If this setting is enabled by your GitLab administrator, you
should be able to see the option to upload the public certificate and the
private key when adding a new domain.
![Pages upload cert](img/pages_upload_cert.png)
### Custom error codes pages ### Custom error codes pages
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment