在 Heroku 上托管 Django 项目

项目概况

本教程不是关于构建任何特定项目，而是使用Heroku在云中托管一个项目。虽然 Heroku 支持各种语言和 Web 框架，但您将坚持使用 Python 和 Django。如果您手头没有任何 Django 项目，请不要担心。第一步将引导您搭建一个新的 Django 项目，以帮助您快速入门。或者，您可以使用稍后会找到的现成示例项目。

准备好 Django 项目后，您将注册一个免费的 Heroku 帐户。接下来，您将下载一个方便的命令行工具，帮助您在线管理您的应用程序。如上面的截屏视频所示，命令行是使用 Heroku 的一种快捷方式。最后，您将在新配置的 Heroku 实例上托管已部署的 Django 项目。您可以将最终结果视为未来项目创意的占位符。

先决条件

在继续之前，请确保您熟悉Django Web 框架的基础知识，并且您可以轻松地使用它来设置基本项目。

您还应该安装并配置一个Git客户端，以便您可以从命令行方便地与 Heroku 平台交互。最后，您应该认真考虑为您的项目使用虚拟环境。如果您还没有想到特定的虚拟环境工具，您很快就会在本教程中找到一些选项。

第 1 步：搭建一个用于托管的 Django 项目

要在云中托管 Django Web 应用程序，您需要一个有效的Django 项目。就本教程而言，不必详细说明。如果时间不够，请随意使用您的业余爱好项目之一或构建示例投资组合应用程序，然后跳到创建本地 Git 存储库。否则，坚持从头开始制作一个全新的项目。

$ mkdir portfolio-project
$ cd portfolio-project/

$ python3 -m venv ./venv --prompt portfolio

portfolio-project/
│
└── venv/

引导一个 Django 项目

每个 Django 项目都由遵循特定命名约定的类似文件和文件夹组成。您可以手动创建这些文件和文件夹，但以自动方式进行通常更快、更方便。

安装 Django 时，它会为管理任务（例如引导新项目）提供命令行实用程序。该工具位于您的虚拟环境的bin/子文件夹中：

(portfolio) $ which django-admin
/home/jdoe/portfolio-project/venv/bin/django-admin

您可以在 shell 中运行它并传递新项目的名称以及它将创建默认文件和文件夹的目标目录：

(portfolio) $ django-admin startproject portfolio .

或者，您可以通过调用django模块来获得相同的结果：

(portfolio) $ python -m django startproject portfolio .

请注意这两个命令末尾的点，它表示您当前的工作目录portfolio-project，作为目标。如果没有它，该命令将创建另一个与您的项目同名的父文件夹。

如果您收到command not found错误或ModuleNotFound 异常，请确保您已激活安装 Django 的相同虚拟环境。其他一些常见错误是将您的项目命名为与内置对象之一相同或未使用有效的 Python 标识符。

之后，你应该有这个目录布局：

portfolio-project/
│
├── portfolio/
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
├── venv/
│
├── manage.py
└── requirements.txt

您创建了一个名为的管理应用程序portfolio，其中包含项目级设置和带有 URL 模式的主文件，以及其他一些内容。您还创建了manage.py可以方便地包装django-admin和连接到您的项目的脚本。

您现在拥有一个基本但可运行的 Django 项目。此时，您通常会启动一个或多个Django 应用程序并定义它们的视图和模型，但本教程不需要它们。

更新本地数据库架构（可选）

此步骤是可选的，但如果您想使用Django 管理视图或定义自定义应用程序和模型，那么您最终需要更新您的数据库架构。默认情况下，Django 带来了一个基于文件的SQLite 数据库，方便测试和运行本地开发服务器。这样，您无需安装和设置像MySQL或PostgreSQL这样的成熟数据库。

要更新数据库架构，请运行migrate子命令：

(portfolio) $ python manage.py migrate

成功应用所有挂起的迁移后，您将db.sqlite3在项目根文件夹中找到一个名为的新文件：

portfolio-project/
│
├── portfolio/
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
├── venv/
│
├── db.sqlite3
├── manage.py
└── requirements.txt

您可以使用sqlite3命令行实用程序、Python 的内置sqlite3模块或您喜欢的数据库管理工具检查其内容。到现在为止，这个文件应该包含一些负责身份验证、会话管理等的内部应用程序的表，以及一个用于跟踪应用迁移的元表。

步骤 2：创建本地 Git 存储库

既然您已经有了一个可以运行的 Django 项目，那么下一步是将它托管在云中。在本节中，您将探索在 Heroku 平台上构建和部署应用程序的可用选项。如果您还没有为您的项目创建本地 Git 存储库，您还将创建该存储库。在这一步结束时，您将准备好深入研究 Heroku 工具链。

Heroku 至少提供了五种不同的方式来部署您的项目：

1. Git：推送提交到 Heroku 上的远程 Git 存储库
2. GitHub：合并拉取请求时自动触发部署
3. Docker：将Docker镜像推送到 Heroku 容器注册表
4. API：以编程方式自动化部署
5. Web：从 Heroku 仪表板手动部署

最直接且以开发人员为中心的方法是第一种方法。许多软件开发人员每天都在使用 Git，因此 Heroku 的入门门槛非常低。该git命令可让您在 Heroku 中完成很多工作，这就是您将在本教程中使用 Git 的原因。

$ git init

$ git status
On branch master

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
    .idea/
    __pycache__/
    db.sqlite3
    manage.py
    portfolio/
    requirements.txt
    venv/

nothing added to commit but untracked files present (use "git add" to track)

第 3 步：创建一个免费的 Heroku 帐户

此时，您已准备好注册一个免费的 Heroku 帐户并根据自己的喜好进行配置。

Django 将自己标榜为具有截止日期的完美主义者的 Web 框架。Heroku 采用类似的固执己见的方法在云中托管 Web 应用程序，旨在缩短开发时间。它是一种高级且安全的平台即服务 (PaaS)，可减轻您肩上的基础设施管理负担，让您专注于对您最重要的事情——编写代码。

许多初创公司和小公司在开发的早期阶段都没有熟练的 DevOps 工程师团队。就这些公司的投资回报而言，Heroku 可能是一个方便的解决方案。

第 4 步：安装 Heroku CLI

在终端中工作是任何开发人员的基本技能。键入命令起初可能看起来令人生畏，但在看到它的强大功能后，它就变成了第二天性。为了获得无缝的开发人员体验，您需要安装Heroku 命令行界面 (CLI)。

Heroku CLI 可让您直接从终端创建和管理您的 Web 应用程序。在这一步中，您将学习一些基本命令以及如何显示它们的文档。首先，按照您的操作系统的安装说明进行操作。完成后，使用以下命令确认安装成功：

$ heroku --version

如果heroku找到该命令并且您使用的是最新版本的 Heroku CLI，则可以在 shell 中启用自动完成功能。当您按下Tab键时，它会自动完成命令及其参数，从而节省时间并防止输入错误。

Heroku CLI 具有模块化插件架构，这意味着其功能是自包含的并遵循相同的模式。要获取所有可用命令的列表，请在终端中输入heroku help或简单地heroku输入：

$ heroku
CLI to interact with Heroku

VERSION
  heroku/7.56.0 linux-x64 node-v12.21.0

USAGE
  $ heroku [COMMAND]

COMMANDS
  access          manage user access to apps
  addons          tools and services for developing, extending, (...)
  apps            manage apps on Heroku
  auth            check 2fa status
(...)

有时，命令的名称可能不会泄露它的作用。如果您想了解有关特定命令的更多详细信息并查看使用的快速示例（如果可用），请使用以下--help标志：

$ heroku auth --help
check 2fa status

USAGE
  $ heroku auth:COMMAND

COMMANDS
  auth:2fa     check 2fa status
  auth:login   login with your Heroku credentials
  auth:logout  clears local login credentials and invalidates API session
  auth:token   outputs current CLI authentication token.
  auth:whoami  display the current logged in user

在这里，您auth通过使用--help标志来询问有关命令的更多信息。您可以看到auth后面应该跟一个冒号 ( :) 和另一个命令。通过键入heroku auth:2fa，您是在要求 Heroku CLI 检查您的双因素身份验证设置的状态：

$ heroku auth:2fa --help
check 2fa status

USAGE
  $ heroku auth:2fa

ALIASES
  $ heroku 2fa
  $ heroku twofactor

COMMANDS
  auth:2fa:disable  disables 2fa on account

Heroku CLI 命令是分层的。它们通常会有一个或多个子命令，您可以在冒号后指定这些子命令，如上例所示。此外，其中一些子命令可能在命令层次结构的顶层具有可用的别名。例如，键入heroku auth:2fa与heroku 2faor具有相同的效果heroku twofactor：

$ heroku auth:2fa
Two-factor authentication is enabled

$ heroku 2fa
Two-factor authentication is enabled

$ heroku twofactor
Two-factor authentication is enabled

所有三个命令都会给出相同的结果，您可以从中选择一个更容易记住的命令。

在这个简短的部分中，您在计算机上安装了 Heroku CLI 并熟悉了它的语法。您已经看到了一些方便的命令。现在，要充分利用这个命令行工具，您需要登录您的 Heroku 帐户。

第 5 步：使用 Heroku CLI 登录

即使不创建 Heroku 帐户，您也可以安装 Heroku CLI。但是，您必须验证您的身份并证明您拥有相应的 Heroku 帐户才能对其进行有意义的操作。在某些情况下，您甚至可能拥有多个帐户，因此登录允许您指定在特定时刻使用哪个帐户。

稍后您将了解到，您不会永久保持登录状态。登录以确保您有权访问并确保您使用正确的帐户是一个好习惯。最直接的登录方式是通过以下heroku login命令：

$ heroku login
heroku: Press any key to open up the browser to login or q to exit:

如果您之前登录到 Heroku 仪表板，这将打开您的默认 Web 浏览器并整齐地获取您的会话 cookie。否则，如果您启用了双因素身份验证，您将需要提供您的用户名、密码和可能的另一个身份证明。成功登录后，您可以关闭选项卡或浏览器窗口并返回终端。

当您使用 CLI 登录时，会话 cookie 的暴露是暂时的，因为 Heroku 会生成一个在有限时间内有效的新授权令牌。它存储在标准令牌.netrc在文件中的主目录，但你也可以使用Heroku的仪表板或检查它heroku auth和heroku authorizations插件：

$ heroku auth:whoami
jdoe@company.com

$ heroku auth:token
 ›   Warning: token will expire today at 11:29 PM
 ›   Use heroku authorizations:create to generate a long-term token
f904774c-ffc8-45ae-8683-8bee0c91aa57

$ heroku authorizations
Heroku CLI login from 54.239.28.85  059ed27c-d04a-4349-9dba-83a0169277ae  global

$ heroku authorizations:info 059ed27c-d04a-4349-9dba-83a0169277ae
Client:      <none>
ID:          059ed27c-d04a-4349-9dba-83a0169277ae
Description: Heroku CLI login from 54.239.28.85
Scope:       global
Token:       f904774c-ffc8-45ae-8683-8bee0c91aa57
Expires at:  Fri Jul 02 2021 23:29:01 GMT+0200 (Central European Summer Time) (in about 8 hours)
Updated at:  Fri Jul 02 2021 15:29:01 GMT+0200 (Central European Summer Time) (1 minute ago)

该过期策略似乎在写这篇教程的时候有点出问题。官方文档说它默认应该保持有效一年，而Heroku CLI显示大约一个月，这也对应于会话cookie过期。使用 Heroku Web 界面手动重新生成令牌将其减少到大约 8 小时。但是，如果您测试实际到期日期是多少，您会发现它完全不同。如果您在学习本教程时对到期政策感到好奇，请自行探索。

无论如何，该heroku login命令仅用于开发。在生产环境中，您通常会生成一个长期存在的用户授权，该授权永远不会随authorizations插件过期。它可以通过Heroku API方便地用于脚本和自动化目的。

第 6 步：创建 Heroku 应用程序

在这一步中，您将创建您的第一个 Heroku 应用程序并了解它如何与 Git 集成。最后，您的项目将拥有一个公开可用的域地址。

在 Django 项目中，应用程序是封装可重用功能的独立代码单元。另一方面，Heroku 应用程序像可扩展的虚拟计算机一样工作，能够托管您的整个 Django 项目。每个应用程序都包含源代码、必须安装的依赖项列表以及运行项目的命令。

每个项目至少有一个 Heroku 应用程序，但拥有更多应用程序并不少见。例如，您可能希望同时运行项目的开发、暂存和生产版本。每个都可以连接到不同的数据源并具有不同的功能集。

要使用 Heroku CLI 创建您的第一个应用程序，请确保您已经登录到 Heroku，然后运行heroku apps:create命令或其别名：

$ heroku create
Creating app... done, ⬢ polar-island-08305
https://polar-island-08305.herokuapp.com/ | https://git.heroku.com/polar-island-08305.git

默认情况下，它会选择一个保证唯一的随机应用名称，例如polar-island-08305. 您也可以选择自己的，但它必须在整个 Heroku 平台上普遍唯一，因为它是您免费获得的域名的一部分。你会很快发现它是否已经被占用：

$ heroku create portfolio-project
Creating ⬢ portfolio-project... !
 ▸    Name portfolio-project is already taken

如果您考虑一下有多少人使用 Heroku，那么有人已经创建了一个名为 的应用程序也就不足为奇了portfolio-project。当您heroku create在 Git 存储库中运行该命令时，Heroku 会自动将一个新的远程服务器添加到您的.git/config文件中：

$ tail -n3 .git/config
[remote "heroku"]
    url = https://git.heroku.com/polar-island-08305.git
    fetch = +refs/heads/*:refs/remotes/heroku/*

Git 配置文件的最后三行定义了一个名为 的远程服务器heroku，它指向您唯一的 Heroku 应用程序。

通常，克隆存储库后，您的 Git 配置中将有一个远程服务器（例如，在 GitHub 或 Bitbucket 上）。但是，本地存储库中可以有多个Git 远程服务器。稍后您将使用该功能向 Heroku 发布新的应用程序和部署。

$ heroku apps
=== jdoe@company.com Apps
fathomless-savannah-61591
polar-island-08305
sleepy-thicket-59477

$ heroku git:remote --app polar-island-08305
set git remote heroku to https://git.heroku.com/polar-island-08305.git

当你创建一个新的应用程序时，它会告诉你它在.herokuapp.com域中的公共网址。在本教程中，公共网址是https://polar-island-08305.herokuapp.com，但您的网址会有所不同。尝试将您的 Web 浏览器导航到您的唯一域，看看接下来会发生什么。如果您不记得确切的 URL，只需heroku open在项目根文件夹中时在终端中键入命令。它将打开一个新的浏览器窗口并获取正确的资源：

选择构建包

Heroku 自动化了许多部署步骤，但它需要了解您的项目设置和技术堆栈。构建和部署项目的方法称为buildpack。已经有一些官方构建包可用于许多后端技术，包括 Node.js、Ruby、Java、PHP、Python、Go、Scala 和 Clojure。除此之外，您还可以找到用于不太流行的语言（例如 C）的第三方构建包。

您可以在创建新应用程序时手动设置一个，也可以让 Heroku 根据存储库中的文件检测它。Heroku 识别 Python 项目的一种方法是requirements.txt在项目根目录中查找文件。确保您已经创建了一个（您pip freeze在设置虚拟环境时可能已经完成），并且您已将其提交到本地存储库。

其他一些有助于 Heroku 识别 Python 项目的文件是Pipfile和setup.py. Heroku 还将识别Django Web 框架并为其提供特殊支持。因此，如果您的项目包含requirements.txt、Pipfile、 或setup.py，那么除非您正在处理某些极端情况，否则通常不需要设置构建包。

选择 Python 版本（可选）

默认情况下，Heroku 会选择一个最新的 Python 版本来运行你的项目。但是，您可以通过runtime.txt在项目根目录中放置一个文件来指定不同版本的 Python 解释器，记住提交它：

$ echo python-3.9.6 > runtime.txt
$ git add runtime.txt
$ git commit -m "Request a specific Python version"

请注意，您的 Python 版本必须包含语义版本控制的所有major.minor.patch组件。虽然只有少数受支持的 Python运行时，但您通常可以调整补丁版本。还有对PyPy的测试版支持。

指定要运行的进程

现在 Heroku 知道如何构建您的 Django 项目，它需要知道如何运行它。一个项目可以由多个组件组成，例如 Web 组件、后台工作人员、关系数据库、NoSQL 数据库、计划作业等。每个组件都在单独的进程中运行。

有四种主要的流程类型：

1. web: 接收 HTTP 流量
2. worker: 在后台执行工作
3. clock: 执行预定的作业
4. release: 在部署前运行任务

在本教程中，您将只查看 Web 进程，因为每个 Django 项目都至少需要一个。您可以在名为 的文件中定义它，该文件Procfile必须放在您的项目根目录中：

portfolio-project/
│
├── .git/
│
├── portfolio/
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
├── venv/
│
├── .gitignore
├── db.sqlite3
├── manage.py
├── Procfile
├── requirements.txt
└── runtime.txt

这Procfile是一种单一的、与语言无关的格式，用于定义组成项目的流程。它将指导 Heroku 如何运行您的 Web 服务器。虽然使用内置开发服务器不是在生产中运行 Django 项目的推荐做法，但您可以在本练习中使用它：

$ echo "web: python manage.py runserver 0.0.0.0:\$PORT" > Procfile
$ git add Procfile
$ git commit -m "Specify the command to run your project"

为了使服务器可以从 Heroku 云之外的世界访问，您指定地址 as0.0.0.0而不是默认的localhost。它将在公共网络接口上绑定服务器。Heroku 通过PORT环境变量提供端口号。

您现在可以通过使用 Heroku CLI 在本地运行 Django 项目来测试此配置：

$ heroku local

默认情况下，如果您没有明确指定进程类型，它将运行该web进程。该heroku local命令是一样的heroku local web。此外，如果您不使用--port标志设置端口号，则它将使用默认端口5000。

您现在已经指定了希望 Heroku 运行的进程。当您http://localhost:5000/在 Web 浏览器中打开 URL时，您应该会再次在 Django 欢迎页面上看到熟悉的火箭。但是，要通过 公共接口访问相同的资源http://0.0.0.0:5000/，您需要调整 Django 配置，否则您将收到错误请求错误。

配置 Django

您之前构建了一个基本的 Django 项目，现在是对其进行配置以使其准备好在您的 Heroku 实例上运行的时候了。配置 Django 项目可让您微调从数据库凭据到模板引擎的各种设置。

要通过非本地网络地址访问您的 Django 项目，您需要ALLOWED_HOSTS在您的项目设置中指定。除此之外，Python 的 Django buildpack 会为collectstatic您运行命令，这需要STATIC_ROOT定义选项。无论您是否使用 Heroku，在部署 Django 项目时还有一些配置选项需要更改，但在此阶段它们不是强制性的。

您可以使用快捷方式安装一个方便的django-heroku包，而不是手动配置 Django，它可以处理所有这些以及更多。在继续之前确保您处于正确的虚拟环境中，并记住在完成后刷新您的需求文件：

(portfolio) $ python -m pip install django-heroku
(portfolio) $ python -m pip freeze > requirements.txt

这将使用项目的最新依赖项替换您的需求文件的内容。接下来，将这两行 Python 代码附加到您的portfolio/settings.py文件中，之后不要忘记返回到项目根文件夹：

(portfolio) $ pushd portfolio/
(portfolio) $ echo "import django_heroku" >> settings.py
(portfolio) $ echo "django_heroku.settings(locals())" >> settings.py
(portfolio) $ popd

或者，如果它们在您的 shell 中不起作用，则使用cd portfolio/andcd ..代替pushdandpopd命令。

因为您echo使用上面的附加重定向运算符 ( >>)附加了命令的输出，所以您现在在 Django 设置文件的最底部有两行代码：

# portfolio/settings.py

# ...

import django_heroku
django_heroku.settings(locals())

这将使用基于项目布局和环境变量的值更新本地命名空间中的变量。最后，不要忘记将更改提交到本地 Git 存储库：

(portfolio) $ git commit -am "Automatic configuration with django-heroku"

现在，您应该能够使用0.0.0.0主机名访问您的 Django Web 服务器。没有它，您将无法通过公共 Heroku 域访问您的应用程序。

配置 Heroku 应用程序

您为项目选择了 buildpack 和 Python 版本。您还指定了 Web 进程来接收 HTTP 流量并配置了您的 Django 项目。将 Django 项目部署到 Heroku 之前的最后一个配置步骤需要在远程 Heroku 应用程序上设置环境变量。

无论您的云提供商是哪家，配置管理都很重要。特别是，敏感信息，例如数据库密码或用于对 Django 会话进行加密签名的密钥，不得存储在代码中。您还应该记住禁用调试模式，因为它会使您的站点容易受到黑客攻击。但是，请保持本教程的原样，因为您将不会显示任何自定义内容。

传递此类数据的常用方法是环境变量。Heroku 允许您通过heroku config命令管理应用程序的环境变量。例如，您可能希望从环境变量中读取 Django 密钥，而不是将其硬编码到settings.py文件中。

既然你安装了django-heroku，你就可以让它处理细节。它检测SECRET_KEY环境变量并使用它来设置用于加密签名的 Django 密钥。保持该密钥的安全至关重要。在 中portfolio/settings.py，找到 Django 定义SECRET_KEY变量的自动生成行并将其注释掉：

# SECURITY WARNING: keep the secret key used in production secret!
# SECRET_KEY = 'django-insecure-#+^6_jx%8rmq9oa(frs7ro4pvr6qn7...

除了注释掉SECRET_KEY变量之外，您还可以完全删除它。但是现在先握住你的马，因为你可能马上就需要它了。

当您heroku local现在尝试运行时，它会抱怨不再定义 Django 密钥，并且服务器不会启动。要解决此问题，您可以在当前终端会话中设置变量，但创建一个.env以所有变量命名的特殊文件用于本地测试会更方便。Heroku CLI 将识别此文件并加载其中定义的环境变量。

生成随机密钥的一种快速方法是使用 OpenSSL 命令行工具：

$ echo "SECRET_KEY=$(openssl rand -base64 32)" > .env

如果您的计算机上没有安装 OpenSSL 并且您使用的是 Linux 机器或 macOS，那么您还可以使用Unix 伪随机数生成器生成密钥：

$ echo "SECRET_KEY=$(head -c 32 /dev/urandom | base64)" > .env

这两种方法中的任何一种都将确保真正随机的密钥。您可能会想使用安全性低得多的工具，例如将其设为md5sum当前日期，但这并不真正安全，因为攻击者可以枚举可能的输出。

如果上述命令都不适用于您的操作系统，则暂时取消注释SECRET_KEY变量portfolio/settings.py并在活动虚拟环境中启动 Django shell：

(portfolio) $ python manage.py shell

在那里，您将能够使用 Django 的内置管理实用程序生成一个新的随机密钥：

>>> from django.core.management.utils import get_random_secret_key
>>> print(get_random_secret_key())
6aj9il2xu2vqwvnitsg@!+4-8t3%zwr@$agm7x%o%yb2t9ivt%

获取该密钥并使用它来设置文件中的SECRET_KEY变量.env：

$ echo 'SECRET_KEY=6aj9il2xu2vqwvnitsg@!+4-8t3%zwr@$agm7x%o%yb2t9ivt%' > .env

该heroku local命令会自动获取.env文件中定义的环境变量，因此它现在应该可以按预期工作。SECRET_KEY如果您取消注释变量，请记住再次注释掉它！

最后一步是为远程 Heroku 应用程序指定一个 Django 密钥：

$ heroku config:set SECRET_KEY='6aj9il2xu2vqwvnitsg@!+4-8t3%zwr@$agm7x%o%yb2t9ivt%'
Setting SECRET_KEY and restarting ⬢ polar-island-08305... done, v3
SECRET_KEY: 6aj9il2xu2vqwvnitsg@!+4-8t3%zwr@$agm7x%o%yb2t9ivt%

这将在远程 Heroku 基础设施上永久设置一个新的环境变量，它将立即可供您的 Heroku 应用程序使用。您可以在 Heroku 仪表板或 Heroku CLI 中显示这些环境变量：

$ heroku config
=== polar-island-08305 Config Vars
SECRET_KEY: 6aj9il2xu2vqwvnitsg@!+4-8t3%zwr@$agm7x%o%yb2t9ivt%

$ heroku config:get SECRET_KEY
6aj9il2xu2vqwvnitsg@!+4-8t3%zwr@$agm7x%o%yb2t9ivt%

稍后，您可以用另一个值覆盖它或完全删除它。轮换机密通常是减轻安全威胁的好主意。一旦秘密泄漏，您应该迅速更改它以防止未经授权的访问并限制损害。

配置 PostgreSQL 服务器

当 Heroku 在您的项目中检测到 Django 框架时，它会自动启动一个免费但受限的PostgreSQL实例。它DATABASE_URL使用应用程序数据库的公共 URL设置环境变量。首次部署应用程序时会进行配置，这可以通过检查启用的附加组件和配置变量来确认：

$ heroku addons

Add-on                                            Plan       Price  State
────────────────────────────────────────────────  ─────────  ─────  ───────
heroku-postgresql (postgresql-trapezoidal-06380)  hobby-dev  free   created
 └─ as DATABASE

The table above shows add-ons and the attachments to the current app (...)

$ heroku config
=== polar-island-08305 Config Vars
DATABASE_URL: postgres://ytfeiommjakmxb...amazonaws.com:5432/dcf99cdrgdaqba
SECRET_KEY:   6aj9il2xu2vqwvnitsg@!+4-8t3%zwr@$agm7x%o%yb2t9ivt%

通常，您需要portfolio/settings.py显式使用该变量，但由于您安装了该django-heroku模块，因此无需指定数据库 URL 或用户名和密码。它会自动从环境变量中获取数据库 URL 并为您配置设置。

此外，您无需安装数据库驱动程序即可连接到 Heroku 提供的 PostgreSQL 实例。另一方面，最好针对生产环境中使用的相同类型的数据库进行本地开发。它促进了您的环境之间的平等，并让您利用给定数据库引擎提供的高级功能。

安装时django-heroku，它已经psycopg2作为传递依赖获取：

(portfolio) $ pip list
Package         Version
--------------- -------
asgiref         3.4.1
dj-database-url 0.5.0
Django          3.2.5
django-heroku   0.3.1
pip             21.1.3
psycopg2        2.9.1
pytz            2021.1
setuptools      56.0.0
sqlparse        0.4.1
whitenoise      5.2.0

psycopg2是 PostgreSQL 数据库的 Python 驱动程序。由于驱动程序已经存在于您的环境中，您可以立即开始在您的应用程序中使用 PostgreSQL。

在免费的业余爱好开发计划中，Heroku 施加了一些限制。您最多可以有 10,000 行，这些行必须适合 1 GB 的存储空间。与数据库的连接不能超过 20 个。没有缓存，性能受到限制，以及许多其他限制。

您可以随时使用该heroku pg命令查看有关 Heroku 配置的 PostgreSQL 数据库的详细信息：

$ heroku pg
=== DATABASE_URL
Plan:                  Hobby-dev
Status:                Available
Connections:           1/20
PG Version:            13.3
Created:               2021-07-02 08:55 UTC
Data Size:             7.9 MB
Tables:                0
Rows:                  0/10000 (In compliance) - refreshing
Fork/Follow:           Unsupported
Rollback:              Unsupported
Continuous Protection: Off
Add-on:                postgresql-trapezoidal-06380

此简短摘要包含有关当前连接数、数据库大小、表数和行数等的信息。

在下面的小节中，您将了解如何对 Heroku 上的 PostgreSQL 数据库做一些有用的事情。

更新远程数据库架构

当您在 Django 应用程序中定义新模型时，您通常会创建新的迁移文件并将它们应用于数据库。要更新远程 PostgreSQL 实例的架构，您需要像以前一样运行相同的迁移命令，仅在 Heroku 环境中运行。稍后您将看到推荐的执行此操作的方法，但现在，您可以手动运行适当的命令：

$ heroku run python manage.py migrate
Running python manage.py migrate on ⬢ polar-island-08305... up, run.1434 (Free)
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
(...)

该run插件会启动一个称为一次性 dyno的临时容器，它类似于可以访问应用程序源代码及其配置的Docker容器。由于 dynos 正在运行 Linux 容器，您可以在其中之一中执行任何命令，包括交互式终端会话：

$ heroku run bash
Running bash on ⬢ polar-island-08305... up, run.9405 (Free)
(~) $ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  No migrations to apply.

在临时 dyno 中运行Bash shell是检查或操作 Heroku 应用程序状态的常见做法。您可以将其视为登录到远程服务器。唯一的区别是您正在启动一个一次性虚拟机，其中包含您项目文件的副本并接收与您的实时 Web dyno 相同的环境变量。

但是，这种运行数据库迁移的方式并不是最可靠的，因为您可能会忘记它或在此过程中犯错误。您最好Procfile通过添加突出显示的行来自动执行此步骤：

web: python manage.py runserver 0.0.0.0:$PORT
release: python manage.py migrate

现在，每次发布新版本时，Heroku 都会处理所有待处理的迁移：

$ git commit -am "Automate remote migrations"
$ git push heroku master
(...)
remote: Verifying deploy... done.
remote: Running release command...
remote:
remote: Operations to perform:
remote:   Apply all migrations: admin, auth, contenttypes, sessions
remote: Running migrations:
remote:   No migrations to apply.
To https://git.heroku.com/polar-island-08305.git
   d9f4c04..ebe7bc5  master -> master

它仍然允许您选择是否实际进行任何新迁移。当您进行可能需要一段时间才能完成的大型迁移时，请考虑启用维护模式以避免在用户使用您的应用时损坏或丢失数据：

$ heroku maintenance:on
Enabling maintenance mode for ⬢ polar-island-08305... done

Heroku 将在维护模式下显示此友好页面：

heroku maintenance:off完成迁移后，不要忘记禁用它。

填充数据库

您已经通过应用迁移为 Django 模型创建了数据库表，但这些表大部分仍为空。您迟早会希望将一些数据放入其中。与数据库交互的最佳方式是通过Django 管理界面。要开始使用它，您必须首先远程创建一个超级用户：

$ heroku run python manage.py createsuperuser
Running python manage.py createsuperuser on ⬢ polar-island-08305... up, run.2976 (Free)
Username (leave blank to use 'u23948'): admin
Email address: jdoe@company.com
Password:
Password (again):
Superuser created successfully.

请记住在连接到远程 Heroku 应用程序的数据库中创建超级用户，方法是在相应的命令前加上heroku run。为超级用户提供唯一名称和安全密码后，您将能够登录到 Django 管理视图并开始向数据库添加记录。

您可以通过访问/admin放置在您唯一的 Heroku 应用程序域名之后的路径来访问 Django 管理视图，例如：

https://polar-island-08305.herokuapp.com/admin/

以下是登录后的外观：