Currently, this Docker image is designed to be used as a base image on CircleCI for building, testing, and deploying Hugo based websites.
I plan to make this image useful for local testing and build/test/deploy on other CI provider as well in the future.
Using on CircleCI
Using this image to build your Hugo generated website on CircleCI can be as simple as using the following configuration in
version: 2.1 jobs: build: docker: - image: hubci/hugo:0.96.0 steps: - checkout - run: name: "Run Hugo" command: HUGO_ENV=production hugo -v -s src/ - run: name: "Test Website" command: htmlproofer src/public --allow-hash-href --check-html --empty-alt-ignore --disable-external
0.96.0 is the version of Hugo to use.
You can use a complete SemVer version number such as
0.96.0 to specifically pin to that release.
You can also use
0.96 which will use Hugo
0.96.0, and then
0.96.2, and so on as newer versions are released.
You can also use
nightly to use the in-development version.
nightly is a snapshot of whatever is in the
master branch of Hugo, which is unreleased, updated at least once a day.
edge - the edge tag is available as a testing ground for new changes to this image.
trunk will appear immediately in the
The next proper release will also include those changes unless they are removed before hand.
In this example, we assume the Hugo files are in a directory called
src in the repo. A full walkthrough on how to do this can be found on CircleCI’s blog.
Building The Images
To prepare new images, I run
./shared/gen-dockerfiles.sh locally, passing it the current Hugo versions that I am “supporting”. For example, for the initial release, I ran
That creates the Dockerfiles and the build script for them.
For actual, proper releases though, I run the
This script runs
gen-dockerfiles.sh but also does all the Git work to publish a proper release.
[release] is added to the commit message to initiate a release.
Websites Using This & Examples
The following sites use Hugo and this image (and some have their config public):
- https://www.Feliciano.Tech (repository)
- https://HugoNewsletter.com (repository)
- https://DocsThursday.com (repository)
- https://www.DiscourseHub.com (repository)
- UNICEF Open Source Inventory (repository)
- UNICEF Drones for SDGs Toolkit (repository)
Feedback & Contributing
Please feel free to open GitHub Issues for any questions, bugs, request, etc. You can also write a new post on Hugo’s forum and ping me,
FelicianoTech. Pull Request welcome as well.