Skip to content

快速体验

本章节中,将通过已经发布的docker镜像帮助您完成体验

准备工作

  1. 确保网络通畅,能够正常访问互联网。可以通过配置国内源,加快镜像下载速度。
  2. 安装Docker服务。
    • 设置Yum源。
      shell
      yum install -y yum-utils
      yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
    • 安装Docker Engine,containerd,以及Docker Compose。
      shell
      yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    • 启动Docker服务并设置为开机自启。
      shell
      systemctl start docker
      systemctl enable docker
  3. 创建映射目录。
    shell
    mkdir -p /opt/lite/mysql/conf /opt/lite/mysql/data /opt/lite/redis/data /opt/lite/redis/config /opt/lite/minio/data
  4. 任意目录创建docker-compose.yml文件,并写入以下内容。
    yaml
    version: '3.8'
    services:
      mysql:
        image: mysql:8.3.0
        ports:
          - 3306:3306
        volumes:
          - /opt/lite/mysql/conf/mysql.cnf:/etc/mysql/conf.d/mysql.cnf 
          - /opt/lite/mysql/data/:/var/lib/mysql/
        privileged: true
        environment:
          - MYSQL_ROOT_PASSWORD=Abc123++
          - MYSQL_DATABASE=iking_framework
          - TZ=Asia/Shanghai
        restart: always
        container_name: mysql
        command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
        healthcheck:
          test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
          interval: 10s
          timeout: 5s
          start_period: 60s
    
      redis:
        image: redis:7.2.4
        ports:
          - 6379:6379
        volumes:
          - /opt/lite/redis/data:/data
          - /opt/lite/redis/config/redis.conf:/usr/local/etc/redis/redis.conf
        privileged: true
        restart: always
        container_name: redis
        command: redis-server --requirepass Abc123++ --appendonly yes --notify-keyspace-events Ex
        healthcheck:
          test: ["CMD", "redis-cli", "ping"]
          interval: 30s
          timeout: 20s
          start_period: 60s
    
      minio:
        image: minio/minio:RELEASE.2024-01-31T20-20-33Z
        ports:
          - 9000:9000
          - 9090:9090
        volumes:
          - /opt/lite/minio/data:/data
        privileged: true
        environment:
          - MINIO_ROOT_USER=minio
          - MINIO_ROOT_PASSWORD=Abc123++
        restart: always
        container_name: minio
        command: server /data --console-address ":9090" -address ":9000"
        healthcheck:
          test: ["CMD", "curl", "-f", "http://127.0.0.1:9000/minio/health/live"]
          interval: 30s
          timeout: 20s
          start_period: 60s
    
      lite:
        image: ikingtech/lite:1.1.5
        ports:
          - 8000:8000
        privileged: true
        environment:
          - SRV_PORT=8000
          - MYSQL_HOST=172.17.0.1
          - MYSQL_PORT=3306
          - MYSQL_SCHEMA_NAME=iking_framework
          - MYSQL_USERNAME=root
          - MYSQL_PASSWORD=Abc123++
          - REDIS_HOST=172.17.0.1
          - REDIS_PORT=6379
          - REDIS_DB=1
          - REDIS_PASSWORD=Abc123++
          - OSS_ENABLED=true
          - OSS_STORAGE_TYPE=AWS_S3
          - OSS_HOST=http://172.17.0.1:9000
          - OSS_ACCESS_KEY=minio
          - OSS_SECRET_KEY=Abc123++
          - OSS_DEFAULT_BUCKET=iking
          - OSS_REGION=us-east-1
        restart: always
        container_name: lite
        depends_on:
          - mysql
          - redis
          - minio
    
      ui:
        image: ikingtech/lite-ui:1.1.5
        ports:
          - 80:80
        privileged: true
        restart: always
        container_name: lite-ui

安装

  1. 进入docker-compose.yml文件所在目录,执行启动命令,并等待完成。
    shell
    docker compose up -d
  2. 启动完成后,执行以下命令确认所有容器启动成功。
    shell
    docker ps -a
  3. 浏览器中输入您的服务器IP地址即可访问平台。

💡 特别说明:

  1. 如果您的运行环境中已安装了数据库/缓存/对象存储服务等组件,您需要从docker-compose.yml文件中删除相应部分。例如,您的环境中已安装了MySQL数据库,那么从docker-compose.yml中移除以下部分的内容:
    yaml
      mysql:
        image: mysql:8.3.0
        ports:
          - 3306:3306
        volumes:
          - /opt/lite/mysql/conf/mysql.cnf:/etc/mysql/conf.d/mysql.cnf 
          - /opt/lite/mysql/data/:/var/lib/mysql/
        privileged: true
        environment:
          - MYSQL_ROOT_PASSWORD=Abc123++
          - MYSQL_DATABASE=iking_framework
          - TZ=Asia/Shanghai
        restart: always
        container_name: mysql
        command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
        healthcheck:
          test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
          interval: 10s
          timeout: 5s
          start_period: 60s

相应的,您还需要将服务启动时的环境变量进行修改。仍以MySQL为例,您需要将环境变量MYSQL_HOSTMYSQL_PORTMYSQL_SCHEMA_NAMEMYSQL_USERNAMEMYSQL_PASSWORD修改为您的数据库的信息。
所有环境变量的说明请参考以下列表:

变量说明
SRV_PORT服务运行端口
MYSQL_HOST数据库服务地址
MYSQL_PORT数据库服务端口
MYSQL_SCHEMA_NAME数据库名,默认iking_framework
MYSQL_USERNAME数据库服务用户名
MYSQL_PASSWORD数据库服务密码
REDIS_HOSTRedis服务地址
REDIS_PORTRedis服务端口
REDIS_DBRedis DB号
REDIS_PASSWORDRedis密码
OSS_ENABLED是否启用文件服务
OSS_STORAGE_TYPE对象存储服务类型,目前仅支持AWS_S3类型
OSS_HOST对象存储服务地址,格式为http://ip:port
OSS_ACCESS_KEY对象存储服务AccessKey
OSS_SECRET_KEY对象存储服务SecretKey
OSS_DEFAULT_BUCKET默认桶名称
OSS_REGION桶所在区域标识
  1. 服务默认使用iking_framework作为数据库名称,请确保您的数据库实例中没有同名的数据库。如果您希望自定义数据库名,请修改docker-compose.yml文件中的相应配置。
  2. 如果您仅需要启动平台服务,无需额外安装数据库/缓存/对象存储服务,则执行以下命令即可。
    • 前端
      shell
      docker run -d -p 80:80 --restart=always --name=lite-ui --privileged=true ikingtech/lite-ui:1.1.5
    • 后端
      shell
      docker run -d --name lite -p 8000:8000\
       -e SRV_PORT=8000\
       -e MYSQL_HOST=${数据库服务地址}\
       -e MYSQL_PORT=${数据库服务端口}\
       -e MYSQL_SCHEMA_NAME=${数据库名称}\
       -e MYSQL_USERNAME=${数据库服务用户名}\
       -e MYSQL_PASSWORD=${数据库服务密码}\
       -e REDIS_HOST=${Redis服务地址}\
       -e REDIS_PORT=${Redis服务端口}\
       -e REDIS_DB=${Redis DB号}\
       -e REDIS_PASSWORD=${Redis服务密码}\
       -e OSS_ENABLED=true\
       -e OSS_STORAGE_TYPE=AWS_S3\
       -e OSS_HOST=${对象存储服务地址,格式为http(s)://ip:port}\
       -e OSS_ACCESS_KEY=${对象存储服务AccessKey}\
       -e OSS_SECRET_KEY=${对象存储服务SecretKey}\
       -e OSS_DEFAULT_BUCKET=${默认桶名称}\
       -e OSS_REGION=${桶所在区域标识}\
       --restart=always\
       ikingtech/lite:1.1.5