[HDDS-11570] HDDS Docs Build Fails with Hugo v0.135.0 on M1 Mac Pro

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 2.0.0, 1.4.1
• Labels: pull-request-available
• Assignee: Scolley Huang
• Reporter: Scolley Huang
• Created: 13/Oct/24 07:07
• Updated: 25/Oct/24 13:59
• Resolved: 20/Oct/24 16:15

Description

I encountered a build issue while building Ozone on an M1 Max MacBook Pro using the following command:

mvn clean install -DskipTests -Dos.arch=x86_64

Hugo version is v0.135

$ hugo version
hugo v0.135.0-f30603c47f5205e30ef83c70419f57d7eb7175ab darwin/arm64 BuildDate=2024-09-27T13:17:08Z VendorInfo=gohugoio

The Maven build fails specifically at the hadoop-hdds-docs module with the following error:

[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.4.1:exec (default) on project hdds-docs: Command execution failed.: Process exited with an error: 1 (Exit value: 1) -> [Help 1]

 

After downgrading Hugo to v0.134.3, the build succeeds.

The root cause seems to be related to the markdown front matter in certain files. For example, the following error occurred:

ERROR invalid front matter: date: 2020-October-22: see /Users/scolley/Desktop/ozone/ozone/hadoop-hdds/docs/content/feature/Quota.zh.md 

By modifying the markdown date format from:

date: 2020-October-22

to

date: 2020-10-22

the build succeeds with Hugo v0.135.0 as well.

 
 

Issue Links

• links to: GitHub Pull Request #7337