From e69228f3b5388a0133297a6a1bca99c3d850502a Mon Sep 17 00:00:00 2001 From: Val Redchenko Date: Mon, 8 Jun 2026 17:40:37 +0100 Subject: [PATCH] docs: add DLS filesystem mount placeholder to prod/stage API manifests The image-serving API endpoints read atlas/grid-square files off disk via the /dls/... paths stored in the DB, so prod/stage need the real Diamond /dls filesystem mounted at /dls. Add a commented placeholder (NFS or PVC) to the production and staging smartem-http-api deployments for whoever wires up those clusters. Inert until uncommented and configured. API service only. --- .../production/smartem-http-api.yaml | 19 +++++++++++++++++++ .../staging/smartem-http-api.yaml | 19 +++++++++++++++++++ 2 files changed, 38 insertions(+) diff --git a/k8s/environments/production/smartem-http-api.yaml b/k8s/environments/production/smartem-http-api.yaml index e38a322..fbde39e 100644 --- a/k8s/environments/production/smartem-http-api.yaml +++ b/k8s/environments/production/smartem-http-api.yaml @@ -56,6 +56,25 @@ spec: limits: memory: "512Mi" cpu: "500m" + # --- DLS filesystem mount (PLACEHOLDER - configure before enabling) --- + # The image-serving API endpoints (atlas_image, gridsquare_image) read microscopy + # files off disk using the absolute /dls/... paths stored in the DB. Mount the real + # Diamond /dls shared filesystem read-only at /dls so they resolve. API service only: + # the worker does not read image files. Set the source to the actual DLS NFS export + # or a PVC bound to it for this cluster, then uncomment both blocks. + # volumeMounts: + # - name: dls-filesystem + # mountPath: /dls + # readOnly: true + # volumes: + # - name: dls-filesystem + # nfs: + # server: # DLS NFS/GPFS export host + # path: /dls # export containing /data///... + # readOnly: true + # # or bind to a PersistentVolumeClaim instead of nfs: + # # persistentVolumeClaim: + # # claimName: dls-filesystem --- diff --git a/k8s/environments/staging/smartem-http-api.yaml b/k8s/environments/staging/smartem-http-api.yaml index 8530c7d..19868d3 100644 --- a/k8s/environments/staging/smartem-http-api.yaml +++ b/k8s/environments/staging/smartem-http-api.yaml @@ -55,6 +55,25 @@ spec: limits: memory: "256Mi" cpu: "200m" + # --- DLS filesystem mount (PLACEHOLDER - configure before enabling) --- + # The image-serving API endpoints (atlas_image, gridsquare_image) read microscopy + # files off disk using the absolute /dls/... paths stored in the DB. Mount the real + # Diamond /dls shared filesystem read-only at /dls so they resolve. API service only: + # the worker does not read image files. Set the source to the actual DLS NFS export + # or a PVC bound to it for this cluster, then uncomment both blocks. + # volumeMounts: + # - name: dls-filesystem + # mountPath: /dls + # readOnly: true + # volumes: + # - name: dls-filesystem + # nfs: + # server: # DLS NFS/GPFS export host + # path: /dls # export containing /data///... + # readOnly: true + # # or bind to a PersistentVolumeClaim instead of nfs: + # # persistentVolumeClaim: + # # claimName: dls-filesystem ---