如何將 Github 專案部屬到 Heroku (Creating a 'Deploy to Heroku' Button)

先前「[django] 將Django專案部署到Heroku」提到如何一步一步建立 Django 專案，並部屬到 Heroku。若是Github現有的專案已經滿足 Heroku 基本所需的設定，可以透過網頁操作，將現有專案快速地複製到 Heroku 上。

操作說明使用 heroku-startup-settings 這個專案 ，可以到 Github 查看完整的程式碼。首先，Github專案必須在根目錄先建立 app.json 這個檔案：

{
  "name": "Heroku startup settings",
  "description": "Getting started with Django project",
  "repository": "https://github.com/chenuin/heroku-startup-settings",
  "logo": "https://node-js-sample.herokuapp.com/node.png",
  "keywords": ["heroku", "python", "django"]
}

(app.json)

內容很好理解，檔案沒有必填的欄位，通常會寫name、description、logo有助於其他人理解這個專案的內容或目的，更多的設定可以參考 app.json schema。

其中設定環境參數 env 應該是最常使用的，可以依照需求調整部屬。

若 app.json 正確建立後，就可以開啟這個連結。

https://heroku.com/deploy?[REPO_WEB_URL]/tree/[BRANCH_NAME]

請替換專案的路徑和分支名稱，因此連結為：

https://heroku.com/deploy?template=https://github.com/chenuin/heroku-startup-settings/tree/master

接者可以在 README.md 新增這段文字，

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/chenuin/heroku-startup-settings/tree/master)

請記得替換成自己的連結，按鈕效果就像這樣：

點選按鈕開啟連結並填寫專案名稱，按下「Deploy app」，就會自動在 Heroku 建立一個一樣的新專案。

相關文章：

[django] 將Django專案部署到Heroku

參考資料：

https://devcenter.heroku.com/articles/heroku-button https://devcenter.heroku.com/articles/app-json-schema

[Symfony] 如何將專案部屬到Heroku(apache/nginx)

之前寫過一篇『[django] 將Django專案部署到Heroku』，可以參考安裝heroku[官網說明]的方式，『[Symfony] ubuntu18安裝symfony 4.2教學』則可以了解composer和symfony的安裝方式，這篇就不再重複說明。

步驟一、新增Symfony專案

首先新增一個專案 symfony_heroku ，也可以根據需求指定專案版本，目前版本是3.4。

composer create-project symfony/framework-standard-edition symfony_heroku/

# 指定Symfony版本 3.0
composer create-project symfony/framework-standard-edition:^3.0 symfony_heroku/

步驟二、新增Procfile

進到專案目錄裡symfony_heroku/，以apache為例，新增檔案Procfile做為執行網站的依據。

cd symfony_heroku
echo 'web: $(composer config bin-dir)/heroku-php-apache2 web/' > Procfile

相當於：

vim Procfile

檔案Procfile內容：

web: $(composer config bin-dir)/heroku-php-apache2 web/

參數$(composer config bin-dir)是考慮到版本差異，可以動態的指到正確的路徑。

步驟三、部屬專案

使用git將所有檔案加入追蹤並commit。

git init
git add .
git commit -m "initial commit"

輸入指令 heroku login 登入後，建立一個Heroku專案，新增相關設定。

heroku create
heroku config:set SYMFONY_ENV=prod

上傳Heroku

git push heroku master

可以打開瀏覽器就可以看到symfony預設的網頁。

https://[APP_NAME].herokuapp.com

查詢Heroku專案名稱(顯示網址)

heroku open

關閉網頁伺服器

heroku ps:scale web=0

開啟網頁伺服器

heroku ps:scale web=1

[nginx]

假設你希望使用nginx作為網頁伺服器，請將Procfile改成：

web: $(composer config bin-dir)/heroku-php-nginx web/

預設/，沒有任何頁面，請看/app.php確定有沒有建立成功。

https://[APP_NAME].herokuapp.com/app.php

參考資料：
https://devcenter.heroku.com/articles/getting-started-with-symfony
https://devcenter.heroku.com/articles/getting-started-with-php

相關文章：

• Symfony4.2入門教學【第一篇】安裝
• Symfony4.2入門教學【第二篇】建立第一個頁面(Routes)
• Symfony4.2入門教學【第三篇】路由(Routes)
• Symfony4.2入門教學【第四篇】控制器(Controller)
• Symfony4.2入門教學【第五篇】模板(Templates)
• Symfony4.2入門教學【第六篇】設定(Configuration)

[django] 將Django專案部署到Heroku

首先安裝相關套件

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