docs(deploy): document scp-to-named-volume as the desktop release publish step

/data is a named Docker volume, not a host bind-mount, so the prior
scp root@host:/data/downloads/ path was wrong. Document the real host
path (/var/lib/docker/volumes/bizgaze_support_data/_data/downloads) plus
the docker cp alternative, and note latest.yml is the only overwritten file.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-03 15:43:44 +05:30
parent a1887064eb
commit 609427747a
+17 -9
View File
@@ -152,16 +152,24 @@ ssh -p 61 root@118.95.33.89 'docker exec bizgaze-support mkdir -p /data/download
cd desktop && npm install && npm run dist
```
Output in `desktop/dist/`: `Biz Connect Setup <ver>.exe`, `…​.exe.blockmap`, `latest.yml`.
2. Upload those **three** files into `/data/downloads` on the server (all three are required —
`latest.yml` is the update manifest, `.blockmap` enables differential updates):
```bash
scp -P 61 "desktop/dist/Biz Connect Setup <ver>.exe" \
"desktop/dist/Biz Connect Setup <ver>.exe.blockmap" \
"desktop/dist/latest.yml" \
root@118.95.33.89:/data/downloads/
# if DOWNLOADS_DIR isn't on a host bind-mount, copy into the volume instead:
# docker cp "Biz Connect Setup <ver>.exe" bizgaze-support:/data/downloads/
2. Upload those **three** files into the container's `/data/downloads` (all three are required —
`latest.yml` is the update manifest, `.blockmap` enables differential updates). `/data` is a
**named Docker volume** (`bizgaze_support_data`), not a host bind-mount, so its real host path
is `/var/lib/docker/volumes/bizgaze_support_data/_data`. scp straight into it — one step, no
restart needed (the server serves the folder live):
```powershell
# from the repo's desktop\dist folder on the Windows build machine
scp -P 61 "Biz Connect Setup <ver>.exe" "Biz Connect Setup <ver>.exe.blockmap" latest.yml `
root@118.95.33.89:/var/lib/docker/volumes/bizgaze_support_data/_data/downloads/
```
Alternatively, scp to `/tmp` on the server and `docker cp` in (avoids touching the volume path):
```bash
docker cp "/tmp/Biz Connect Setup <ver>.exe" bizgaze-support:/data/downloads/
docker cp "/tmp/Biz Connect Setup <ver>.exe.blockmap" bizgaze-support:/data/downloads/
docker cp "/tmp/latest.yml" bizgaze-support:/data/downloads/
```
Keep both versions' `.exe`/`.blockmap` on the server (older blockmaps let installed apps pull
deltas); only `latest.yml` is overwritten — there must be exactly one, pointing at the newest.
3. Verify:
```bash
curl -I https://remote.bizgaze.com/download/windows # 302 → the new .exe