In GitLab CI/CD pipelines, our site is currently compiled with a Docker image that contains a relatively old version of Hugo and a relatively old version of Go.
As we look to keep our versions of Go synchronised with the versions of Go used in other projects at GitLab, using an older Docker image can block MRs like: !1136, with build errors such as: https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/jobs/11026861730.
If we specify a newer version of Hugo for HUGO_VERSION_NEXT
, we can create a newer Docker images for site builds that use more up-to-date versions of Hugo and Go.
If keep also update the version of Hugo in mise.toml
, it's easier to locally validate that we're happy with the new version.
This MR also would bring our build pipeline close to the version of Go specified in: https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/blob/2200a2dd85cf145958d8c0eb73ca25245717c0aa/.gitlab-ci.yml#L22.
Pipeline validationmise
installation test: https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/jobs/11043070097.Numbered steps to set up and validate the change are strongly suggested.
Configure a local GitLab Docs environment.
Check out this branch.
Build the updated Docker image:
docker buildx build --file dockerfiles/docs-gitlab-com-builder.Dockerfile --build-arg HUGO_VERSION_NEXT="0.148.2" .
Run the updated Docker image:
docker run --rm -ti c1323cdc8de091d719a84a9ef11d50ddf6d772f88646d1cd3be2d5e4bf6d30c4 sh
Within the running container, verify an updated version of Go (go version
) and Hugo (hugo version
).
Test a local build of the site:
This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4