Skip to content

Latest commit

 

History

History
180 lines (122 loc) · 8.12 KB

README.md

File metadata and controls

180 lines (122 loc) · 8.12 KB
Raw

Welcome to LabAC 👋

Version

展示实验室论文成果

基于gin, vue, docker-compose构建网站服务。网站效果图请点击这里查看。

目录

  1. 部署指南
  2. 迁移指南
  3. 开发指南
  4. 技术栈
  5. TODO
  6. 效果图

部署指南

  1. 首先在要部署的机器上安装docker和docker-compose, docker的安装请根据机器系统参考网上的安装教程，docker-compose的安装建议使用 pip安装 (如果docker-compose下载较慢输入下面的代码,切换到豆瓣镜像)。

    pip install -i http://pypi.douban.com/simple/ --trusted-host=pypi.douban.com/simple docker-compose

  2. 从仓库下载源码

    git clone https://github.com/yangsoon/LabAC.git

  3. 如果你想快速搭建网站请 直接跳到第4步 ，但是如果机器上已经 有 了golang1.12和nodejs的环境, 并且 想试着在这个项目基础上进行开发 请继续阅读,否则查看步骤4。

    因为golang官方docker镜像太大，为了减轻镜像下载时网络和机器硬盘空间的压力，后端服务的docker镜像选择基于Scratch构建，所以在启动服务之前请先在本地编译好后端代码。

    同时前端代码是使用vue-cli脚手架编写，build之后的文件没有放在仓库里面。所以如果有node环境，请先自己build。请参考 开发指南。

    具体步骤如下(前提是机器上已经有了golang1.12和nodejs的环境):

    1. 进入labac-gin目录，输入下面指令，会得到labac的可执行文件

      CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o labac .

      编译所生成的可执行文件会依赖一些库，并且是动态链接。在这里因为使用的是 scratch镜像，它是空镜像，因此我们需要将生成的可执行文件静态链接所依赖的库。 --煎鱼的博客

    2. 进入labac-front目录

      npm install
npm run build

  4. 请到release页面下载相关文件,把解压后的labac放在labac-gin文件夹内 ,dist文件放在labac-front文件夹内。

  5. 在启动服务之前，有几个配置项需要配置一下

    1. labac-gin/conf/app.ini文件, 修改JWT_SECRET和[admin]下的值，JWT_SECRET是生成token的密钥请随机输入字母和数字的组合(这里我用了我的学号),而[admin]下的值就是登录网站时使用的用户名和密码。

      RUN_MODE = debug
JWT_SECRET = zy1806311 
...
[admin]
USERNAME = admin
PASSWORD = admin

    2. docker-compose.yml, 将yml文件中的ports端口映射部分改成80:80，docker-compose启动时,如果端口80被占用,可以修改为其他端口, 该选项一般不需要修改。除非出现执行第6步之后出现因为端口被占用导致的无法启动的问题。

      version: "3"
services:
  labac-front:
    image: "nginx:latest"
    volumes:
      - ./labac-front/dist:/usr/share/nginx/html
      - ./compose-conf/nginx.conf:/etc/nginx/conf/nginx.conf
    ports:
      - "80:80"
...

  6. 启动服务,在项目根目录下执行:

    docker-compose up -d

  7. 放进大象，开玩笑的。这时候输入ip就能直接访问了。

迁移指南

如果遇到了机器故障，需要更换机器部署应用，但是又要保证数据一致性的话，请参考下面操作。操作的前提是原本机器上的文件没有损坏，需要保证项目根目录下的resource和db文件完好，这两个文件分别存储着论文PPT资源和redis数据库持久化数据。

  1. 在新机器上下载项目代码
  2. 将原本机器上的resource和db文件拷贝，并覆盖新机器上项目对应的文件。
  3. 查看 部署指南 部署

开发指南

本项目采样前后端分离的形式进行开发。如果需要修改前端代码，请先配置好前端环境，你需要安装nodejs, vue-cli3。后端使用golang1.12，然后用docker-compose部署，下面列出我的开发环境,可以参考一下，前端应该对版本号没有严格的要求。

软件 版本号
node v11.0.0
npm v6.11.3
vue-cli3 v3.11.0
golang v1.12.8
docker v19.03.2
docker-compose 1.24.1

环境配好之后，就可以开发啦。

  1. 前端: 本项目使用前后端分离的方式开发，你需要进入到labac-front目录下面执行npm install安装依赖，因为前后端要分别启动，所以前端启动之前要进入/labac-front/src/store/modules目录下面修改app.js文件中的baseUrl，换成后端的地址。例如http://127.0.0.1:8000

    const app = {
  state :{
      activeMenu: "paper",
      activeTab: "viewPaper",
      editPaper: null,
      baseUrl: "",
  },

    后面就可以执行npm run server启动啦。

  2. 后端启动的时候，进入labac-gin文件夹中执行go run main.go就可以启动，第一次执行的时候会下载依赖，可能比较慢。所有的api逻辑都放在了labac-gin/routers/api/paper.go中，labac-gin/routers/router.go存储着路由的映射关系。后端相关配置项放在了labac-gin/conf/app.ini文件中。

  3. 本项目使用了3个docker容器，nginx容器上放静态文件，并将请求转发给存放后端容器中，redis容器负责存放数据。

  4. 为了方便迁移，将一些相关文件从容器映射到本地，迁移的时候附带这这些文件就行。

技术栈

本项目前端代码使用Element-基于 Vue 2.0 的桌面端组件库构建，后端使用golang编写的web框架gin提供restful api服务, 使用redis存储必要的数据。整个服务使用docker-compose部署。

  1. 前端 vue+vuex+vue-router+axios+element
    1. 既然用vue写前端了，不管用到用不到都要上vue全家桶啦，前端没有什么想说的，基于一个理念就行：简单就是美，其实色彩越单调，结构越简单越好。
    2. 开发的时候，突然发现加入一些好看的图标，能够极大的美化页面，因为element自带的icon种类太少，我就从阿里的icon库里面选择了一些比较好的icon。发现效果确实不错，大家以后也可以使用这上面的图标。
  2. golang(gin)
    1. 后端 golang(gin) 之前一直用python写后端，这次第一次试水了golang,发现写起来并没有很难受，感觉gin写后端很容易上手，并不比flask或者tornado差。
    2. 而且golang的goroutine和channel简直不要太爽(这里没有用到，只是单纯的想夸一下golang)。
    3. 学习的时候，参考的这篇博客,写的很不错。
  3. docker-compose(nginx+golang+redis)
    1. 因为老板想让部署和迁移都比较方便，那就毫无疑问上docker啦，把一些数据映射到宿主机，迁移的时候，把容器映射到宿主机的文件拷贝出来再部署就可以恢复数据了。
    2. 其中我将前端放在nginx容器上，并用nginx做一层反向代理到golang容器中，其实这里的golang并不是一个golang的环境，只是存放了后端编译好的可执行程序。

TODO

  • 添加首页UI和首页可编辑功能

效果图

论文集

编辑-添加

Author

👤 yangsoon

Show your support

Give a ⭐️ if this project helped you!

This README was generated with ❤️ by readme-md-generator