flask项目实现自动化部署

Flask的优点：

1.简单。flask是主要应对小型或者快速构建的项目，故没有像Django那样大而全，集成了很多的组件，不管你是否用没用得到。如果说Django是一个精装的房子，那么flask就是毛胚房。使用Django的项目，大部分的布局等都是相似的，因为已经装修完毕了，大同小异。而使用flask的话，如何装修，如何设计都是自己搞定的，所以每个flask项目的相异性较大。

2.使用简单。官方的使用指南清晰的介绍了Flask的运行过程。官方指南（中文版）

3.部署简单。本地运行不需要安装其他的软件，只需要python基本的环境（一般来说：本地测试直接运行即可）。如需要在服务器上运行，以支撑起整个项目，则需要配置uwsgi+nginx。因为需要考虑到并发性、异步性（尽管可以在启动run()里加入一些参数实现异步）。

Flask的安装

Flask安装教程（包含多种安装方式），建议不要直接pip,而是先安装：虚拟环境创建工具virtualenv，为每一个项目创建一个虚拟环境，这样不会引起版本冲突。

pip install virtualenv ---安装虚拟环境

cd your_project_dir ---进入你的项目目录

virtualenv venv---创建目录名（自定义）,在venv文件夹中，包含了python的可执行文件，以及pip库的拷贝，这样就可以安装flask包了，前提是激活该项目的虚拟环境，否则还是会安装在系统环境下

source venv/bin/activate ---激活虚拟环境

服务器上配置：

uwsgi+nginx配置，如果不使用Nginx也是可以实现项目的运行支撑的，但是Nginx可以保证负载均衡（如果有多个运行项目的话）以及安全性。一般配置nginx作为前端代理，uwsgi作为后端代理，其实这样称呼并不准确，但只是相对的。nginx用来处理静态请求，若是动态请求由nginx转发至uwsgi进行处理。具体作用见：NgInx的作用。

先安装uwsgi,可直接pip系统安装，或者在虚拟环境中安装；

pip install uwsgi

    在你的项目根目录下创建一个uwsgiconfig.ini(uwsgi支持多种配置文件格式:ini、xml、json等)，其实不是必须在根目录下创建，只要能找到该文件并启动即可，在根目录下创建是方便修改。

image

Nginx安装：参考：nginx安装及基本操作语法

    nginx的配置文件：可能存在大量的注释，我们需要放开注释并且可能进行修改；这里就不全部显示了，仅介绍主要的配置：

image

    只要我们把代码上传到服务器上，运行uwsgiconfig.ini文件，即可让我们的flask项目运行，并能向前提供服务。但在开发过程中，我们每次修改代码或者新增功能并且在本地测试好了之后，想要通过公网访问我们的修改的或者新增的功能，就得把当前改变上传到服务器上，并且重新启动uwsgi服务器。这样每次代码有改动，都得先上传到服务器，再重新启动uwsgiconfig.ini文件，很是麻烦，所以我们期望找到一种自动化的工具，能帮我们自动上传代码，重新启动uwsgi服务器，jenkins就是我们所需要的工具。

代码托管平台：github、coding、Bitbucket等：

   也就是将你的项目放在托管平台上进行托管，方便协作开发，代码集成。这里是用了coding做说明，后面将说明coding的一些配置。

jenkins持续集成：

jenkins安装配置：

注意jenkins是基于java的，所以需要jdk环境并且在jenkins配置文件中设置。

service jenkins start ---启动jenkins

在浏览器输入 http://公网ip: 8080 （默认）访问jenkins页面(php界面)。

1.安装jenkins需要的插件: 系统管理->插件管理->可选插件->右上角搜索:

*coding_webhook*插件通过与coding上的项目的hook建立链接，当coding上代码有更新时，jenkins也会进行更新；*publish_over_ssh*插件是用来实现远程部署。

image

image

2.系统配置：

      首先，在服务器上生成公钥：ssh-keygen -t rsa  ；按3个回车，密码为空。默认会在 ~/.ssh目录生成两个文件：id_rsa私钥，id_rsa.pub公钥。known_hosts文件会记录ssh密钥登陆的主机列表。

      接着，在系统管理->系统配置的publish_over_ssh中：

image

   在remote_directory下面的高级中：

image

然后保存即完后ssh的配置；

构建项目：

新建任务->:

image

基础设置：

image

源码管理：

image

触发器构建：

image

触发器构建时，需要配置coding上的webhook:

image

触发器设置：

image

构建环境：不做任何改变

构建：

选择增加构建后操作,方式选择SSH，目的是为了让服务器重启uwsgiconfig.ini文件，实现自动化部署。

image

最后保存即可；

run.sh脚本说明：

image

到此，你的代码在托管工具coding上更新之后，会通知绑定的jenkins，jenkins一并更新，并上传到服务器指定目录，最后通过执行脚本重启uwsgi服务器，实现自动化部署。

注意事项:

    flask项目的启动文件的应用变量中的参数应该设置0.0.0.0或者不设置，也不要设置成调试模式，否则公网可能访问不到；（这里没有去了解参数设置，仅仅是随便看了网上的一些解决方法照搬的）；

    服务器上也要安装git，同时在jenkins全局工具管理中配置；

    首次登录jenkins之后密码可能会消失，如果你记不得了的话，按照这个方法进行重新配置；[管理员密码重置](https://links.jianshu.com/go?to=https%3A%2F%2Fblog.csdn.net%2Fqq_39560484%2Farticle%2Fdetails%2F80765211)

    如果自动化部署没问题，代码在本地也没问题，上传上去发现项目运行报错，排除bug等原因。那么可能是py包的问题，我就遇到了包的版本问题，最后发现是pymongo的2.8之前不兼容；

    在uwsgi配置中你指定的运行日志文件中，可以看到报错的信息，shift+g可以跳转到底部查错