Skip to main content

系统安装教程（简易版）

本系统采用docker部署，简单方便。主要步骤分为两步：

  1. 安装Docker
  2. 使用我们提供的docker-compose.yml运行本系统。
danger

简易版旨在初次上手体验，会失去许多高级功能（如ETL功能），会省略掉许多细节。请勿在生产环境用此流程。

以下是具体步骤：

1. 安装Docker​

请根据官方网站：https://www.docker.com/ 的步骤进行安装.

2. 启动系统​

本系统通过docker compose的方式编排3个镜像文件，分别是本产品、mongodb和clickhouse。

关于docker compose,mongodb,clickhouse的基础知识可网上搜索。

2.1 拷贝以下docker-compose.yml示例，保存在自己电脑的某一个文件夹内​

services:
  app:
    container_name: yiask
    image: docker.1ms.run/chatbi/mini:latest
    pull_policy: always
    restart: always
    ports:
      - '3052:3052'
    volumes:
      - yiask_vol:/usr/src/app/projects/chatbi
    environment:
      - MONGO_URL=mongodb://mongo:27017
      - CLICKHOUSE_URL=clickhouse
      - PROJECT=chatbi
      - CK_USER=user
      - CK_PASS=password
    depends_on:
      - mongo
      - clickhouse
    links:
      - mongo
      - clickhouse
    extra_hosts:
      - "host.docker.internal:host-gateway"
    # command: npm start # 单进程模式

  mongo:
    container_name: yiask_mongo
    restart: always
    image: docker.1ms.run/mongo:8.2
    # environment:
    # - MONGO_INITDB_ROOT_USERNAME=root
    # - MONGO_INITDB_ROOT_PASSWORD=rootPassXXX
    volumes:
      - mongo_vol:/data/db
    # ports:
    #   - '27017:27017'

  clickhouse:
    container_name: yiask_clickhouse
    restart: always
    ulimits:
      nofile: 262144
    image: docker.1ms.run/clickhouse:25.8.11.66
    volumes:
      - ck_vol:/var/lib/clickhouse
    environment:
      - CLICKHOUSE_USER=user
      - CLICKHOUSE_PASSWORD=password
    # ports:
    #   - '9000:9000'
    #   - '8123:8123'

volumes:
  yiask_vol: {}
  mongo_vol: {}
  ck_vol: {}

2.2 运行本系统​

第一步​

使用命令行工具，进入docker-compose.yml同一个目录中

第二步​

运行以下命令：

docker compose up -d
info

初次运行时，系统会从网上拉取镜像。为了保证国内环境的顺利拉取，我们在docker-compose.yml里面指定了国内镜像，地址为docker.1ms.run。 如果想从默认的docker hub处下载，可以把docker-compose.yml中所有image的docker.1ms.run/前缀删除。

第三步​

上述命令成功后，运行以下命令查看系统log：

docker logs -f yiask -n 100

当看到：yiask listening on port 3052!时，代表系统成功运行了。

第四步​

此时浏览器访问http://localhost:3052即可，初始用户名/密码为：admin/12345678

后续更新版本​

命令行进入docker-compose.yml的同一个目录下，再次运行以下命令即可：

docker-compose up -d

系统会自动拉取最新版本并运行。