docs/docs-fp-o
21
2
Fork 14
Code Issues 6 Pull requests 1 Projects Activity Actions

Antora lacks git SHA256 support #23

New issue
Open
opened 2026-03-19 16:22:05 +00:00 by venefilyn · 1 comment
venefilyn commented 2026-03-19 16:22:05 +00:00
Member
Copy link

Trying to build the docs currently fails with cloning error for two repos in particular. Both of these are SHA256 and none of the other repos use SHA256 and instead use the default SHA1.

Opened issue upstream https://gitlab.com/antora/antora-ui-default/-/work_items/238

Workaround for now is to recreate the two repositories with SHA1.

@jflory7, both of those repos are created by you AFAICT. Can you recreate the repos using SHA1 for now? Until Antora supports it we can't utilize SHA256 repos.

❯ npx antora generate --stacktrace site.yml
[fetch] https://forge.fedoraproject.org/docs/site-frontpage.git  [#####################################################]
[fetch] ...://forge.fedoraproject.org/docs/release-docs-home.git [#####################################################]
[fetch] https://forge.fedoraproject.org/docs/install-guide.git   [#####################################################]
[fetch] https://forge.fedoraproject.org/docs/sysadmin-guide.git  [#####################################################]
[fetch] ...ora/docs/fedora-linux-documentation/release-notes.git [#####################################################]
[fetch] https://forge.fedoraproject.org/docs/quick-docs.git      [#####################################################]
[clone] https://forge.fedoraproject.org/commops/docs.git         [?????????????????????????????????????????????????????]
[16:51:14.327] FATAL (antora): Could not find 6cf85deb74b57fbf903f323ee7be27adbe7f2d214c436c3a07517766033d5147 (url: https://forge.fedoraproject.org/commops/docs.git)
    Cause: Error
        at transformGitCloneError (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:1002:22)
        at /var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:207:17
        at async loadRepository (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:197:7)
        at async gracefulPromiseAllWithLimit (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:1080:7)
        at async Promise.all (index 0)
        at async generateSite (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/site-generator/lib/generate-site.js:23:5)
        at async Command.parseAsync (/var/home/spytec/projects/docs-fp-o/node_modules/commander/lib/command.js:936:5)
    Caused by: NotFoundError: Could not find 6cf85deb74b57fbf903f323ee7be27adbe7f2d214c436c3a07517766033d5147.
        at GitRefManager.resolveAgainstMap (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:2078:11)
        at GitRefManager.resolveAgainstMap (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:2069:30)
        at _fetch (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:7835:42)
        at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
        at async _clone (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:8178:42)
        at async Object.clone (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:8301:12)
        at async loadRepository (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:197:7)
        at async gracefulPromiseAllWithLimit (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:1080:7)
        at async Promise.all (index 0)
        at async generateSite (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/site-generator/lib/generate-site.js:23:5) {
      caller: 'git.clone',
      code: 'NotFoundError',
      data: {
        what: '6cf85deb74b57fbf903f323ee7be27adbe7f2d214c436c3a07517766033d5147'
      }
    }
Trying to build the docs currently fails with cloning error for two repos in particular. Both of these are SHA256 and none of the other repos use SHA256 and instead use the default SHA1. - https://forge.fedoraproject.org/commops/docs.git - https://forge.fedoraproject.org/mentored-projects/docs.git Opened issue upstream https://gitlab.com/antora/antora-ui-default/-/work_items/238 Workaround for now is to recreate the two repositories with SHA1. @jflory7, both of those repos are created by you AFAICT. Can you recreate the repos using SHA1 for now? Until Antora supports it we can't utilize SHA256 repos. ``` ❯ npx antora generate --stacktrace site.yml [fetch] https://forge.fedoraproject.org/docs/site-frontpage.git [#####################################################] [fetch] ...://forge.fedoraproject.org/docs/release-docs-home.git [#####################################################] [fetch] https://forge.fedoraproject.org/docs/install-guide.git [#####################################################] [fetch] https://forge.fedoraproject.org/docs/sysadmin-guide.git [#####################################################] [fetch] ...ora/docs/fedora-linux-documentation/release-notes.git [#####################################################] [fetch] https://forge.fedoraproject.org/docs/quick-docs.git [#####################################################] [clone] https://forge.fedoraproject.org/commops/docs.git [?????????????????????????????????????????????????????] [16:51:14.327] FATAL (antora): Could not find 6cf85deb74b57fbf903f323ee7be27adbe7f2d214c436c3a07517766033d5147 (url: https://forge.fedoraproject.org/commops/docs.git) Cause: Error at transformGitCloneError (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:1002:22) at /var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:207:17 at async loadRepository (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:197:7) at async gracefulPromiseAllWithLimit (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:1080:7) at async Promise.all (index 0) at async generateSite (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/site-generator/lib/generate-site.js:23:5) at async Command.parseAsync (/var/home/spytec/projects/docs-fp-o/node_modules/commander/lib/command.js:936:5) Caused by: NotFoundError: Could not find 6cf85deb74b57fbf903f323ee7be27adbe7f2d214c436c3a07517766033d5147. at GitRefManager.resolveAgainstMap (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:2078:11) at GitRefManager.resolveAgainstMap (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:2069:30) at _fetch (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:7835:42) at process.processTicksAndRejections (node:internal/process/task_queues:105:5) at async _clone (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:8178:42) at async Object.clone (/var/home/spytec/projects/docs-fp-o/node_modules/isomorphic-git/index.cjs:8301:12) at async loadRepository (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:197:7) at async gracefulPromiseAllWithLimit (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/content-aggregator/lib/aggregate-content.js:1080:7) at async Promise.all (index 0) at async generateSite (/var/home/spytec/projects/docs-fp-o/node_modules/@antora/site-generator/lib/generate-site.js:23:5) { caller: 'git.clone', code: 'NotFoundError', data: { what: '6cf85deb74b57fbf903f323ee7be27adbe7f2d214c436c3a07517766033d5147' } } ```
venefilyn commented 2026-04-21 12:03:53 +00:00
Author
Member
Copy link

I forgot to note it down. Workaround is to always prefetch the sources. We need to update our README and scripts to make the workflow better with running locally (as it works on CI)

I forgot to note it down. Workaround is to always prefetch the sources. We need to update our README and scripts to make the workflow better with running locally (as it works on CI)
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
prod
stg
prod-update
No results found.
Labels
Clear labels
  
effort
high
 Will take a long time

  
effort
low
 Easy fix

  
effort
medium
 Will take some time

  
good first issue
Take this if you're new!

  
help wanted
Needs help or feedback from the wider Fedora community

  
meeting topic
Need to discuss this at a Docs team meeting

  
needs changes
Needs changes or fixes before closing

  
needs reporter feedback
Additional feedback or information from the reporter is needed to advance

  
needs review
Someone needs to look at this

  
priority
high
 Fix this NOW NOW NOW!

  
priority
low
 Low priority tasks

  
priority
medium
 Medium priority tasks

  
type/content
Changes to the contents of the site - the actual docs

  
type/misc
Changes to non-content parts of the site. CSS, Actions, scripts, etc.

No labels
effort
high
effort
low
effort
medium
good first issue
help wanted
meeting topic
needs changes
needs reporter feedback
needs review
priority
high
priority
low
priority
medium
type/content
type/misc
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
docs/docs-fp-o#23
No description provided.