本地环境配置(Docker)

视频教程

A BiliBili video

注意

使用本框架需掌握以下知识，遇到相关问题请自行搜索学习，或者加入会员进入学习社区学习，我们不提供其他项目的免费学习资料：

• [必须熟悉] Go Zero
• [必须熟悉] Docker
• [必须熟悉] Vben Vben源码
• [必须熟悉一种数据库] Mysql 或 PostgreSQL
• [必须学习] Ent 入门

开发环境配置

启动 Core 后端服务

将下面的 docker-compose 代码保存为 docker-compose.yaml

version: "3"

volumes:
  postgresql:
  redis:

networks:
  simple-admin:
    driver: bridge

services:
  postgresql:
    image: bitnami/postgresql:latest
    container_name: postgresql
    restart: always
    ports:
      - "5432:5432"
    environment:
      POSTGRESQL_DATABASE: "simple_admin"
      POSTGRESQL_PASSWORD: "simple-admin."
    volumes:
      - postgresql:/bitnami/postgresql
    networks:
      simple-admin:
        aliases:
          - postgresql-server
    deploy:
      resources:
        limits:
          cpus: "0.5"
          memory: 1000M
        reservations:
          cpus: "0.05"
          memory: 200M

  redis:
    image: redis:7.2-alpine
    container_name: redis
    restart: always
    ports:
      - "6379:6379"
    volumes:
      - redis:/data
    networks:
      simple-admin:
        aliases:
          - redis-server
    deploy:
      resources:
        limits:
          cpus: "0.5"
          memory: 500M
        reservations:
          cpus: "0.05"
          memory: 200M

  core-rpc:
    image: registry.cn-hangzhou.aliyuncs.com/simple_admin/core-rpc-docker:v1.7.6
    container_name: core-rpc
    restart: always
    ports:
      - '9101:9101'
    networks:
      simple-admin:
        aliases:
          - core-rpc
    deploy:
      resources:
        limits:
          cpus: "0.5"
          memory: 500M
        reservations:
          cpus: "0.05"
          memory: 200M

  core-api:
    image: registry.cn-hangzhou.aliyuncs.com/simple_admin/core-api-docker:v1.7.6
    container_name: core-api
    restart: always
    #    environment:
    #      I18N_DIR: ''
    #      AUTH_SECRET: 'jS6VKDtsJf3z1n2VKDtsJf3z1n2'
    ports:
      - "9100:9100"
    networks:
      simple-admin:
        aliases:
          - core-api
    volumes:
      - ./api/etc:/app/etc
    deploy:
      resources:
        limits:
          cpus: "0.5"
          memory: 500M
        reservations:
          cpus: "0.05"
          memory: 200M

注意

若文档内的部署代码版本号不是最新的，请自行修改为最新版本

然后在文件夹目录执行

docker compose up -d

即可启动仅包含 Core 服务的服务端，

运行后台 UI

下载 Vben5 UI 代码

git clone https://github.com/suyuan32/simple-admin-vben5-ui.git

cd simple-admin-vben5-ui

pnpm install

pnpm dev

访问 http://localhost:5666/init 选择初始化核心数据库即可

提示

若想查看多模块部署例子，可以访问 GitHub

项目部署

相关信息

A BiliBili video

对于模块来说只需执行以下命令即可生成镜像

make build-linux

make docker

对于后台 UI 则执行下面的命令即可构建镜像

make docker

构建完成镜像后将 docker compose 内的镜像替换为自己的镜像即可

配置注意事项

注意

1. 模块内的 Rpc 配置参考 go zero 配置 Rpc 地址，否则系统无法正常工作
2. UI 需配置反向代理, 需修改 scripts/deploy/nginx.conf
3. 可以将配置文件挂载到外部文件系统，可以动态配置，或者直接打包到镜像里面