文档作者: HITwh Vegetable Group :: ArHShRn

知识版权 Copyright 开源许可 License

文档：版权 ® HITwh很菜的小组 2019

源码（前端、后端Shell以及配置文件）：GNU AGPL v3.0 - 非商业用途、采用开源

Documents: Copyright ® HITwh Vegetable Group 2019

Source Code(Frontend, Backend Shells and Configs): GNU AGPL v3.0 - Noncommercial, Open Source

版权许可 - 中文

本作品文档采用知识共享 署名-非商业性使用-相同方式共享 4.0 国际 许可协议进行许可。

要查看该许可协议，可访问 http://creativecommons.org/licenses/by-nc-sa/4.0/ 或者写信到 Creative Commons, PO Box 1866, Mountain View, CA 94042, USA。

Copyright License - English

Documents containing in this work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

软件工程课程设计 - 简易校园边缘计算平台 - 哈小微容器云

注意：此项目仍在开发中

Caution: This project is still under development

• 这是一个大学课程设计项目，Github仅用作版本控制，请在投入实际应用前仔细考虑。

• This project is a college Course Design, putting it on Github is only for Revision Control purpose. Consider carefully before applying it in your projects.

• 项目（包括所有文档）仅中文。

• The whole project (including docs) supports only Chinese.

简介

这是大学第三年软件工程课程设计项目：《简易校园边缘计算平台》 *

此项目旨在探究边缘计算的简单基础运用，尝试将学校各种服务例如

• 教务系统
• 招生系统

等边缘化、高可用化，提升信息的处理速度与效率。

希望解决的问题

• 选课以及成绩查询高峰期的时候系统的卡顿
• 防止因为突发情况导致主要服务器宕机而造成的服务不可用

希望达成的目标

• 容器化以简化服务的部署并最大兼容所有服务：可以随时简单地部署任何服务
• 和 HQSE 小组设计的《新生入学迎新系统》合作，演示此边缘计算平台的高弹性、高可用等特性

更野心的目标

• 将每位同学的软件工程课程设计项目都尝试部署到此平台
• 组建校内云，为同学提供自学服务，或者为同学们提供测试自己课设的平台
• 得益于边缘计算，学校可以设计自己的校内大数据app实时处理同学们日常活动产生的大数据，组建智慧校园

*由于资源限制，此平台集群演示环境搭建于腾讯云学生机而非校内服务器，网络因素可能会造成平台运行缓慢

特点

• Edge Computing 边缘计算 *

• Docker + Kubernetes + Etcd 高可用

• Server Clusters 服务器集群

• Ansible 自动化部署

• Appveyor 持续集成 *

*由于资源限制，此平台集群演示环境搭建于腾讯云学生机而非校内服务器，网络因素可能会造成平台运行缓慢

*Appveyor 持续集成仅适用于前端，目的是想邀请更多同学维护此项目

运行环境

Ubuntu 16.04.6 LTS x3

合并分支与保持分支同步的正确操作

警告：此过程操作失误将会导致版本库混乱，更严重的话需要重建远程仓库

• 任何情况下未经所有组员同意不得对Master分支进行操作

合并分支

如果不知道 -no-ff squash rebase等的用法，请一定遵循以下步骤合并分支

• 任何情况下未经所有组员同意不得对Master分支进行操作

• 合并的时候不要用git bash，不要用任何桌面GUI应用程序

1. 提交自己分支的所有 commit 并 push 到远程仓库

2. 在需要合并的分支上打开一个Pull Request，此后不要点击 Merge 按钮

   （由于小组每个成员都是协作者，所以每个成员都能够 Merge Pull Request）

3. 在群里通知自己已经提交了PR准备合并

4. 组内成员对PR进行Review并处理冲突，决定是继续修改还是可以合并

5. 如果可以合并的话，PR提交者再上PR点击Merge按钮合并到其他分支

个人分支与Dev分支保持同步

• Master分支始终存放最稳定版本，所有个人分支均合并到Dev分支

• 如果不知道Mergy的用法不要直接把Master合并到其他分支，此过程操作失误将会导致HEAD指针偏离主线导致版本库和时间线混乱，更严重的话需要重建远程仓库

• 千万不要在 Github Desktop 上点击 Choose a branch to merge into xxx

• 任何情况下未经所有组员同意不得对Master分支进行操作

1. 参考 合并分支 将个人分支合并到 Dev
2. 删除个人分支
3. 本地仓库 checkout 到 dev 分支并重命名为个人分支
4. push 到远程仓库

成员协作

Git 常用指令速查表

Git Recipes 高质量的Git中文教程

git-recipes forked from git-recipes