跳到主要内容
版本:Next

Docker Compose

系统需求

  • 8C16G

  • Docker: v20.x.x+

  • docker-compose: v2.4+

tip

可通过运行 docker -vdocker-compose 来检查查看当前机器是否已经安装。

docker-compose 支持 v2.4 +,请自行至 docker-compose 下载

部署

注意

Docker Compose 方式部署仅供快速体验,请不要用于生产环境 !

  • 克隆存储库

    git clone https://github.com/HXSecurity/DongTai.git
  • 更新代码

    git pull
  • 切换至目录

    cd DongTai/deploy/docker-compose/
  • 部署最新版本

    ./dtctl install
    # 部署指定版本
    # 举例 1.8.0 版, <version> = 1.8.0
    ./dtctl install -v <version>

自定义配置

数据库

使用自定义数据库,请手动修改 config-tutorial.ini 文件内的 mysqlredis 配置后再参照初始化自定义数据库

修改完成后,在下述的部署过程选择 -s 略过相应的组件:

./dtctl install -v 1.4.0 -s mysql
  • s: 跳过的资源 (skip), 可选: mysql redis mysql,redis,默认:不跳过
  • v: 需要被安装的版本
域名访问

需要使用 HTTPS 域名访问的用户, 可通过修改 config-tutorial.ini 文件,增加如下配置,实现 CSRF 信任域名的配置,如:https://xxx.example.com,配置如下:

[security]
csrf_trust_origins = .example.com
  • 若有多个 HTTPS 域名进行绑定,域名间通过 "," 连接,如:.example.com, .iast.io, .dongtai.io
SCA 配置

需要使用离线 SCA 配置的用户,可按以下三个步离线添加配置:

  1. 下载 SCA 数据库文件:

    wget https://huoqi-public.oss-cn-beijing.aliyuncs.com/iast/sql/sca20220114.sql
  2. 执行导入命令:

    cat sca20220114.sql | mysql -u<username> -h<url> -p --default-character-set=utf8mb4 dongtai_webapi
  3. 修改 config-tutorial.ini 文件, 配置如下:

    [SCA]
    base_url = http://dongtai-openapi:8000/sca/v1
扩容

💡:先使用 ./dtctl file 导出 docker-compose.yml,再使用 docker-compose 执行扩容

服务节点

  • 使用以下命令将 dongtai-image 数量扩容到 number

    sudo docker-compose -p dongtai up –-scale {dongtai-image}=<number> -d
  • 例子:扩容 4 个 dongtai-worker-task

    sudo docker-compose -p dongtai up --scale dongtai-worker-task=4 -d

升级

升级配置,可直接升级至最新版本或是指定版本。

  • 更新代码

    git pull
  • 执行更新

    # 更新成最新发布版本
    ./dtctl upgrade
    # 升级至指定版本,t: to version
    ./dtctl upgrade -t <version>
自定义数据库升级流程

部署时自定义数据库的用户不适用 ./dtctl upgrade,请参照下列升级流程:

  • DongTai/deploy/docker-compose 创建 docker-compose.yml 文件。

  • docker-compose.yml 样本 中的 {ChangeThisVersion} 替代成需要升级版本号

    tip
    • DongTai/deploy/latest_image.sh 可以查询到目前所有镜像最新的版本号。

    • 若宿住机的 port 有修正,请自行调配,预设为 80

  • 在同目录下执行下列命令:

    docker-compose -p dongtai up -d
  • 最后,参照初始化自定义数据库导入初始库,只需导入增量的数据库文件即可。

    如:1.3.1 升级,只需导入 update-20220316-release-1.4.0.sql

卸载

  • 卸载配置

    ./dtctl rm -d
    # d : 改选项会让数据和服务一起被删除
部署后

环境启动成功后,通过部署过程中指定的 web service port 访问即可。

  • 默认账号及密码: admin / admin;

  • 首次登入 必须 修改密码。

    • 系统配置 > 密码修改 修改密码后再重新登入。

演示

Image