改目录结构已经重构,部署方式更简洁,最新参考: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证书目录
- .env: 定义
- init-data: 初始化的数据,如数据库脚本、程序加载时的初始数据等
- run-data: 运行过程中的数据,如数据库存储目录,程序的临时文件目录
- log: 程序日志目标
- back: 程序备份目录
- auto_pack.py/auto_pack.sh: 自动打包工具
- auto_upgrade.py/auto_upgrade.sh: 自动升级工具
- **conf
自动镜像打包工具
执行命令: 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
,自动
- 执行
详见下列代码: