Attention is currently required from: Martin L Roth.

Nicholas Chin has uploaded this change for review.

View Change

util/docker: Update Dockerfiles for building documentation

Update all pip packages related to coreboot's documentation to their
latest available version, and update the doc.coreboot.org base image
to Alpine 3.19.1. Add myst-parser in preparation to switch from
Recommonmark to MyST Parser.

TEST: The documentation builds and renders properly when build using the
updated container.

Change-Id: I8df4aadabc49c0201a836333745fe138184595ac
Signed-off-by: Nicholas Chin <nic.c3.14@gmail.com>
---
M util/docker/coreboot-jenkins-node/Dockerfile
M util/docker/doc.coreboot.org/Dockerfile
2 files changed, 10 insertions(+), 8 deletions(-)

git pull ssh://review.coreboot.org:29418/coreboot refs/changes/12/80312/1
diff --git a/util/docker/coreboot-jenkins-node/Dockerfile b/util/docker/coreboot-jenkins-node/Dockerfile
index f1ab4e9..c032a4d 100644
--- a/util/docker/coreboot-jenkins-node/Dockerfile
+++ b/util/docker/coreboot-jenkins-node/Dockerfile
@@ -79,12 +79,13 @@
pip3 install --upgrade --no-cache-dir pip && \
pip3 install --no-cache-dir \
setuptools==58.2.0 \
- jinja2==3.1.2 \
+ jinja2==3.1.3 \
recommonmark===0.7.1 \
- sphinx===6.2.1 \
+ myst-parser===2.0.0 \
+ sphinx===7.2.6 \
sphinxcontrib-ditaa===1.0.2 \
sphinx_autobuild===2021.3.14 \
- sphinx_rtd_theme===1.2.2 \
+ sphinx_rtd_theme===2.0.0 \
&& mkdir -p /home/coreboot/.ssh && \
echo "{{SSH_KEY}}" > /home/coreboot/.ssh/authorized_keys && \
chmod 0700 /home/coreboot/.ssh && \
diff --git a/util/docker/doc.coreboot.org/Dockerfile b/util/docker/doc.coreboot.org/Dockerfile
index 1039d36..5c3a782 100644
--- a/util/docker/doc.coreboot.org/Dockerfile
+++ b/util/docker/doc.coreboot.org/Dockerfile
@@ -1,4 +1,4 @@
-FROM alpine:3.18.3
+FROM alpine:3.19.1

COPY makeSphinx.sh /makeSphinx.sh

@@ -9,12 +9,13 @@
RUN python3 -m venv ${VIRTUAL_ENV} \
&& pip3 install --upgrade --no-cache-dir pip \
&& pip3 install --no-cache-dir \
- jinja2==3.1.2 \
- recommonmark===0.7.1\
- sphinx===6.2.1 \
+ jinja2==3.1.3 \
+ recommonmark===0.7.1 \
+ myst-parser==2.0.0 \
+ sphinx===7.2.6 \
sphinxcontrib-ditaa===1.0.2 \
sphinx_autobuild===2021.3.14 \
- sphinx_rtd_theme===1.2.2
+ sphinx_rtd_theme===2.0.0

ADD https://github.com/stathissideris/ditaa/releases/download/v0.11.0/ditaa-0.11.0-standalone.jar \
/usr/lib/ditaa-0.11.0-standalone.jar

To view, visit change 80312. To unsubscribe, or for help writing mail filters, visit settings.

Gerrit-Project: coreboot
Gerrit-Branch: main
Gerrit-Change-Id: I8df4aadabc49c0201a836333745fe138184595ac
Gerrit-Change-Number: 80312
Gerrit-PatchSet: 1
Gerrit-Owner: Nicholas Chin <nic.c3.14@gmail.com>
Gerrit-Reviewer: Martin L Roth <gaumless@gmail.com>
Gerrit-Attention: Martin L Roth <gaumless@gmail.com>
Gerrit-MessageType: newchange