GitLab (Pages) Publish API
Monteur is a strong supporter for GitLab Pages and is currently using GitLab to manage its software publications. This recipe allows repository integrated with GitLab Pages to publish its repository's website artifact in a highly customizable manner easily and seamlessly.
The objective of distributing the recipe is simple: to make publishing to GitLab Pages carried out in a consistent manner with minimal to no further instructions.
GitLab Pages is available at: https://docs.gitlab.com/ee/user/project/pages/
All recipes are arranged based on its own semantic versioning and is not directly related to Monteur’s actual release version. Hence, feel free to explore each versions to suit your CI needs.
Due to the recipe nature of using
gh-pages branch for publications, you need
to setup that branch with a 1-time setup before use. Otherwise, the recipe shall
To begin, simply execute the following git commands to create an empty
Here are the available Publish API recipe for GitLab Pages integrations. Please read through your selected version’s details on what has changed, what is required, and how to customize and used them.
The arrangement are the latest at the top or first.
Version 1.0.0 GitLab Pages API is available for download here: gitlab-pages-v1p0p0.toml
|Supported Platforms||follows Git’s availability|
- You should download and place the recipe into your
- Once done, verify that:
FMTVariables.SourceDiris the directory holding the website artifact (e.g.
- Add any additional
[[Dependencies]]if you’re customizing the default
[[CMD]]commands list accordingly.
[[CMD]]commands list as per your need.
- Backward Compatible - Created the base TOML configuration recipe.
- Backward Compatible - Integrated with GitLab CI.
- Backward Compatible - Uses
gh-pagesfor compatibility across Github Pages and GitLab pages.
That’s all for Monteur operating on GitLab platform with GitLab Pages. If you found a bug or have any questions about the recipe, please feel free to raise your question at our Issue Section.