docker部署规范-目录结构与辅助工具（旧）

本文链接：https://blog.youkuaiyun.com/lichangzhen2008/article/details/117465025

该博客介绍了docker部署规范，包括目录结构和辅助工具。目录结构规划考虑多系统部署、自洽性和构建速度。辅助工具涵盖自动镜像打包、版本打包和升级工具，还给出了各工具的执行命令及相关代码参考。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

改目录结构已经重构，部署方式更简洁，最新参考：docker部署规范-目录结构与辅助工具

~~# docker部署规范-目录结构与辅助工具~~

~~本规范根据多个项目实践，总结如下~~

规范部署目录结构

目录结构的规划基于下面几点考虑：

一个主机上可以部署多套系统
一个系统应该是”自洽“的，具有完整的逻辑性，系统涉及的所有文件是自包含的
当系统需要本地二次构建时，速度要够快（docker-compose.yml所在目录不能有太多无关文件，否则会影响docker up --build执行速度）

目录结构如下所示:

[项目名称]-deplopy:
- **conf
  - .env: 定义COMPOSE_PROJECT_NAME=[项目名称]-deplopy,通过变量定义项目名称
  - docker-compose.yml: 主文件
  - Dockerfile-[服务名]:一般情况下，web服务都放在docker-compose环境进行二次构建，以便于在部署环境修改nginx.conf的路由配置，安全设置，证书替换等。
    - 采用中横线命名方式:Dockerfile-[服务名],例如Dockerfile-auth表示提供鉴权的web服务
  - ningx-[服务名].conf：web服务进行二次构建时的配置文件
  - cert: SSL证书目录
- init-data：初始化的数据，如数据库脚本、程序加载时的初始数据等
- run-data: 运行过程中的数据，如数据库存储目录，程序的临时文件目录
- log: 程序日志目标
- back: 程序备份目录
- auto_pack.py/auto_pack.sh: 自动打包工具
- auto_upgrade.py/auto_upgrade.sh: 自动升级工具

自动镜像打包工具

执行命令: python image_pack.py

step1 读取 docker-compose.yml和Dockerfile获取镜像列表
step2 对镜像进行备份，打包到./back/image/目录
- 获取镜像的创建时间，镜像打包文件的格式：仓储名称_标签名称_创建时间(yyyymmddHHMMSS).tar.gz
- 若打包文件已经存在，不会重复打包
- 打包+压缩命令为"docker save IMAGE > xxx.tar && gizp xxx.tar.gz xxx.tar"

详见下列代码:

# /usr/bin/python
# -- coding:utf8 --
import os
import sys
import subprocess
import datetime
# 当前时间

def run_cmd(cmd):
    print(cmd)
    p = subprocess.call(cmd, shell=True)


deploy_path = './conf'
pack_path = './back/image/'

# 若没有back文件夹，新建
if not os.path.exists(pack_path):
    run_cmd("mkdir "+pack_path)

# step1 读取 docker-compose.yml中的镜像名称
imgs = []
dc_file = deploy_path + '/docker-compose.yml'
if os.path.exists(dc_file):
    with open(dc_file, 'rt') as f:
        lines = f.readlines()
    for l in lines:
        l = l.strip()
        if 'image:' in l and l[0] != '#':
            imgs.append(l.split()[1])
else:
    raise Exception("docker-compose.yml not found!")
# step2 遍历读取Dockerfile中的镜像名称
for root, dirs, files in os.walk(deploy_path):
    for file in files:
        if "Dockerfile" in file:
            with open(deploy_path + "/" + file, 'rt') as f:
                lines = f.readlines()
            for l in lines:
                l = l.strip()
                if "FROM" in l and l[0] != '#':
                    imgs.append(l.split()[1])

imgs = list(set(imgs))

# step3 对step1和step2的镜像进行打包
for i in imgs:
    result = os.popen("docker inspect -f '{{ .Created }}' "+i)
    res = result.read().strip()
    dt = datetime.datetime.strptime(res[:26], "%Y-%m-%dT%H:%M:%S.%f")
    time = dt.strftime("%Y%m%d%H%M%S")
    image_tar = pack_path + i.split("/")[-1]+"_"+time+".tar"
    if not os.path.exists(image_tar+'.gz'):
        cmd = "docker save " + i + " > " + image_tar
        run_cmd(cmd)
        cmd = "gzip " + image_tar
        run_cmd(cmd)
    else:
        print(image_tar+'.gz 已存在!')

自动版本打包工具

执行命令: python version_pack.py,打包后的文件名为:

[部署目录].conf.tar.gz 对应配置文件
[部署目录].init-data.tar.gz 对应初始化数据
[部署目录].run-data.tar.gz 对应运行时数据，如果始化数据及时更新，运行时数据是不需要的(假如开发人员没有及时更新初始化相关脚本，整体拷贝运行时数据可作为临时替代方案)

上述文件的保存目录为./back/version

自动升级工具

执行命令: `python auto_upgrade.py [镜像名]

如果镜像名为空，自动读取./back/image/中所有镜像文件
- 根据时间戳判断是否需要解压还原
- 更新的镜像名记录下来
根据更新的镜像名，查找哪个Dockerfile(格式为Dockerfile-[服务名])包含该镜像，并解析出服务名
- 执行 docker-compose up -d --build 服务名
检查docker-compose.xml中是否包含该镜像名，若存在
- 执行 docker-compose up -d,自动

详见下列代码: