部署是基於:centos7+nginx+uwsgi+python3+django 之上做的
詳細步驟(下面步驟都是ROOT權限執行):
一、更新系統軟件包
yum update -y
二、安裝軟件管理包和可能使用的依賴
yum -y groupinstall "Development tools" yum install openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel psmisc libffi-devel
三、下載Pyhton3到/usr/local 目錄
cd /usr/local
wget https://www.python.org/ftp/python/3.6.6/Python-3.6.6.tgz
解壓
tar -zxvf Python-3.6.6.tgz
進入 Python-3.6.6路徑
cd Python-3.6.6
編譯安裝到指定路徑
./configure --prefix=/usr/local/python3
注意:/usr/local/python3 路徑可以自己指定,自己記着就行,下邊要用到。
安裝python3
make
make install
安裝完成之后 建立軟鏈接 添加變量 方便在終端中直接使用python3
ln -s /usr/local/python3/bin/python3.6 /usr/bin/python3
Python3安裝完成之后pip3也一塊安裝完成,不需要再單獨安裝
同樣給pip3建立軟鏈接
ln -s /usr/local/python3/bin/pip3.6 /usr/bin/pip3
四、查看Python3和pip3安裝情況
五、安裝virtualenv ,建議大家都安裝一個virtualenv,方便不同版本項目管理。
pip3 install virtualenv
建立軟鏈接
ln -s /usr/local/python3/bin/virtualenv /usr/bin/virtualenv
安裝成功在根目錄下建立兩個文件夾,主要用於存放env和網站文件的。(個人習慣,其它人可根據自己的實際情況處理)
mkdir -p /data/env
mkdir -p /data/wwwroot
六、切換到/data/env/下,創建指定版本的虛擬環境。
virtualenv --python=/usr/bin/python3 pyweb
然后進入/data/env/pyweb/bin
啟動虛擬環境:
source activate
留意我標記的位置,出現(pyweb),說明是成功進入虛擬環境。
七、虛擬環境里用pip3安django和uwsgi
pip3 install django (如果用於生產的話,則需要指定安裝和你項目相同的版本)
pip3 install uwsgi
留意:uwsgi要安裝兩次,先在系統里安裝一次,然后進入對應的虛擬環境安裝一次。
給uwsgi建立軟鏈接,方便使用
ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi
注意:如果是項目在本地,想部署到線上的,之后這幾步可以不用看,建議跳轉到:本地項目搬遷到服務器
八、切換到網站目錄/data/wwwroot,創建Django項目
django-admin.py startproject mysite
創建成功之后,/data/wwwroot下面就會多出一個mysite文件夾,我們的項目就在這個文件夾里。
然后新建立一個名叫blog的APP
python3 manage.py startapp blog
進入項目文件夾/data/wwwroot/mysite,添加static和templates,分別用於存放靜態文件和模板文件。
編輯項目里mysite/settings.py文件
vim /data/wwwroot/mysite/mysite/settings.py
在INSTALLED_APPS 列表里添加'blog',注意,后面要加上一個逗號','.
修改ALLOWED_HOSTS,['*'],可以讓任何IP訪問
TEMPLATES的DIRS里添加模板路徑
os.path.join(BASE_DIR, 'templates')
尾部添加
STATICFILES_DIRS = (
os.path.join(BASE_DIR,'static'), )
然后 :wq 保存
九、在templates下添加index.html文件,輸入下面內容。
vim /data/wwwroot/mystie/templates/index.html
<!DOCTYPE html>
<html> <head> <meta charset="utf-8"> <title>我的網站</title> </head> <body> <h1>歡迎光臨我的網站!</h1> </body> </html>
十、配置URL
vim /data/wwwroot/mysite/mysite/urls.py
from blog import views #導入views urlpatterns = [ ... path('', views.index), #添加這行 .... ]
十一、編輯blog APP下的views.py
vim /data/wwwroot/mysite/blog/views.py
def index(request): return render(request, 'index.html')
十二、啟動項目
python3 manage.py runserver
正常運行!
十三、Django正常運行之后我們就開始配置一下uwsgi。
我們網站項目路徑是 /data/wwwroot/mysite/,在項目根目錄下創建
mysite.xml文件,輸入如下內容:
<uwsgi> <socket>127.0.0.1:8997</socket> <!-- 內部端口,自定義 --> <chdir>/data/wwwroot/mysite/</chdir> <!-- 項目路徑 --> <module>mysite.wsgi</module> <!-- mysite為wsgi.py所在目錄名--> <processes>4</processes> <!-- 進程數 --> <daemonize>uwsgi.log</daemonize> <!-- 日志文件 --> </uwsgi>
保存
注意<module>里的mysite,為wsgi.py所在的目錄名。
十四、安裝nginx和配置nginx.conf文件
進入home目錄,執行下面命令
cd /home/
wget http://nginx.org/download/nginx-1.13.7.tar.gz
下載完成后,執行解壓命令:
tar -zxvf nginx-1.13.7.tar.gz
進入解壓后的nginx-1.13.7文件夾,依次執行以下命令:
./configure
make
make install
nginx一般默認安裝好的路徑為/usr/local/nginx
在/usr/local/nginx/conf/中先備份一下nginx.conf文件,以防意外。
cp nginx.conf nginx.conf.bak
然后打開nginx.conf,把原來的內容刪除,直接加入以下內容:
events {
worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; server { listen 80; server_name www.django.cn; #改為自己的域名,沒域名修改為127.0.0.1:80 charset utf-8; location / { include uwsgi_params; uwsgi_pass 127.0.0.1:8997; #端口要和uwsgi里配置的一樣 uwsgi_param UWSGI_SCRIPT mysite.wsgi; #wsgi.py所在的目錄名+.wsgi uwsgi_param UWSGI_CHDIR /data/wwwroot/mysite/; #項目路徑 } location /static/ { alias /data/wwwroot/mysite/static/; #靜態資源路徑 } } }
要留意備注的地方,要和UWSGI配置文件mysite.xml,還有項目路徑對應上。
進入/usr/local/nginx/sbin/目錄
執行./nginx -t命令先檢查配置文件是否有錯,沒有錯就執行以下命令:
./nginx
終端沒有任何提示就證明nginx啟動成功。可以使用你的服務器地址查看,成功之后就會看到一個nginx歡迎頁面。
之后,在settings.py里設置:
1、關閉DEBUG模式。
DEBUG = False
2、ALLOWED_HOSTS設置為* 表示任何IP都可以訪問網站。
ALLOWED_HOSTS = ['*']
十五、訪問項目的頁面。
進入網站項目目錄
cd /data/wwwroot/mysite/
執行下面命令:
uwsgi -x mysite.xml
以上步驟都沒有出錯的話。
進入/usr/local/nginx/sbin/目錄
執行:
./nginx -s reload
重啟nginx 。
然后在瀏覽器里訪問你的項目地址!
成功訪問!
里面最值得留意的就是項目的路徑不要弄錯,還有,項目的所有操作都要在虛擬環境下進行。
環境部署部份,懶的話,直接復制我的代碼直接部署就行。
本地項目搬遷到服務器
本地項目想要部署上線,可以參考下面的步驟:
1、備份本地數據庫。使用sqlite數據庫的話,直接打包數據庫文件上傳到服務器即可。使用Mysql數據庫,要先在本地Mysql里備份導出數據,然后在服務器上安裝Mysql數據庫軟件,Mysql安裝具體操作請看:
CentOS7操作系統下快速安裝MySQL5.7
2、在項目目錄下用下面的命令把當前的環境依賴包導出到requirements.txt文件
pip freeze > requirements.txt
3、把項目源碼壓縮打包。
4、把項目上傳到服務器對應的目錄里,解壓。
5、創建新的虛擬環境(參照上面第六步)
6、進入虛擬環境然后進入項目路徑安裝requirements.txt里的依賴包。
pip3 install -r requirements.txt
7、導入數據庫到服務器。(如果用的是Mysql的話)
默認使用的是SQLite數據庫,就不用做此操作。數據庫原來是SQLite的,想換成Mysql,請查看文章:如何把SQLite數據庫轉換為Mysql數據庫
如果是Mysql數據庫的,則在命令行里輸入:
#導出Mysql,django為你的數據庫
mysqldump -uroot -ppassword django>django.sql #把django.sql上傳到服務器,在服務器里用下面命令導入 mysql -uroot -ppassword use dajngo; source your Path\django.sql
8、通過python3 manage.py runserver 運行一下項目,如果能正常啟動則進行下一步,不能正常運行往上檢查。
9、在項目根目錄里添加uwsgi配置文件(參照上面第十三步)
10、配置Nginx配置文件。(參考上面第十四步)
留意:一定要注意Uwsgi和Nginx配置文件里的項目路徑和靜態資源路徑,填寫正確了才能成功訪問。不然會出現502錯誤。還有就是,修改Django文件和其它配置文件之后,一定要重啟Uwsgi和Nginx,不然不生效。
Uwsgi和Nginx重啟方法:
#查看Uwsgi進程
ps -ef|grep uwsgi
#用kill方法把uwsgi進程殺死,然后啟動uwsgi killall -9 uwsgi #啟動方法 uwsgi -x mysite.xml #Nginx平滑重啟方法 /usr/local/nginx/sbin/nginx -s reload
然后在瀏覽器里訪問服務器地址(域名),就能查看到項目。
如果想使用域名訪問項目,先在域名管理后台把域名解析到服務器IP上來,之后在Nginx配置文件里綁定域名。然后在瀏覽器里通過綁定的域名訪問項目。
關於線上部署admin后台樣式沒有生效的問題:
方法一:
1、在settings.py尾部:
STATIC_ROOT = os.path.join(BASE_DIR, 'static')#指定樣式收集目錄 #或 STATIC_ROOT = '/www/mysite/mysite/static' #指定樣式收集目錄
2、收集CSS樣式,在終端輸入:
python manage.py collectstatic
運行這個命令之后,就會自動把后台CSS樣式收集到/static/目錄下。刷新頁面就能恢復樣式!
方法二:
在Python安裝目錄下(如果使用虛擬環境,則在虛擬環境目錄下)找到\Lib\site-packages\django\contrib\admin\templates目錄,把里面的admin目錄復制到指定目錄即可。
注意:收集或復制前一定先在settings里配置並指定STATIC_ROOT路徑,static/ 個目錄可以自己定。指定的時候一定要在settings.py和nginx里指定新的路徑。不然無法生效。
Django啟用SSL證書(https域名)
群里好多朋友都需要使用SSL證書,在使用我這個部署教程的基礎上部署SSL證書,總是遇到不少坑。在這,我在這補充一下安裝SSL證書的方法,供大家參考。
1、進入之前我們下載nginx的源碼目錄
cd /home/nginx-1.13.7/
2、安裝PCRE庫
yum -y install pcre
3、安裝SSL
yum -y install openssl openssl-devel
4、依次執行下面兩行代碼重新編譯一下
./configure
./configure --with-http_ssl_module
5、執行make
make
注意:是make而不是make install
6、備份原來的nginx
cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak
7、將新的 nginx 覆蓋舊安裝目錄
cp objs/nginx /usr/local/nginx/sbin/nginx
如果報錯,剛用執行下面的命令覆蓋
cp -rfp objs/nginx /usr/local/nginx/sbin/nginx
8、免費證書下載后有兩個文件。(以阿里雲免費證書為例)一個是擴展名為.pem的文件,一個是擴展名為.key的文件。.pem文件中已經包含服務器證書和CA中間證書,第一段為服務器證書,第二段為CA中間證書,您可以使用文本編輯器自行提取。.key文件是證書私鑰。這里我們直接把域名證書復制到網站根目錄里去就行。
9、配置nginx.conf文件。
events {
worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; server { listen 443 ssl http2; server_name www.django.cn django.cn; root /data/wwwroot/mysite;#項目路徑 charset utf-8; ssl_certificate /data/wwwroot/mysite/1_www.django.cn.pem;#.pem證書路徑 ssl_certificate_key /data/wwwroot/mysite/2_www.django.cn.key;#.key證書路徑 ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE; ssl_prefer_server_ciphers on; ssl_session_cache shared:SSL:10m; ssl_session_timeout 10m; error_page 497 https://$host$request_uri; location / { include uwsgi_params; uwsgi_pass 127.0.0.1:8997; uwsgi_param UWSGI_SCRIPT wechatProject.wsgi; uwsgi_param UWSGI_CHDIR /data/wwwroot/mysite/;#項目路徑 } location /static/ { alias /data/wwwroot/mysite/static/; #靜態資源路徑 } access_log /data/wwwroot/mysite/www.django.cn.log; error_log /data/wwwroot/mysite/www.django.cn.error.log; } }
留意證書的路徑,我們主要是把原來的80端口,修改成443,然后再加一些SSL證書配置,大家可以和前面的nginx的配置進行對比一下。
10、測試配置文件是否正確
/usr/local/nginx/sbin/nginx -t
如果沒有報錯則重啟nginx即可。
/usr/local/nginx/sbin/nginx -s reload
留意:使用https時,要開啟服務器的443端口,如果開啟了服務器還不能訪問,可能需要到服務器提供商后台安全組給端口放行。
Django多站點部署
有的時候我們一台服務器需要部署多個項目,那么我們應該怎么部署呢?
1、進入Nginx的配置文件目錄/usr/local/nginx/conf/,然后新建一個目錄:
mkdir vhost
之后在vhost目錄里建立兩個以.conf結尾的文件(有幾個項目就放幾個),里面的內容如下:
server {
listen 80; server_name www.django.cn; charset utf-8; location / { include uwsgi_params; uwsgi_pass 127.0.0.1:8997; #端口要和uwsgi里配置的一樣 uwsgi_param UWSGI_SCRIPT mysite.wsgi; #wsgi.py所在的目錄名+.wsgi uwsgi_param UWSGI_CHDIR /data/wwwroot/mysite/; #項目路徑 } location /static/ { alias /data/wwwroot/mysite/static/; #靜態資源路徑 } }
項目路徑、端口、靜態資源與所屬項目對應好。注意:項目里的uwsgi端口不能與另一個項目重復。
2、/usr/local/nginx/conf/目錄下的原來默認的nginx.conf文件,先備份一下,然后把里面的代碼刪除,修改成如下代碼:
events {
worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; include /usr/local/nginx/conf/vhost/*.conf;#主要是這個地方,把新建的兩配置文件包含進來 server { listen 80 default_server; server_name _; return 404; } }
3、新建立一個虛擬環境,把新項目上傳到到服務器。進入虛擬環境,在新的虛擬環境再裝一次uwsgi,和安裝項目所需依賴包,然后在項目根目錄新建立一個uwsgi配置文件,里面的端口和配置文件名不要和其它項目相同,路徑換成自己的項目路徑。
4、在虛擬環境啟動uwsgi,重啟Nginx,就能成功訪問。哪個項目不能訪問,就把原來的uwsgi進行殺死,然后再進入對應虛擬環境,啟動uwsgi即可。
關於CentOS防火牆端口打開的方法:
有些服務器外網默認是無法訪問的,因為防火牆不允許,所以要開啟防火牆,讓其可以訪問需要訪問的端口號。
1、運行命令:
firewall-cmd --get-active-zones
運行完成之后,可以看到zone名稱。
2、執行下面命令打開需要打開的端口,以80端口為例
firewall-cmd --zone=public --add-port=80/tcp --permanent
3、重啟防火牆
firewall-cmd --reload
4、查看端口號是否開啟
firewall-cmd --query-port=80/tcp