From 494228b367d0be7d2a08882b7f6f67d0bf5aba3d Mon Sep 17 00:00:00 2001
From: hygienic-books <hygienic-books@tentic.net>
Date: Sat, 24 Jun 2023 23:22:41 +0200
Subject: [PATCH] docs(docker-compose): Flesh out individual build processes

---
 docker-compose/examples/hashicorpvault/README.md           | 1 +
 docker-compose/{{ cookiecutter.__project_slug }}/README.md | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/docker-compose/examples/hashicorpvault/README.md b/docker-compose/examples/hashicorpvault/README.md
index df406df..4abd21c 100644
--- a/docker-compose/examples/hashicorpvault/README.md
+++ b/docker-compose/examples/hashicorpvault/README.md
@@ -26,6 +26,7 @@ docker context create fully.qualified.domain.name --docker 'host=ssh://root@full
 ```
 
 ## Build
+We build the `vault` image locally. Our adjustment to the official image is simply adding `/tmp/vault` to it. See [build-context/vault/Dockerfile](build-context/vault/Dockerfile). We use `/tmp/vault` to bind-mount a dedicated ZFS dataset for the application's `tmpdir` location.
 
 ```
 docker compose --project-name "${COMPOSE_PROJECT}" --file "${COMPOSE_FILE}" --file "${COMPOSE_OVERRIDE}" --env-file "${COMPOSE_ENV}" --profile 'build' build
diff --git a/docker-compose/{{ cookiecutter.__project_slug }}/README.md b/docker-compose/{{ cookiecutter.__project_slug }}/README.md
index 29fde24..0edf455 100644
--- a/docker-compose/{{ cookiecutter.__project_slug }}/README.md	
+++ b/docker-compose/{{ cookiecutter.__project_slug }}/README.md	
@@ -29,6 +29,13 @@ docker context create fully.qualified.domain.name --docker 'host=ssh://root@full
 
 ## Build
 
+{%- set components = cookiecutter.__component_list_slug.split(',') -%}
+{% for component in components %}
+{%- if loop.first %}
+We build the `{{ cookiecutter.__service_slug }}` image locally. Our adjustment to the official image is simply adding `/tmp/{{ cookiecutter.__service_slug }}` to it. See [build-context/{{ cookiecutter.__service_slug }}/Dockerfile](build-context/{{ cookiecutter.__service_slug }}/Dockerfile). We use `/tmp/{{ cookiecutter.__service_slug }}` to bind-mount a dedicated ZFS dataset for the application's `tmpdir` location.
+{%- endif %}
+{%- endfor %}
+
 ```
 docker compose --project-name "${COMPOSE_PROJECT}" --file "${COMPOSE_FILE}" --file "${COMPOSE_OVERRIDE}" --env-file "${COMPOSE_ENV}" --profile 'build' build
 ```