Error while running cloned website on local machine about website HOT 9 CLOSED

This issue is currently awaiting triage.

SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

from website.

/kind support

from website.

I tried to analyze a bit. On first investigation, it seems like a valid issue. However, I do not know the root cause.

I created a new Ubuntu VM, and tried to setup k/w from scratch.

npm version: 10.2.4
go version: go1.22.1 linux/arm64
hugo version: hugo v0.124.1-db083b05f16c945fec04f745f0ca8640560cf1ec+extended linux/arm64 BuildDate=2024-03-20T11:40:10Z VendorInfo=snap:0.124.1
Docker Engine version: 26.0.0

On running make serve, the hugo command was stuck at:

Start building sites … 
hugo v0.124.1-db083b05f16c945fec04f745f0ca8640560cf1ec+extended linux/arm64 BuildDate=2024-03-20T11:40:10Z VendorInfo=snap:0.124.1

I then executed hugo -v --debug -D and managed to reproduce the issue you reported. (Note that at times this command gets stuck without an output as well).

ERROR [fr] Glossary Bundle not found for language. Create at least an index.md file inside docs/reference/glossary
ERROR [fr] No glossary items found
ERROR [fr] "/docs/concepts/overview/components": "kube-apiserver" is not a valid glossary term_id, see ./docs/reference/glossary/* for a full list
INFO  build:  step render pages 2897 content 6269 duration 23.51889686s
INFO  build:  step postProcess duration 12.459µs
INFO  build:  duration 26.870210574s
Total in 26951 ms
Error: error building site: render: failed to render pages: render of "page" failed: "/home/ubuntu/website/layouts/docs/single.html:3:7": execute of template failed: template: docs/single.html:3:7: executing "main" at <partial "docs/content-page" (dict "ctx" . "page" .)>: error calling partial: "/home/ubuntu/website/layouts/partials/docs/content-page.html:6:8": execute of template failed: template: partials/docs/content-page.html:6:8: executing "partials/docs/content-page.html" at <.page.Content>: error calling Content: "/home/ubuntu/website/content/fr/docs/concepts/overview/components.md:29:1": failed to render shortcode "glossary_definition": failed to process shortcode: "/home/ubuntu/website/layouts/shortcodes/glossary_definition.html:18:19": execute of template failed: template: shortcodes/glossary_definition.html:18:19: executing "shortcodes/glossary_definition.html" at <$term_info.Content>: nil pointer evaluating resource.Resource.Content

On my local machine, I have older versions of npm, hugo, go and docker and k/w builds fine.

npm version: 10.2.3
go version: go version go1.21.5 darwin/arm64
hugo version: hugo v0.120.4-f11bca5fec2ebb3a02727fb2a5cfb08da96fd9df+extended darwin/arm64 BuildDate=2023-11-08T11:18:07Z VendorInfo=brew
Docker Engine version: 25.0.3

It could be related to one of the upgrades in the dependencies (most probably Hugo), however I cannot state for certain.

from website.

I tried to analyze a bit. On first investigation, it seems like a valid issue. However, I do not know the root cause.

I created a new Ubuntu VM, and tried to setup k/w from scratch.

npm version: 10.2.4
go version: go1.22.1 linux/arm64
hugo version: hugo v0.124.1-db083b05f16c945fec04f745f0ca8640560cf1ec+extended linux/arm64 BuildDate=2024-03-20T11:40:10Z VendorInfo=snap:0.124.1
Docker Engine version: 26.0.0

On running make serve, the hugo command was stuck at:

Start building sites … 
hugo v0.124.1-db083b05f16c945fec04f745f0ca8640560cf1ec+extended linux/arm64 BuildDate=2024-03-20T11:40:10Z VendorInfo=snap:0.124.1

I then executed hugo -v --debug -D and managed to reproduce the issue you reported. (Note that at times this command gets stuck without an output as well).

ERROR [fr] Glossary Bundle not found for language. Create at least an index.md file inside docs/reference/glossary
ERROR [fr] No glossary items found
ERROR [fr] "/docs/concepts/overview/components": "kube-apiserver" is not a valid glossary term_id, see ./docs/reference/glossary/* for a full list
INFO  build:  step render pages 2897 content 6269 duration 23.51889686s
INFO  build:  step postProcess duration 12.459µs
INFO  build:  duration 26.870210574s
Total in 26951 ms
Error: error building site: render: failed to render pages: render of "page" failed: "/home/ubuntu/website/layouts/docs/single.html:3:7": execute of template failed: template: docs/single.html:3:7: executing "main" at <partial "docs/content-page" (dict "ctx" . "page" .)>: error calling partial: "/home/ubuntu/website/layouts/partials/docs/content-page.html:6:8": execute of template failed: template: partials/docs/content-page.html:6:8: executing "partials/docs/content-page.html" at <.page.Content>: error calling Content: "/home/ubuntu/website/content/fr/docs/concepts/overview/components.md:29:1": failed to render shortcode "glossary_definition": failed to process shortcode: "/home/ubuntu/website/layouts/shortcodes/glossary_definition.html:18:19": execute of template failed: template: shortcodes/glossary_definition.html:18:19: executing "shortcodes/glossary_definition.html" at <$term_info.Content>: nil pointer evaluating resource.Resource.Content

On my local machine, I have older versions of npm, hugo, go and docker and k/w builds fine.

npm version: 10.2.3
go version: go version go1.21.5 darwin/arm64
hugo version: hugo v0.120.4-f11bca5fec2ebb3a02727fb2a5cfb08da96fd9df+extended darwin/arm64 BuildDate=2023-11-08T11:18:07Z VendorInfo=brew
Docker Engine version: 25.0.3

It could be related to one of the upgrades in the dependencies (most probably Hugo), however I cannot state for certain.

The issue is in the Hugo version. Upon changing the version, it worked perfectly. Thanks for your input. I think this issue should be raised.

from website.

@arujjval Can you please mention the exact combination of versions (npm, Hugo, go, docker) that worked for you?

from website.

@adityasamant25 here, it is
npm version: 10.2.4
go version go1.22.1 linux/amd64
hugo v0.121.2-6d5b44305eaa9d0a157946492a6f319da38de154+extended linux/amd64 BuildDate=2024-01-05T12:21:15Z VendorInfo=gohugoio
Docker version: 25.0.2
but I think the issue is with Hugo's version only.

from website.

Try make container-serve whilst you have the latest main branch checked out. That works for me.

You should find that you're using Hugo 0.121.2 (see netlify.toml).

If you want to test a Hugo upgrade, run make container-image before make container-serve.

from website.

The instruction to install a specific Hugo extended version as defined in netlify.toml is mentioned in the Running the website locally using Hugo section.

However, I believe it would be helpful to move the instruction to the Prerequisites section. This would prevent readers from inadvertently installing the latest Hugo extended version (currently v0.124.1) which is incompatible with k/w.

I'll try to work on a PR for this.

from website.

/assign

from website.