木犀内网项目

我们在路上、前方不会太远

状态

当前状态: 开发中

分支

主分支: develop
开发分支: dev-branch

开发前准备

0⃣️Git工作流

fork 项目仓库

在github上fork这个仓库
clone fork的项目仓库

$ git clone https://github.com/<your_username>/muxi_site.git

从develop分支开出功能分支(以feature为例) 注意⚠️ : develop分支为主分支！！！

git checkout develop
git checkout -b <feature>

在feature分支进行功能开发

写写写写写..............代码

本地调试

确保代码修改可以在本地调试通过

向feature分支提交

请提交时只提交改动的文件，并写好commit信息

在Github 上向develop分支发送pull request

创建PR之前仔细检查更改的文件！

merge，发布版本，进行部署(项目维护人负责)

merge 之前仔细检查更改的文件！

1⃣️本地环境搭建

1.安装Flask

教程: Flask

2.安装扩展环境

进入虚拟环境(还是请参见教程)

$ pip install -r requirment.txt

下载速度较慢时的解决方案：
- 切换为豆瓣源：
```
pip install --index-url http://pypi.doubanio.com/simple/ -r requirements.txt --trusted-host=pypi.doubanio.com
```
- 终端代理(proxychains + shadowsocks): ProxyChains-NG

3.设置测试域名

打开hosts文件
```
$ sudo vim /etc/hosts
```

设置测试域名,在文件后面添加

127.0.0.1 blog.muxixyz.dev
127.0.0.1 share.muxixyz.dev
127.0.0.1 book.muxixyz.dev
127.0.0.1 auth.muxixyz.dev
127.0.0.1 profile.muxixyz.dev
127.0.0.1 i.muxixyz.dev

4.设置环境变量

打开.bashrc(或.zshrc)
```
$ vim ~/.bashrc(~/.zshrc)
```

设置环境变量,在文件后添加

set MUXI_WEBSITE_SERVERNAME
export MUXI_WEBSITE_SERVERNAME="muxixyz.dev:5000"

重新加载配置文件
```
$ source ~/.bashrc(~/.zshrc) 
```

5.构建本地测试数据库

初始化
```
$ python manage.py db init
```

数据库已存在

$ python manage.py db migrate; python manage.py db upgrade

6.创建用户角色

$ python manage.py insert_roles

7.运行项目测试

python manage.py runserver

当前路由:

i.flask.dev:5000/  木犀官网
book.flask.dev:5000/ 木犀图书
share.flask.dev:5000/ 木犀分享
blog.flask.dev:5000/ 木犀博客
profile.flask.dev:5000/<int: id>/ 木犀个人页

确定每个页面都没有问题之后就可以开始开发了。🐳

2⃣️本地开发流程

写单元测试
写业务逻辑
确保业务逻辑通过单元测试
提交Pull Request。在CI通过，负责人Review之后Merge

3️测试环境部署

本应用的测试环境部署在112.74.88.136服务器上。测试域名为muxixyz.test

Docker相关（仅初次部署需要）

编写 muxiwebsite.env

MUXI_WEBSITE_SQL=mysql://<username>:<password>@<url-to-rds>/<database-name>
MUXI_WEBSITE_SERVERNAME=muxixyz.com
ZAODU_URL=

设置本机Hosts解析（仅初次部署需要）

在本机的hosts文件中加入：

    112.74.88.136 blog.muxixyz.test
    112.74.88.136 share.muxixyz.test
    112.74.88.136 book.muxixyz.test
    112.74.88.136 auth.muxixyz.test
    112.74.88.1361 profile.muxixyz.test
    112.74.88.136 i.muxixyz.test

在服务器上该仓库目录下git pull origin develop拉取最新代码，并运行：
```
$ docker-compose build;docker-compose up
```
初始化数据库（仅初次部署需要）

在服务器上运行：

   $ docker exec <container id> python manage.py db init
   $ docker exec <container id> python manage.py db migrate
   $ docker exec <container id> python manage.py db upgrade
   $ docker exec <container id> python manage.py insert_roles

迁移数据库（如果后续部署中修改了数据模型结构）

在服务器上运行：

   $ docker exec <container id> python manage.py db migrate
   $ docker exec <container id> python manage.py db upgrade

等待提测，通过测试之后正式在MAE发布一次部署

ToDo

RESTful API

进度

2015年10月19号: 木犀图书测试版1.0上线，1.0+正在修bug
-----------------------------------------------------
2015年10月19日: 木犀分享完成基本功能，下一步整合markdown编辑器和优化
-----------------------------------------------------
2015年10月20日: 木犀分享完成分页功能、权限管理
-----------------------------------------------------
2015年10月22日: 总结此仓库的合作方式(前后端)，因为有点混乱有点烦
-----------------------------------------------------
2015年10月23日: 完成博客数据库model编写, master<->development
-----------------------------------------------------
2015年11月5日 : 木犀分享基本功能完成，待前端修改相关样式
-----------------------------------------------------
2015年11月7日 : 编写data脚本，自动构建本地测试数据库
-----------------------------------------------------
2015年11月9日 : 新的开发分支 develop 替代 development
-----------------------------------------------------
2015年11月16日: 编写统一后台管理界面
-----------------------------------------------------
2015年11月18日: 完成统一后台管理
-----------------------------------------------------
2015年11月20日: 完成木犀分享hot板块(排序)
-----------------------------------------------------
2015年12月15日: 整合木犀博客(基本完成)
-----------------------------------------------------
2015年12月24日: 完成木犀博客的归档，添加profile个人页
-----------------------------------------------------
2016年1月13日: ISSUE 认领, 最后清扫工作开始
-----------------------------------------------------
2016年1月15日: 编写官网分享API: 木犀内外开始😄
-----------------------------------------------------
2016年1月17日: 完成木犀内外API, close掉了一系列的ISSUE
-----------------------------------------------------
2016年2月1日: 集成木犀个人信息修改页
----------------------------------------------------

2016年5月25日：设置子域名,新的主分支develop代替master,开发分支dev-branch代替develop ---------------------------------------------------- 2016年7月7日: 木犀分享、图书、个人页更新完成 ---------------------------------------------------- 2016年11月1日: Docker部署 ---------------------------------------------------- 2017年6月1日: 向微服务架构迁移，2.0版本预计暑假上线

Muxi-X/muxi_site

木犀内网项目

状态

当前状态: 开发中

分支

开发前准备

0⃣️Git工作流

1⃣️本地环境搭建

2⃣️本地开发流程

3️测试环境部署

ToDo

进度