Skip to content

ENT-8966: Replaced Jekyll with Hugo documentation builder #3448

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 34 commits into from
Jun 26, 2025
Merged

ENT-8966: Replaced Jekyll with Hugo documentation builder #3448

merged 34 commits into from
Jun 26, 2025

Conversation

aleksandrychev
Copy link
Contributor

@aleksandrychev aleksandrychev commented May 29, 2025 •
edited
Loading

@aleksandrychev aleksandrychev added the WIP work in progress label May 29, 2025
@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/54/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-54/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/74/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-74/output/_site/

@aleksandrychev
Copy link
Contributor Author

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/91/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-91/output/_site/

@aleksandrychev aleksandrychev force-pushed the ENT-8966 branch 3 times, most recently from 29fb216 to 2a9843e Compare June 13, 2025 12:01
@aleksandrychev
Copy link
Contributor Author

Build Status

Documentation: https://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-94/output/_site/

@aleksandrychev aleksandrychev changed the title WIP: ENT-8966 ENT-8966: Replaced Jekyll with Hugo documentation builder Jun 13, 2025
@aleksandrychev aleksandrychev removed the WIP work in progress label Jun 13, 2025
@olehermanse
Copy link
Member

@cf-bottom please build this in Jenkins

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/95/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-95/output/_site/

@aleksandrychev
Copy link
Contributor Author

cf-bottom didn't get NT_DOCS_REV, correct version to check is https://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-94/output/_site/. I will look how to fix it

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please, do not forget about nt-docs rev, I made changes to you recently and you should be aware about this. if not please do not trigger a job. thanks!

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/96/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-96/output/_site/

@aleksandrychev
Copy link
Contributor Author

maybe cf-bottom didn't receive update yet... will check later
image

nickanderson
nickanderson approved these changes Jun 13, 2025
View reviewed changes
nickanderson
nickanderson previously requested changes Jun 13, 2025
View reviewed changes
Copy link
Member

@nickanderson nickanderson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The preview build doesn't load

@nickanderson
Copy link
Member

@cf-bottom jenkins please, do not forget about nt-docs rev, I made changes to you recently and you should be aware about this. if not please do not trigger a job. thanks!

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/97/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-97/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/98/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-98/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@craigcomstock
Copy link
Contributor

./parallel_git_rev_fetch.sh: line 58: parallel: command not found

@craigcomstock should I install parallel in the scripts or in the jenkins-vms here https://gitlab.com/Northern.tech/CFEngine/jenkins-vms/-/blob/master/scripts/common.rb? interesting how it worked before..

No. containers are not a VM, they are a "real host". The fix is merged here: cfengine/buildscripts#1776, there is a flag file in /etc to tell the build host policy at buildscripts to install certain things for certain hosts.

@craigcomstock
Copy link
Contributor

Craig rebuilt this one:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/116/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-116/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/118/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-118/output/_site/

@aleksandrychev
Copy link
Contributor Author

I sort of expect that would come out as

hidden: true
in the rendered docs

right, I changed it. now works fine

@aleksandrychev
Removed versions and search old markdowns
6228897 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Copy redirects.conf to _site
b79a907 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/119/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-119/output/_site/

@olehermanse olehermanse removed their request for review June 25, 2025 12:52
@aleksandrychev
Copied search index into proper location
2560074 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@olehermanse
Copy link
Member

@cf-bottom jenkins

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/126/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-126/output/_site/

@aleksandrychev
Added searchUrlPrefix config
9fe5cf5 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/129/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-129/output/_site/

@aleksandrychev
Fixed versions links
9bfac3c 
Hugo makes them relative by default on the home and versions pages and we need to add ../.. prefix to point to the root of website

Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@olehermanse
Copy link
Member

@cf-bottom jenkins, please

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/131/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-131/output/_site/

@olehermanse olehermanse merged commit cc1adb3 into cfengine:master Jun 26, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@craigcomstock craigcomstock craigcomstock approved these changes

@olehermanse olehermanse olehermanse approved these changes

@nickanderson nickanderson Awaiting requested review from nickanderson

Assignees
No one assigned
Labels
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
5 participants
@aleksandrychev @cf-bottom @olehermanse @nickanderson @craigcomstock