By using alpine, the time to pull and start the container decreases. By using the official alpine zola package, the script gets simpler. Also, this updates the zola version to the latest release.
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 testing repositories
|
||
- apk add --update-cache --repository http://dl-3.alpinelinux.org/alpine/edge/testing/ 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/).
|