跳到主要内容
版本：5.0.0

Docker 手把手部署文档

这是一篇手把手来指导使用 Docker 部署文档，同时也是解释Docker 部署 Zealot 指南的分解

版本列表​

  • 稳定版本 - 5.2.3/latest - ghcr.io/tryzealot/zealot:latest
  • 测试版本 - develop - ghcr.io/tryzealot/zealot:nightly - 基于 develop 分支每次提交构建的版本

镜像仓库​

步骤解析​

安装 Docker​

按照官方教程安装

安装 Docker-Compose​

按照官方教程安装

生成 .env 配置文件​

从预先 config.env 配置文件复制一份部署使用的配置文件

配置域名​

二次校验如果没有配置会再提醒

配置证书​

部署脚本提供三种方式，就算使用最后一种生成的也是 https 的协议头

  • 使用 Let's Encrypt 证书
  • 使用自签名证书
  • 纯 Zealot 服务（需反代网关或负载均衡生成 SSL 证书）

生成 docker-compose.yml​

配置文件会生成至少四个服务（service），使用上面前两个证书方式会额外增加一个服务：

  • zealot-zealot: 核心 Web 和 API 服务
  • zealot-worker: 核心异步任务服务
  • zealot-postgres: 数据库服务
  • zealot-redis: 缓存服务
  • zealot-web: 提供（服务和证书）反代的网关服务，非必需

创建持久化存储的 docker volumes​

存储持久化数据

  • zealot-data: 静态资源，JS、CSS、图片以及上传的应用、应用图标和调试文件
  • zealot-postgres: 数据库数据
  • zealot-redis: 缓存数据

拉取（更新）镜像​

第一次使用会自动从容器镜像服务网站下载镜像，后续是更新操作，通常只会更新 zealot 镜像。其他几个依赖服务镜像都是固定版本号

docker-compose pull

设置数据库数据​

第一次使用会初始化数据库、加载范例应用数据和设置管理员账号，后续这是因 zealot 更新需要的操作

docker-compose run --rm zealot run_upgrade

运行 docker-compose​

为了安全期间和用户的自定义操作需要手动执行来运行服务:

docker-compose up -d

高级配置​

自定义 volume 路径​

自定义路径有两种方法: (假设自定义的路径是 /data/zealot)

1. 创建 volume 自定义路径​

docker volume create --name zealot-data \
  --opt type=none \
  --opt o=bind \
  --opt device=/data/zealot/zealot-data

docker volume create --name zealot-redis \
  --opt type=none \
  --opt o=bind \
  --opt device=/data/zealot/redis

docker volume create --name zealot-postgres \
  --opt type=none \
  --opt o=bind \
  --opt device=/data/zealot/postgres

2. 修改 docker-compose 的 volumes 部分​

打开 docker-compose.yml 拉到最底部找到 volumes: 开头的部分，修改为如下内容：

volumes:
  zealot-data:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /data/zealot/data
  zealot-redis:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /data/zealot/redis

  zealot-postgres:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /data/zealot/postgres