72 lines
2.7 KiB
Markdown
72 lines
2.7 KiB
Markdown
|
+++
|
|||
|
|
title = "GitLab Pages"
|
|||
|
|
weight = 40
|
|||
|
|
+++
|
|||
|
|
|
|||
|
|
We are going to use the GitLab CI runner to automatically publish the site (this CI runner is already included in your repository if you use GitLab.com).
|
|||
|
|
|
|||
|
|
## Repository setup
|
|||
|
|
|
|||
|
|
Your repository needs to be set up to be a user or group website. This means the name of the repository has to be in the correct format.
|
|||
|
|
|
|||
|
|
For example, assuming that the username is `john`, you have to create a project called `john.gitlab.io`. Your project URL will be `https://gitlab.com/john/john.gitlab.io`. Once you enable GitLab Pages for your project, your website will be published under `https://john.gitlab.io`.
|
|||
|
|
|
|||
|
|
Under your group `websites`, you created a project called `websites.gitlab.io`. Your project’s URL will be `https://gitlab.com/websites/websites.gitlab.io`. Once you enable GitLab Pages for your project, your website will be published under `https://websites.gitlab.io`.
|
|||
|
|
|
|||
|
|
|
|||
|
|
This guide assumes that your Zola project is located in the root of your repository.
|
|||
|
|
|
|||
|
|
## Ensuring that the CI runner can access your theme
|
|||
|
|
|
|||
|
|
Depending on how you added your theme, your repository may not contain it. The best way to ensure that the theme will
|
|||
|
|
be added is to use submodules. When doing this, ensure that you are using the `https` version of the URL.
|
|||
|
|
|
|||
|
|
```shell
|
|||
|
|
$ git submodule add {THEME_URL} themes/{THEME_NAME}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
For example, this could look like:
|
|||
|
|
```shell
|
|||
|
|
$ git submodule add https://github.com/getzola/hyde.git themes/hyde
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Setting up the GitLab CI/CD Runner
|
|||
|
|
|
|||
|
|
The second step is to tell the GitLab continuous integration runner how to create the GitLab page.
|
|||
|
|
|
|||
|
|
To do this, create a file called `.gitlab-ci.yml` in the root directory of your repository.
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
image: alpine:latest
|
|||
|
|
variables:
|
|||
|
|
# This variable will ensure that the CI runner pulls in your theme from the submodule
|
|||
|
|
GIT_SUBMODULE_STRATEGY: recursive
|
|||
|
|
# Specify the zola version you want to use here
|
|||
|
|
ZOLA_VERSION: "v0.12.0"
|
|||
|
|
|
|||
|
|
pages:
|
|||
|
|
script:
|
|||
|
|
# Install the zola package from the alpine community repositories
|
|||
|
|
- apk add --update-cache --repository http://dl-3.alpinelinux.org/alpine/edge/community/ zola
|
|||
|
|
# Execute zola build
|
|||
|
|
- zola build
|
|||
|
|
|
|||
|
|
artifacts:
|
|||
|
|
paths:
|
|||
|
|
# Path of our artifacts
|
|||
|
|
- public
|
|||
|
|
|
|||
|
|
# This config will only publish changes that are pushed on the master branch
|
|||
|
|
only:
|
|||
|
|
- master
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Push this new file and ... Tada! You're done! If you navigate to `settings > pages`, you should be able to see
|
|||
|
|
something like this:
|
|||
|
|
|
|||
|
|
> Congratulations! Your pages are served under:
|
|||
|
|
https://john.gitlab.io
|
|||
|
|
|
|||
|
|
More information on the process to host on GitLab pages and additional information like using a custom domain is documented
|
|||
|
|
[in this GitLab blog post](https://about.gitlab.com/2016/04/07/gitlab-pages-setup/).
|