commit f13627f96bda028927f4b98057d5d78045f49d81
parent 8ff8d85c7593eb9add28e2f6e9fc610aa47fbaa8
Author: Andreas Gruhler <agruhl@gmx.ch>
Date: Sun, 7 Sep 2025 13:28:38 +0200
doc(jenkins-agent): buildah requires vfs driver when run in container
Diffstat:
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/docker/docker-jenkins-inbound-agent/Dockerfile b/docker/docker-jenkins-inbound-agent/Dockerfile
@@ -75,9 +75,11 @@ RUN apk add --no-cache docker buildah netavark
# https://developers.redhat.com/blog/2019/08/14/best-practices-for-running-buildah-in-a-container
ENV _BUILDAH_STARTED_IN_USERNS="" BUILDAH_ISOLATION=chroot
+# Without vfs storage driver, buildah refuses to build images.
+# > If you're running podman inside a container, change the storage driver to vfs
+# - https://wiki.alpinelinux.org/wiki/Podman
# 'overlay' is not supported over overlayfs without fuse-overlayfs. VFS is the alternative.
# - https://docs.gitlab.com/ci/docker/using_docker_build/#buildah-example
-# - https://wiki.alpinelinux.org/wiki/Podman
# - https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md
# - https://docs.podman.io/en/latest/markdown/podman.1.html#environment-variables
ENV STORAGE_DRIVER=vfs
