我们在路上、前方不会太远
- 主分支: develop
- 开发分支: dev-branch
-
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.安装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>/ 木犀个人页
确定每个页面都没有问题之后就可以开始开发了。🐳
-
写单元测试
-
写业务逻辑
-
确保业务逻辑通过单元测试
-
提交Pull Request。在CI通过，负责人Review之后Merge
本应用的测试环境部署在112.74.88.136服务器上。测试域名为muxixyz.test
- Docker相关（仅初次部署需要）
-
编写 muxiwebsite.env
MUXI_WEBSITE_SQL=mysql://<username>:<password>@<url-to-rds>/<database-name> MUXI_WEBSITE_SERVERNAME=muxixyz.test
- 设置本机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发布一次部署
- 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版本预计暑假上线