From 9a96137c9702467f56f400e8d251645b0f6e693c Mon Sep 17 00:00:00 2001 From: Jeremy Stein Date: Mon, 15 Dec 2025 16:39:41 +0000 Subject: [PATCH 1/3] Instruct user to create host mounted dirs first --- docs/dev/deployment.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/dev/deployment.md b/docs/dev/deployment.md index 507675da1..e27a70f6f 100644 --- a/docs/dev/deployment.md +++ b/docs/dev/deployment.md @@ -223,6 +223,18 @@ vim global-configuration.yaml emap setup -g ``` +If you enabled any services which mount a host directory, then it's easier +to create that directory *before* you bring any services up. + +Eg. for the waveform-reader: +```bash +mkdir /gae/emap-instance-name/waveform-saved-messages +``` +Although docker compose will create any missing host directories, it +will use the wrong permissions and subsequently written files will need +fixing up before they can be read by normal users. +See Slab for the required chmod/chown/setfacl trick if you did this. + ### Bringing up an instance ```bash emap docker up -d From 7103d41c1c7a8419aa3a5ca066fbcac00aeafb2b Mon Sep 17 00:00:00 2001 From: Jeremy Stein Date: Tue, 16 Dec 2025 11:52:07 +0000 Subject: [PATCH 2/3] Clarify directory creation --- docs/dev/deployment.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/dev/deployment.md b/docs/dev/deployment.md index e27a70f6f..a023af88f 100644 --- a/docs/dev/deployment.md +++ b/docs/dev/deployment.md @@ -223,6 +223,11 @@ vim global-configuration.yaml emap setup -g ``` +### Create host mounted directories + +> [!NOTE] +> GAE only. + If you enabled any services which mount a host directory, then it's easier to create that directory *before* you bring any services up. @@ -233,7 +238,9 @@ mkdir /gae/emap-instance-name/waveform-saved-messages Although docker compose will create any missing host directories, it will use the wrong permissions and subsequently written files will need fixing up before they can be read by normal users. -See Slab for the required chmod/chown/setfacl trick if you did this. +See Slab for the +[required chmod/chown/setfacl trick](https://uclh.slab.com/posts/shared-virtual-python-environments-with-uv-u7pa2fv4#hpkxd-per-gae-setup-tasks) +if you did this. ### Bringing up an instance ```bash From 69ac8c3fbef70ef4db2b17182a887011c3a7df7a Mon Sep 17 00:00:00 2001 From: Jeremy Stein Date: Tue, 16 Dec 2025 12:14:22 +0000 Subject: [PATCH 3/3] Try and kick Github Actions. --- docs/dev/deployment.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/dev/deployment.md b/docs/dev/deployment.md index a023af88f..698151e7f 100644 --- a/docs/dev/deployment.md +++ b/docs/dev/deployment.md @@ -124,7 +124,6 @@ Config tips: - All config must stay local and not be committed to git. ### Clone the other repositories - > [!NOTE] > Since moving to the monorepo, the importance of the `emap` script in managing repos > has decreased. Especially during development, you may just want to manually manipulate your git repos.