Fix swh-docs builds (publish and dev)
Closed, MigratedEdits Locked
Actions

Assigned To

Authored By

	ardumont
	Oct 18 2021, 9:41 AM

Description

The docs publish and dev job are broken. The gist of it is [1]. The full stack trace
is [2]. plantuml version: 1.2021.12 [3].

This needs some fixing.

[1]

make[3]: Entering directory '/home/jenkins/workspace/DDOC/publish/swh-fuse/docs/images'
plantuml -Tpdf arch-container.puml
java.lang.ClassNotFoundException: org.apache.batik.apps.rasterizer.SVGConverter

[2] https://jenkins.softwareheritage.org/view/all/job/DDOC/job/publish/1136/console https://jenkins.softwareheritage.org/view/swh-draft/job/DDOC/job/dev/6845/console

[3] https://forge.softwareheritage.org/source/swh-jenkins-dockerfiles/browse/master/sphinx/Dockerfile$5

Revisions and Commits

rDFUSE FUSE virtual file system
	D6493	rDFUSEa300deca15eb docs/images/Makefile: Drop unused pdf generation from the build

Related Objects

Mentioned Here: T3407: Upgrade sphinx docker image to use a more recent version of plantuml

Event Timeline

ardumont triaged this task as Normal priority.Oct 18 2021, 9:41 AM

ardumont created this task.

ardumont added a project: Documentation.

fwiw, reproduced locally:

$ cd swh-fuse && git pull && cd docs/images
$ plantuml -version | head -1
PlantUML version 1.2021.9 (Sun Jul 25 12:13:56 CEST 2021)
$ plantuml -Tpdf arch-context.puml
java.lang.ClassNotFoundException: org.apache.batik.apps.rasterizer.SVGConverter
        at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:636)
        at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:182)
        at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:519)
        at java.base/java.lang.Class.forName0(Native Method)
        at java.base/java.lang.Class.forName(Class.java:375)
        at net.sourceforge.plantuml.pdf.PdfConverter.convert(PdfConverter.java:57)
        at net.sourceforge.plantuml.UmlDiagram.exportDiagramInternalPdf(UmlDiagram.java:288)
        at net.sourceforge.plantuml.UmlDiagram.exportDiagramNow(UmlDiagram.java:140)
        at net.sourceforge.plantuml.AbstractPSystem.exportDiagram(AbstractPSystem.java:157)
        at net.sourceforge.plantuml.PSystemUtils.exportDiagramsCuca(PSystemUtils.java:233)
        at net.sourceforge.plantuml.PSystemUtils.exportDiagrams(PSystemUtils.java:89)
        at net.sourceforge.plantuml.SourceFileReaderAbstract.getGeneratedImages(SourceFileReaderAbstract.java:171)
        at net.sourceforge.plantuml.Run.manageFileInternal(Run.java:527)
        at net.sourceforge.plantuml.Run.processArgs(Run.java:410)
        at net.sourceforge.plantuml.Run.manageAllFiles(Run.java:377)
        at net.sourceforge.plantuml.Run.main(Run.java:205)
Exception in thread "main" java.lang.UnsupportedOperationException
        at net.sourceforge.plantuml.pdf.PdfConverter.convert(PdfConverter.java:76)
        at net.sourceforge.plantuml.UmlDiagram.exportDiagramInternalPdf(UmlDiagram.java:288)
        at net.sourceforge.plantuml.UmlDiagram.exportDiagramNow(UmlDiagram.java:140)
        at net.sourceforge.plantuml.AbstractPSystem.exportDiagram(AbstractPSystem.java:157)
        at net.sourceforge.plantuml.PSystemUtils.exportDiagramsCuca(PSystemUtils.java:233)
        at net.sourceforge.plantuml.PSystemUtils.exportDiagrams(PSystemUtils.java:89)
        at net.sourceforge.plantuml.SourceFileReaderAbstract.getGeneratedImages(SourceFileReaderAbstract.java:171)
        at net.sourceforge.plantuml.Run.manageFileInternal(Run.java:527)
        at net.sourceforge.plantuml.Run.processArgs(Run.java:410)
        at net.sourceforge.plantuml.Run.manageAllFiles(Run.java:377)
        at net.sourceforge.plantuml.Run.main(Run.java:205)

Someone opened an issue about this [1]. following breadcrumbs [1], it's apparently
because the defaut plantuml.jar used not have everything packaged within. As pdf support
is extra, we need to update the dependencies with it [2].

It probably used to work and upstream packaging got updated, dropping the default pdf
support to decrease the jar size [2].

[1] https://github.com/qjebbs/vscode-plantuml/issues/186

[2] https://plantuml.com/pdf

ardumont updated the task description. (Show Details)Oct 18 2021, 9:54 AM