📝 docs(deploy): 明确裸 up 不重建已有镜像 + 修正 build.sh 三步描述

- DEPLOYMENT §1.2 / LINUX_SETUP §11 / README / OPERATIONS 补充:
  docker compose up -d 对本地已有同名镜像不会自动重建,更新代码后
  需 up -d --build 或先 build(部署机实测复用旧镜像后澄清)
- build.sh 描述由四步修正为 base → backend → frontend 三步(celery
  复用 backend 镜像,随 Dockerfile.celery 移除的文档收尾)

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
2026-09-24 17:05:01 +08:00
parent 7717c9fa14
commit b03431b511
4 changed files with 14 additions and 4 deletions
+1 -1
View File
@@ -76,7 +76,7 @@ docker compose -f docker-compose.moldinsight.yml up -d
docker compose -f docker-compose.inventory.yml up -d docker compose -f docker-compose.inventory.yml up -d
``` ```
> 镜像首次构建:`bash deploy/build.sh`(build base → backend → celery → frontend 4 个 tag)。 > 镜像首次构建:`bash deploy/build.sh`(build base → backend → frontend 3 个 tag,celery 复用 backend);更新代码后用 `docker compose up -d --build` 重建(裸 `up -d` 不会重建已有镜像)。
如需直接运行: 如需直接运行:
+9 -1
View File
@@ -33,9 +33,17 @@
首次部署或更新代码后先构建,再 `up`: 首次部署或更新代码后先构建,再 `up`:
```bash ```bash
bash deploy/build.sh # 显式构建 base / backend / celery / frontend 4 个镜像 bash deploy/build.sh # 显式构建 base / backend / frontend 3 个镜像(celery 复用 backend)
``` ```
或让 compose 构建:
```bash
docker compose up -d --build
```
> **注意**:`docker compose up -d` 在本地已有同名镜像(如 `gemold-backend:latest`)时**不会自动重建**,会直接复用旧镜像启动。更新代码或 Dockerfile 后,必须 `docker compose build` 或 `docker compose up -d --build` 才会生效。
详细 Linux 部署步骤: 详细 Linux 部署步骤:
- [deployment/LINUX_SETUP.md](deployment/LINUX_SETUP.md) - [deployment/LINUX_SETUP.md](deployment/LINUX_SETUP.md)
+1 -1
View File
@@ -93,7 +93,7 @@ docker compose -f docker-compose.inventory.yml up -d
> 旧 `--profile` 写法已失效(服务不再声明 profiles);模式切换唯一入口是 `-f` 文件名。 > 旧 `--profile` 写法已失效(服务不再声明 profiles);模式切换唯一入口是 `-f` 文件名。
- 镜像构建:`bash deploy/build.sh`(base → backend → celery → frontend 4 个 tag);首次部署或更新代码后必须先 build 再 `up`。 - 镜像构建:`bash deploy/build.sh`(base → backend → frontend 3 个 tag,celery 复用 backend 镜像);首次部署或更新代码后必须先 build(或 `docker compose up -d --build`)——裸 `up` 对本地已有同名镜像**不会自动重建**。
- PostgreSQL / Redis / RustFS 通常**复用服务器已有服务**,不由项目 compose 自带;容器只注入连接配置。 - PostgreSQL / Redis / RustFS 通常**复用服务器已有服务**,不由项目 compose 自带;容器只注入连接配置。
## 5. 运行时硬性要求 ## 5. 运行时硬性要求
+3 -1
View File
@@ -427,7 +427,9 @@ curl http://127.0.0.1:8000/health
镜像构建: 镜像构建:
```bash ```bash
bash deploy/build.sh # base → backend → celery → frontend bash deploy/build.sh # base → backend → frontend(celery 复用 backend 镜像)
# 或让 compose 构建:docker compose up -d --build
# 注意:docker compose up -d 对本地已有同名镜像不会自动重建,更新代码后需 --build
``` ```
--- ---