Deployed 3986594 to main with MkDocs 1.6.1 and mike 2.1.3

main/entrypoints/bidirectional_backup.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+
+apk add --no-cache unison
+
+[ -z "$(ls -A /bbackup)" ] && cp -r "${WORKDIR}"/. /bbackup
+
+flock -n /bbackup/.unison \
+    unison "${WORKDIR}" /bbackup \
+    -repeat watch -batch -auto \
+    -prefer /bbackup &

main/index.html

@@ -365,6 +365,21 @@
     </span>
   </a>
 
+    <nav class="md-nav" aria-label="DEV configuration">
+      <ul class="md-nav__list">
+
+          <li class="md-nav__item">
+  <a href="#dev-bidirectional-synchronization" class="md-nav__link">
+    <span class="md-ellipsis">
+      DEV bidirectional synchronization
+    </span>
+  </a>
+
+</li>
+
+      </ul>
+    </nav>
+
 </li>
 
           <li class="md-nav__item">
@@ -1023,6 +1038,21 @@
     </span>
   </a>
 
+    <nav class="md-nav" aria-label="DEV configuration">
+      <ul class="md-nav__list">
+
+          <li class="md-nav__item">
+  <a href="#dev-bidirectional-synchronization" class="md-nav__link">
+    <span class="md-ellipsis">
+      DEV bidirectional synchronization
+    </span>
+  </a>
+
+</li>
+
+      </ul>
+    </nav>
+
 </li>
 
           <li class="md-nav__item">
@@ -1958,6 +1988,39 @@ <h3 id="docker-compose-profiles-and-env-variables-configuration-options">
      <td>
      </td>
     </tr>
+    <tr>
+     <td>
+      env
+     </td>
+     <td>
+      <code>
+       DEV_BBACKUP
+      </code>
+     </td>
+     <td>
+      <code>
+       true
+      </code>
+      : bidirectional synchronization of DEV volume
+     </td>
+     <td>
+      <code>
+       ''
+      </code>
+     </td>
+     <td>
+      *
+     </td>
+     <td>
+      Enables
+      <a href="#dev-bidirectional-synchronization">
+       DEV bidirectional synchronization
+      </a>
+      between ${PWD}/bbackup/${APP} on the host and the dev volume
+     </td>
+     <td>
+     </td>
+    </tr>
    </tbody>
   </table>
   <p>
@@ -2118,6 +2181,35 @@ <h4 id="dev-configuration">
    <p>
     The repo is checkout at that particular commit only if the docker volume does not yet exist.
    </p>
+   <h5 id="dev-bidirectional-synchronization">
+    DEV bidirectional synchronization
+    <a class="headerlink" href="#dev-bidirectional-synchronization" title="Permanent link">
+     ¶
+    </a>
+   </h5>
+   <p>
+    Setting
+    <code>
+     DEV_BBACKUP=true
+    </code>
+    in the
+    <a href="https://github.com/SciCatProject/scicatlive/blob/main/.env">
+     .env
+    </a>
+    file enables bidirectional synchronization between the DEV volume of each component (e.g.
+    <code>
+     frontend_dev
+    </code>
+    ) and a directory on the host placed at
+    <code>
+     ${PWD}/bbackup/${APP}
+    </code>
+    (e.g.
+    <code>
+     ${PWD}/bbackup/${APP}
+    </code>
+    ). This is sometimes convenient both to have a backup of the volume and to enable the use of additional tools installed on the host, which require file access.
+   </p>
   </details>
   <h4 id="tls-configuration">
    TLS configuration

main/services/backend/services/v3/services/archivemock/compose.dev.yaml

@@ -5,7 +5,7 @@ services:
       service: web-app
     labels: !reset null
     volumes:
-      - archivemock_dev:/job_mock
+      - ${DEV_BBACKUP:+${PWD}/bbackup/${COMPOSE_PROJECT_NAME}/archivemock:}/bbackup
 
 volumes:
   archivemock_dev:

main/services/compose.dev.yaml

@@ -11,17 +11,20 @@ services:
       # These volumes allow to run init scripts before running the service
       - ${PWD}/entrypoints/loop_entrypoints.sh:/usr/local/bin/loop_entrypoints.sh
       - ${PWD}/entrypoints/infinite_loop.sh:/usr/local/bin/infinite_loop.sh
+      - ${PWD}/entrypoints/bidirectional_backup.sh:/docker-entrypoints/${DEV_BBACKUP:+1}00.sh
       - ${PWD}/entrypoints/chown_root.sh:/docker-entrypoints/00.sh
       - ${PWD}/entrypoints/setup_git.sh:/docker-entrypoints/01.sh
     environment:
       GITHUB_REPO: ${GITHUB_REPO:-}
+      WORKDIR: ${WORKDIR:-/home/node/app}
     user: root
     restart: no
   node-app-from-local:
     extends: web-app
     volumes:
       # This prevents git unpushed changes from being lost on container restart
       - ${DEV_VOLUME:-${APP}}_dev:${WORKDIR:-/home/node/app}
+      - ${DEV_BBACKUP:+${PWD}/bbackup/${COMPOSE_PROJECT_NAME}/${DEV_VOLUME:-${APP}}:}/bbackup
       # These allow to keep changes from npm install/build from Dockerfile CMDs
       - ${WORKDIR:-/home/node/app}/dist
       - ${WORKDIR:-/home/node/app}/node_modules