GS Admin

地址：Demo
文檔：地址

GS Admin=gin+gorm+scui 它是golang 開發的一個企業級後台。遵循MIT開源協議。前端框架是scui,SCUI基於 Vue3、elementPlus 持續性的提供獨家組件和豐富的業務模板幫助你快速搭建企業級中後台前端任務。後端框架是gin,Gin是一個golang的微框架，封裝比較優雅，具有快速靈活，容錯方便等特點。內置了權限管理、用户管理等基礎模塊兒，還支持了事件服務，方便業務解耦。後續會根據用户的反饋更新內容！

docker-compose(dev)

前置準備

1、Docker環境的部署

資料：https://www.runoob.com/docker/ubuntu-docker-install.html

2、docker-compose安裝

資料：https://www.runoob.com/docker/docker-compose.html

一鍵啓動

cd ${根目錄}/deploy/docker-compose

docker-compose -f docker-compose-dev.yaml up #啓動

docker-compose -f docker-compose-dev.yaml up -d # 後台啓動

docker-compose -f docker-compose-dev.yaml down # 停止並刪除容器

docker-compose -f /docker-compose-dev.yaml stop # 停止容器

文件説明:docker-compose-dev.yaml

version: "3"

# 聲明一個名為network的networks,subnet為network的子網地址,默認網關是177.7.0.1
networks:
  network:
    ipam:
      driver: default
      config:
        - subnet: '177.7.0.0/16' #佔用的網段

services:
  web:
    image: node:latest
    container_name: gsadmin-web
    hostname: gsadmin-web           #可以通過容器名訪問
    restart: always
    ports:
      - '8081:8080'
    depends_on:
      - server
    working_dir: /web       # 如果docker 設置了workdir 則此處不需要設置
    #若網絡不太好，請自行換源，如下
    #command: bash -c "yarn config set registry https://registry.npm.taobao.org --global && yarn install && yarn serve"
    command: bash -c "npm install && npm run serve"
    volumes: #目錄掛載
      - ../../web/scui:/web
    networks: #聲明網絡
      network:
        ipv4_address: 177.7.0.11

  server:
    image: golang:1.17 
    container_name: "gsadmin-server"
    hostname: gsadmin-server
    restart: always
    ports:
      - '8080:8080'
    depends_on: #依賴
      - mysql
    volumes:
      - ../../service:/service
    working_dir: /service    # 如果docker 設置了workdir 則此處不需要設置 
    command: bash -c "go env -w GOPROXY=https://goproxy.cn,direct && go mod tidy && go run main.go"
    links:
      - mysql
    networks:
      network:
        ipv4_address: 177.7.0.12

  mysql:
    image: mysql:8.0.21    # 如果您是 arm64 架構：如 MacOS 的 M1，請修改鏡像為 image: mysql/mysql-server:8.0.21
    container_name: gsadmin-mysql
    hostname: gsadnub-mysql
    command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --default-authentication-plugin=mysql_native_password
    restart: always
    ports:
      - "3306:3306"  # host物理直接映射端口為13306
    environment:
      MYSQL_ROOT_PASSWORD: '123456' # root管理員用户密碼
      MYSQL_DATABASE: 'gsadmin' # 初始化啓動時要創建的數據庫的名稱
      MYSQL_USER: 'gsadmin'
      MYSQL_PASSWORD: '123456'
    volumes:
      - /home/docker/mysql:/var/lib/mysql
    networks:
      network:
        ipv4_address: 177.7.0.13

初始化數據

• 初始化數據 {項目目錄}/service/databases/*.sql 執行裏面的sql

其它問題

• 前端的項目注意修改端口和容器映射端口保持一致
• 前端反向代理位置注意修改地址
• 服務端數據配置
• 服務端口要和容器相同

交流方式

QQ交流羣：584407821 (1羣)

微信羣：加個人微信後，拉入
備註：gsadmin 無備註不通過

加入貢獻

GS Admin 是一個開源項目，一個開源項目的發展離不開開源社區的力量支持，如果您希望參與 GS Admin 的開發，可以先從 issues (opens new window)開始，通常來説會有以下的一些步驟：

• 1.關注 issues (opens new window)的動態，評論回覆幫助提出疑問的用户；
• 2.根據 issues (opens new window)的內容，找尋根據自己當前對項目的瞭解程度，去修復力所能及的 BUG 或實現功能，並以 Pull Request 的形式提交至 kevn/gsadmin (opens new window)倉庫；
• 3.關注自己提交 Pull Request 的進度和狀態，以推動您的 Pull Request 儘快合入主倉庫；
• 4.對其他人提交的 Pull Request 進行 Code Review，並給出您的建議和看法。
• 5.堅持並持續進行上述步驟。