easygoadmin/easygoadmin-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新Docker

Browse Source
This commit is contained in:
小蚂蚁云
2026-10-26 09:07:19 +08:00
parent fdbeae092a
commit 988123cdeb
16 changed files with 1061 additions and 140 deletions
Download Patch File Download Diff File Expand all files Collapse all files
EasyGoAdmin_Gin_AntdVue/zh/deploy/docker.md
+20 -17
View File
@@ -8,8 +8,8 @@
| 文件 | 作用 |
|---|---|
| Dockerfile | 多阶段：golang:1.27-alpine 编译 → alpine:3.20 运行（带时区与证书） |
| docker-compose.yaml | admin-server + nginx + mysql + redis 编排 |
| Dockerfile | 多阶段：golang:1.27-alpine 编译 → alpine:3.22 运行（非 root、时区与证书、健康检查探 /api/health） |
| docker-compose.yaml | admin-server + nginx + mysql + redis 编排；MySQL 首启自动建库、服务健康依赖 |
| nginx.conf | upload 直供（temp 封禁、SVG 附件、大小限制） |
## 生产启动
@@ -18,35 +18,38 @@
cp .env.example .env # 修改全部密码/密钥/域名
# .env 中设置：JWT_SECRET 强随机、各密码、FILE_DOMAIN_URL=https://files.your-domain
cd deploy
docker compose up -d --build
# 首次初始化数据库
docker exec -i easygoadmin-mysql mysql -uroot -p<密码> \
easygoadmin.gin.elevue < ../document/mysql/easygoadmin.gin.elevue.sql
# 在项目根执行（compose 默认只找 deploy/.env，根目录 .env 须显式传入）
docker compose --env-file .env -f deploy/docker-compose.yaml up -d --build
```
:::tip 数据库初始化
MySQL 数据卷为空时自动导入 `document/mysql/easygoadmin.gin.elevue.sql` 定稿脚本（仅首次执行一次），
无需手工导 SQL；已有数据卷不会补表，需重导时请先备份再清卷。
:::
## 生产环境变量核对
compose 以 APP_ 规范键注入应用：
compose 以 APP_ 规范键注入应用，`.env` 中的友好名经 `environment` 块映射：
| 环境变量 | 生产要求 |
| 环境变量（.env 键） | 生产要求 |
|---|---|
| APP_APP_PROD | true（compose 中按需追加） |
| APP_APP_PROD | true（.env 中取消注释即可，compose 已透传） |
| APP_GENERATOR_ENABLE | false（关闭代码生成器） |
| APP_API_DOCS / APP_API_METRICS | false（关闭文档/指标端点） |
| APP_DATABASE_DEFAULT_* | 内网地址与强密码 |
| APP_REDIS_DEFAULT_PASS | 强密码 |
| APP_JWT_SECRET | 强随机（非样例值） |
| APP_FILE_UPLOADDIR / APP_FILE_DOMAINURL | 卷路径与 https 文件域址 |
| APP_JWT_SECRET（友好名 JWT_SECRET） | 强随机（非样例值） |
| APP_FILE_UPLOADDIR / APP_FILE_DOMAINURL | 容器路径与 https 文件域址 |
MySQL/Redis 端口 compose 默认仅绑回环（127.0.0.1）——保持该约束，勿映射到 0.0.0.0。
## 卷与备份
| 卷 | 内容 | 备份 |
| 卷/挂载 | 内容 | 备份 |
|---|---|---|
| mysql_data | 数据库 | 定期 mysqldump / 快照 |
| redis_data | 缓存 | 可丢（重建即降级恢复） |
| upload_data | 上传文件 | 定期同步（应用写 + nginx 只读挂载） |
| ../upload（bind，应用 rw / nginx ro） | 上传文件 | 宿主目录定期同步 |
## 前端容器化（可选）
@@ -55,8 +58,8 @@ MySQL/Redis 端口 compose 默认仅绑回环（127.0.0.1）——保持该约
## 升级
```bash
docker compose pull（如用镜像仓库）或重新 build
docker compose up -d --build admin-server # 滚动重建应用
docker compose --env-file .env -f deploy/docker-compose.yaml pull # 如用镜像仓库
docker compose --env-file .env -f deploy/docker-compose.yaml up -d --build admin-server # 滚动重建应用
```
应用优雅关闭保证在途请求排空。