首先安裝相關套件
sudo apt-get install snapd
# 安裝heroku cli(Linunx)
# https://devcenter.heroku.com/articles/heroku-cli#download-and-install
sudo snap install heroku --classic
# 安裝django-heroku
pip install django-heroku
# 安裝gunicorn
pip install gunicorn # 安裝git
sudo apt install git
若成功安裝就可以登入Heroku開始建立專案囉! 尚未有Heroku帳號的,請按
註冊Heroku會員。
# 登入Heroku
heroku login
先建立一個空白的專案
mkdir heroku-python
cd heroku-python
# create project
django-admin startproject mysite .
打開mysite/settings.py,先將IP加到ALLOWED_HOSTS,'*'是允許所有的Hostname,比較偷懶的方式。再來加入heroku的套件,套用這個檔案內的設定。
# mysite/settings.py
import django_heroku
ALLOWED_HOSTS = ['*']
...
# end of file
django_heroku.settings(locals())
為了讓Heroku知道專案需要的環境,有兩個必要的檔案
Procfile和
requirements.txt必須手動加入,請注意
Procfile沒有副檔名。
# Procfile
web: gunicorn mysite.wsgi
requirements.txt可以透過pip freeze自動生成,內容可以參考下面。
# requirements.txt
Django==2.1
django-heroku==0.3.1
gunicorn==19.9.0
接著,新增一個Heroku專案,一種由系統自動產生,一種直接在create後面加上你想要的名稱。 之後這個專案網址是[project_name].herokuapp.com,因此如果顯示"Name [project-name] is already taken",可能是你想要的名稱已經先被佔用了。
# 由Heroku自動產生專案名稱
heroku create
# 使用者指定專案名稱
heroku create [project_name]
執行heroku create自動產生的結果,可以參考下面,
intense-river-54924就是Heroku隨機產生的專案名稱。
Creating app... done, ⬢ intense-river-54924
https://intense-river-54924.herokuapp.com/ | https://git.heroku.com/intense-river-54924.git
新增一個 git repository
git init
git add .
git commit -m "initial commit"
# 設定遠端伺服器/設定專案的上傳目標
heroku git:remote -a intense-river-54924
# 確認是否設定成功
git remote -v
執行git remote -v的顯示範例
heroku https://git.heroku.com/intense-river-54924.git (fetch)
heroku https://git.heroku.com/intense-river-54924.git (push)
因為staticfiles設定要調整,所以先取消執行collectstatic的部分,才不會有錯誤喔!
# 設定參數
# heroku config:set [key]=[value]
heroku config:set DISABLE_COLLECTSTATIC=1
設定完成後就上傳至遠端Heroku的伺服器
# git push [remote-name] [branch-name]
git push heroku master
執行網站,此時就可以打開瀏覽器查看網頁囉!
heroku ps:scale web=1
專案名稱是intense-river-54924,只要打開
https://intense-river-54924.herokuapp.com/,就可以看到結果囉!如果不記得專案名稱,可以透過指令顯示執行網站url。
heroku open
部署到這邊告一段落,底下有些指令可以參考使用,像是有錯誤無法正常顯示網站,可以查看Log來排除錯誤。
heroku logs --tail
heroku logs --tail --app [HEROKU_APP_NAME]
其他Django的指令執行範例,不是本地端而是在遠端伺服器執行。
heroku run python mysite/manage.py migrate
heroku run python mysite/manage.py createsuperuser
在編輯你的專案時,小幅度的修改可以透過以下指令在本地端執行,確定沒有問題時再推到遠端去。
# Procfile is required.
# 效果如同 "python manage.py runserver 0.0.0.0:5000"
heroku local
當你想要執行已有的專案時,可以自遠端伺服器取得專案
heroku git:clone -a [project-name]
參考資料:
https://devcenter.heroku.com/articles/getting-started-with-python