Environment-Monitoring-System/docs/Docker_构建与发布指南.md

Docker 构建与发布指南

本指南说明如何将项目打包成 Docker 镜像并推送到镜像仓库。

先决条件

• Docker Desktop / Docker Engine
• 能访问镜像仓库的网络
• 镜像仓库登录凭据

需要的文件

构建与发布需要以下文件：

• ems-backend/Dockerfile
• ems-frontend/Dockerfile
• ems-frontend/nginx.conf
• docker-compose.yml（本地测试可选）
• .env（不要发布，保留在本地）

1) 本地构建镜像

在项目根目录执行：

docker build -t <REGISTRY>/<NAME>/ems-backend:latest ./ems-backend
docker build -t <REGISTRY>/<NAME>/ems-frontend:latest --build-arg VITE_API_BASE_URL=/api ./ems-frontend

示例：

• Docker Hub：

docker build -t <dockerhub_user>/ems-backend:latest ./ems-backend
docker build -t <dockerhub_user>/ems-frontend:latest --build-arg VITE_API_BASE_URL=/api ./ems-frontend

• 私有仓库：

docker build -t docker.aizhangz.top/ems-backend:latest ./ems-backend
docker build -t docker.aizhangz.top/ems-frontend:latest --build-arg VITE_API_BASE_URL=/api ./ems-frontend

2) 登录镜像仓库

docker login <REGISTRY>

示例：

docker login docker.aizhangz.top

3) 推送镜像

docker push <REGISTRY>/<NAME>/ems-backend:latest
docker push <REGISTRY>/<NAME>/ems-frontend:latest

示例（私有仓库）：

docker push docker.aizhangz.top/ems-backend:latest
docker push docker.aizhangz.top/ems-frontend:latest

4) 验证

拉取一次确认：

docker pull <REGISTRY>/<NAME>/ems-backend:latest
docker pull <REGISTRY>/<NAME>/ems-frontend:latest

注意事项

• 不要提交包含密钥的 .env。
• 如果使用公共仓库，请移除镜像中的敏感配置。
• 需要用镜像本地运行时，使用 docker-compose.private.yml。