coreboot/util/docker
Nicholas Chin 56c3444d85 util/docker/Makefile: Create Documentation/_build for docker-build-docs
If the host directory of a bind mount does not exist, Docker will create
it. However, the newly created directory will be owned by root due to
the Docker service running within a root context. The docker command in
the recipe for docker-build-docs binds Documentation/_build to /data-out
within the container, so if it doesn't already exist, the documentation
builder will be unable to copy the HTML output into /data-out since it
runs with the same UID and GID as the host user.

By creating, if necessary, the _build directory before the `docker run`
command, there should always be an existing directory owned by the host
user for docker to bind /data-out to (ignoring the case of an existing
_build directory the current user does not have permission to write to),
avoiding the issue where it cannot write the output.

TEST: make -C util/docker docker-build-docs completes without issues
with and without an existing Documentation/_build directory

Change-Id: I6be9bc1fdca48f4d924f5c07cc261189ab6862fd
Signed-off-by: Nicholas Chin <nic.c3.14@gmail.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/81127
Reviewed-by: Felix Singer <service+coreboot-gerrit@felixsinger.de>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Martin L Roth <gaumless@gmail.com>
2024-03-09 23:46:00 +00:00
..
alma util/docker/alma: Add Dockerfile.base 2023-12-08 22:24:33 +00:00
alpine util/docker/alpine: Rename Dockerfile to Dockerfile.base 2023-12-06 18:43:45 +00:00
archlinux util/docker/archlinux: Rename Dockerfile to Dockerfile.base 2023-12-08 22:23:36 +00:00
coreboot-jenkins-node docker/coreboot-sdk: Add meson 2024-02-26 17:25:00 +00:00
coreboot-jenkins-test util/docker: Replace use of sed with build args 2023-09-07 13:36:20 +00:00
coreboot-sdk docker/coreboot-sdk: Add meson 2024-02-26 17:25:00 +00:00
coreboot.org-status coreboot.org-status: Make URLs branch agnostic 2023-09-22 09:41:50 +00:00
doc.coreboot.org util/docker: Update Dockerfiles for building the documentation 2023-08-21 22:39:06 +00:00
fedora util/docker/fedora: Add Dockerfile.base 2023-12-29 22:14:49 +00:00
rocky util/docker/rocky: Add Dockerfile.base 2023-12-08 22:24:06 +00:00
build.sh util/docker: Add build script 2023-12-06 18:44:38 +00:00
description.md util: Update description files 2022-05-30 13:05:21 +00:00
Makefile util/docker/Makefile: Create Documentation/_build for docker-build-docs 2024-03-09 23:46:00 +00:00