goweb3系列解析21：GoDocker 目录解析

本文详细介绍了goweb3项目的Docker容器化部署方案，该项目采用多环境、多服务架构，支持从开发到生产的全生命周期管理。核心内容包括：1）清晰的目录结构划分，包含基础服务镜像（MySQL/Redis/Nginx等）和应用服务；2）五层环境体系（local→dev→test→release→master）；3）标准化的Dockerfile和docker-compose模板；4）基础服务的中文与时区优化配置；5）完善的配置文件结构和部署脚本。该方案具有轻量级镜像、配置分离、数据持久化、自动恢复等特点，通过Docker Compose实现服务编排，各组件通过定义端口相互通信，形成完整的微服务架构。

Docker 目录解析

docker目录是 goweb3 项目的容器化部署基础设施，包含完整的多环境、多服务的 Docker 配置，支持本地开发、测试、发布等全生命周期管理。

一、目录结构总览

plainText

docker/ ├── docker-base/ # 基础服务镜像（中间件） │ ├── docker-mysql13306/ # MySQL 5.7.25 │ ├── docker-redis/ # Redis │ ├── docker-nginx/ # Nginx │ ├── docker-etcd/ # Etcd │ ├── docker-clickhouse/ # ClickHouse │ ├── docker-doris/ # Doris │ ├── docker-postgres/ # PostgreSQL │ ├── docker-consul/ # Consul │ ├── docker-cockroach/ # CockroachDB │ ├── docker-gitea/ # Gitea │ ├── docker-gitlab/ # GitLab │ ├── docker-portainer/ # Portainer │ └── website/ # Website 相关 │ ├── docker-website-web/ # Web 前端 │ ├── docker-website-admin/ # Admin 前端 │ ├── docker-website-grpc/ # gRPC 网关 │ └── docker-website-mobile/ # 移动端 ├── admin/ # 管理后台服务 │ ├── dev/ │ ├── test/ │ ├── release/ │ └── master/ ├── web/ # 前台服务 │ ├── dev/ │ ├── test/ │ ├── release/ │ └── master/ ├── grpc/ # gRPC 服务 │ ├── dev/ │ ├── test/ │ ├── release/ │ └── master/ └── backend/ # 后端服务 ├── dev/ ├── test/ ├── release/ └── master/

二、服务架构

三、环境分层

lainText

┌─────────────────────────────────────────────────────┐ │ 环境层级 │ ├─────────────────────────────────────────────────────┤ │ local → 本地开发环境（IDE运行） │ │ ↓ │ │ dev → 开发环境（测试服务器） │ │ ↓ │ │ test → 测试环境（QA验证） │ │ ↓ │ │ release → 预发布环境（灰度发布） │ │ ↓ │ │ master → 生产环境（正式上线） │ └─────────────────────────────────────────────────────┘

四、核心配置解析

1. Dockerfile 标准模板

admin/dev/Dockerfile为例：

dockerfile

FROM alpine:latest RUN apk --no-cache add ca-certificates # 环境变量 ENV BasePath="/root/app" ENV SWAGGER_HOST="192.168.17.113:201/website-admin/v3" ENV SWAGGER_TITLE="有芯网站管理后台服务-AdminServer" # 创建目录 RUN mkdir -p /root/app RUN mkdir -p /root/app/logs WORKDIR /root/app # 复制配置和代码 COPY ./config /root/app/config COPY ./data /root/app/data ADD ./main /root/app/main RUN chmod +x ./main EXPOSE 201 ENTRYPOINT ["/root/app/main"]

特点：

• 基于alpine:latest轻量级镜像
• 支持 HTTPS（ca-certificates）
• 配置文件和数据目录分离
• 可执行文件权限设置

2. docker-compose.yml 标准模板

yaml

version: "3" services: website-admin: build: context: "" dockerfile: Dockerfile image: website-admin container_name: website-admin hostname: website-admin user: root restart: always ports: - 201:201 environment: TZ: Asia/Shanghai volumes: - /opt/logs/website-admin:/root/app/logs - /opt/data/website-admin:/root/app/data

配置要点：

五、基础服务镜像（docker-base）

1. MySQL 镜像

docker-mysql13306/Dockerfile：

dockerfile

FROM mysql:5.7.25 # 配置中文支持 RUN apt-get update && \ apt-get install -y locales kde-l10n-zhcn && \ apt-get clean RUN locale-gen "zh_CN.UTF-8" ENV LANG=zh_CN.UTF-8 \ LANGUAGE=zh_CN:zh:en_US:en \ LC_ALL=zh_CN.UTF-8 \ TZ=Asia/Shanghai COPY my.cnf /etc/mysql/my.cnf EXPOSE 3306 CMD ["mysqld"]

特性：

• MySQL 5.7.25 版本
• 支持中文 UTF-8 编码
• 时区设置为上海

2. Redis 镜像

docker-redis/Dockerfile：

dockerfile

FROM redis:latest ENV TZ=Asia/Shanghai COPY redis.conf /usr/local/etc/redis/redis.conf EXPOSE 6379 CMD ["redis-server", "/usr/local/etc/redis/redis.conf"]

3. Nginx 镜像

docker-nginx/Dockerfile：

dockerfile

FROM nginx:latest ENV TZ=Asia/Shanghai COPY nginx.conf /etc/nginx/nginx.conf COPY conf.d/ /etc/nginx/conf.d/ EXPOSE 80 EXPOSE 443 CMD ["nginx", "-g", "daemon off;"]

六、配置文件结构

每个服务目录下的config/结构：

plainText

config/ ├── env.yml # 环境标识 ├── ichub-dev.yml # 应用主配置 ├── factroy/ # 代码生成模板 │ ├── template/ # 模板文件 │ │ ├── Dao.template │ │ ├── Service.template │ │ ├── Web.template │ │ └── ... │ └── factroy.yml # 模板配置 ├── godi/ # 依赖注入配置 │ ├── template/ # DI模板 │ └── di_define.ini # DI定义 ├── rule_define/ # 规则定义 │ ├── general/ # 通用规则 │ │ ├── func_dbquery/ # 数据库查询 │ │ ├── func_esquery/ # ES查询 │ │ └── ... │ └── cms/ # CMS规则 ├── es/ # ES配置 │ └── mapping/ # ES映射 │ ├── mapping.json │ └── settings.json └── templates/ # 视图模板 ├── index.html └── index.tmpl

env.yml：

yaml

Env: ${ICHUB_ENV:dev} # local dev test release master raymond

七、部署脚本

每个环境目录下包含：

八、服务端口汇总

九、启动流程

plainText

1. 构建基础服务（可选） cd docker/docker-base/docker-mysql13306 docker-compose up -d 2. 构建应用服务 cd docker/admin/dev docker-compose up -d 3. 验证服务 curl http://localhost:201/health

十、设计特点

十一、部署架构图

plainText

┌─────────────────────────────────────────────────────────────┐ │ Docker Compose │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ website- │ │ website- │ │ website- │ │ │ │ admin │ │ web │ │ grpc │ │ │ │ (port 201)│ │ (port 202) │ │ (port 1201) │ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ docker-base │ │ │ │ MySQL Redis Etcd ClickHouse Nginx │ │ │ │ 13306 6379 2379 8123 80/443 │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘