今天的实作内容主要根据教学网站进行。

将应用程序安装到Heroku

环境设定

Heroku主要利用四个档案来设定环境：

• runtime.txt
• requirements.txt
• Procfile
• wsgi.py

接下来我将逐一设定这些档案。

runtime.txt

用来标示使用的程序语言运行环境与版本。

新增方法：在专案根目录 (和manage.py同一层级)新增runtime.txt，其中内容如下：

python-3.9.7

要注意的是Heroku并不是所有版本都支援，故需要先去Heroku网站确认Python的支援版本，不然在推送到Heroku时会发生问题。

Procfile

同样在根目录下新增Procfile档案，内容如下：

web: gunicorn bookhelper.wsgi --log-file -

gunicorn为Heroku推荐的web application server，此段宣告gunicorn使用bookhelper.wsgi作为组态设定。

requirements.txt

用来宣告要安装的Python套件。

需要安装的Python套件可以使用以下指令，将开发环境有安装的套件列出：

pip freeze > requirements.txt

输出的档案一样放在根目录，Heroku会根据此档案进行安装，但要注意的是如果是自己私人开发未上传到PYPI的套件 (如Day17内容)就无法使用。

除了开发阶段已安装的套件外，因应正式环境的环境设置，还有一些额外的套件需要安装。

实际requirement.txt内容：

dj-database-url==0.5.0
Django==3.2.7
django-allauth==0.45.0
django-q==1.3.9
gunicorn==20.1.0
psycopg2==2.9.1
whitenoise==5.3.0

• gunicorn

• dj-database.url
  在开发期间，django的settings.py中我们使用local资料库连线设定，当上传到正式环境时，Heroku以add-on透过URL的方式提供我们使用。

Heroku建议使用此套件以解析资料库使用的URL。

settings.py可以调整如下：

# Heroku: Update database configuration from $DATABASE_URL.
import dj_database_url
db_from_env = dj_database_url.config(conn_max_age=500)
DATABASES['default'].update(db_from_env)

• psycopg2
  Heroku的免费方案中提供的资料库为Postgres，故需要安装对应的套件。

• WhiteNoise
  用来提供Python web app的静态档案。(如果透过Django提供静态档案的话效能会较差)

settings.py要配合做以下设定：

MIDDLEWARE = [
    'whitenoise.middleware.WhiteNoiseMiddleware',
]
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

因为时间因素，今天内容就先更新到这边，明天再接续後面的流程。