发布 Django 到 Digital Ocean 实践笔记

本篇文章最初发表于 2018-01-26。

本文包含部署使用 python3 编写的 Django 代码到 Digital Ocean 的一般步骤，涉及到 git, pyvenv, mysql, pm2 等技术，对于 Django 部署具有一定的参考借鉴意义。

开始部署前，你需要准备一台远程服务器，一个域名，并且将这个域名 A 记录解析到这台远程服务器。

版本控制

使用 Git 作为版本控制工具。

新建一个 git 账户

1. 在远程服务器上执行

$ sudo adduser git
$ su git
$ cd
$ mkdir .ssh && chmod 700 .ssh
$ touch .ssh/authorized_keys && chmod 600 .ssh/authorized_keys

2. 在本地开发 mac 本上生成 ssh key

$ cd
$ ssh-keygen

3. 将本地生成的 ssh key pub 文件上传至远程服务器并添加到授权文件尾部

$ cd
$ cd .ssh
$ ssh-copy-id -i id_rsa.pub git@<servername.com>

在远程服务器新建一个 git 仓库

$ sudo mkdir -p /gitbase/<projectname>
$ sudo chown -R git:git /gitbase
$ su git
$ cd /gitbase/<projectname>
$ git init --bare

提交本地代码到远程 git 服务器

$ cd ~/projects/<projectname>
$ git init
$ git add .
$ git commit -m 'first commit.'
$ git remote add origin git@<servername.com>:/gitbase/<projectname>
$ git push origin master

从远程 git 服务器拉取代码到远程服务器发布目录

$ sudo mkdir -p /deploy/<projectname>
$ sudo chown -R <user>:<user> /deploy/<projectname>
$ cd /deploy/<projectname>
$ git clone git@<servername.com>:/gitbase/<projectname> .

替换上述的 <user> 和 <servername.com>为实际的用户名和远程服务器域名，下同。也可使用 gitee来作为版本控制服务器。更多可参考Git on the Server

配置 Django 运行环境

使用 pyvenv 来管理 python3 的运行环境，python2 的代码可以使用 python3 的lib2to3 模块工具来转义成 python3 代码。

$ python3 -m lib2to3 -w <mycode.py>

使用 python3 的运行环境

$ cd
$ python3 -m venv py3env
$ source py3env/bin/activate
$ cd /deploy/<projectname>
$ pip install -r requirements.txt

测试代码是否能正常运行，切换到项目根目录，并执行

$ python manage.py migrate
$ python manage.py createsuperuser
$ curl -i localhost:8000

安装并配置 mysql-server

安装 MySQL

$ sudo apt-get install mysql-client mysql-server

开启 mysql-server 远程访问

$ mysql -uroot -p yourpass
mysql> grant all on *.* to user_name@'%' identified by 'user_password';

找到 bind-address = 127.0.0.1 这一行，我们将它注释掉。

$ sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf

确保 3306 端口的开启状态

$ sudo netstat -an | grep 3306

重启 mysql 服务

$ sudo service mysql restart

想了解更多可以参考Ubuntu 下开启 Mysql 远程访问的方法。

同步表接口和数据到远程服务器

使用 mysql 远程用户名和密码将备份的数据传输到远程服务器，可以直接使用 mysql 命令行，也可以使用可视化的 mysql 管理工具，例如 workbench、HeidiSQL、navicat、Sequel 等。

使用 pm2 部署 Django 代码

安装 node 和 pm2

从 node 官网下载 node linux 平台的可运行包，并利用 npm 安装 pm2。

$ cd
$ wget https://nodejs.org/dist/v8.9.4/node-v8.9.4-linux-x64.tar.xz
$ xz -d node-v8.9.4-linux-x64.tar.xz
$ tar -xf node-v8.9.4-linux-x64.tar
$ cd node-v8.9.4-linux-x64
$ sudo cp -r {bin,include,lib,share} /usr
$ npm i -g pm2

配置 pm2 运行参数

切换到项目根目录 /deploy/<projectname>，然后执行

$ touch process.yml
$ vim process.yml

将如下配置保存为 process.yml

apps:
  - name: mysite
    script: manage.py
    args: ['runserver', '0.0.0.0:8000']
    cwd: .
    interpreter: ~/py3env/bin/python3

运行 pm2

$ pm2 start process.yml

查看 pm2 的运行结果

$ pm2 status

测试网站是否能访问

$ curl -i localhost:8000

使用 nginx 反向代理

确认 8000 和 80 端口开启后，然后再本地测试远程站点是否可以访问，若不能访问，则排查具体原因。继续使用nginx 来反向代理远程服务器上的 http服务，将内部站点端口映射到服务器的 80 端口，将相应域名的根目录映射为内部站点的子目录，以及加载静态资源文件等实现。具体可以参考网上文档，本文不再赘述。