部署到 Heroku
在本指南中，您将设置并部署一个 Node.js 服务器，该服务器使用 Prisma ORM 和 PostgreSQL 与 Heroku 集成。该应用程序公开了一个 REST API，并使用 Prisma Client 处理从数据库中获取、创建和删除记录。
Heroku 是一个云平台即服务 (PaaS)。与流行的无服务器部署模型相比，使用 Heroku 时，即使没有向其发出请求，您的应用程序也会持续运行。由于 PostgreSQL 数据库的连接限制，这带来了诸多好处。有关更多信息，请查看 常规部署文档
通常，Heroku 与 Git 存储库集成，以便在提交时自动部署。您可以从 GitHub 存储库部署到 Heroku，也可以将您的源代码推送到 Heroku 为每个应用创建的 Git 存储库。本指南使用后一种方法，您将代码推送到 Heroku 上的应用存储库，这将触发构建并部署应用程序。
该应用程序具有以下组件
- 后端：使用 Express.js 构建的 Node.js REST API，具有使用 Prisma Client 处理针对 PostgreSQL 数据库（例如，托管在 Heroku 上）的数据库操作的资源端点。
- 前端：用于与 API 交互的静态 HTML 页面。
本指南的重点是如何将使用 Prisma ORM 的项目部署到 Heroku。起点将是 Prisma Heroku 示例，其中包含一个 Express.js 服务器，其中包含几个预配置的 REST 端点和一个简单的前端。
注意：本指南中的各种检查点使您可以验证是否正确执行了步骤。
关于将 GraphQL 服务器部署到 Heroku 的说明
虽然示例使用 REST，但相同的原理也适用于 GraphQL 服务器，主要区别在于您通常只有一个 GraphQL API 端点，而不是像 REST 那样为每个资源提供一个路由。
先决条件
- Heroku 帐户。
- Heroku CLI 已安装。
- 已安装 Node.js。
- 已安装 PostgreSQL CLI
psql。
注意：Heroku 没有提供免费套餐，因此需要提供账单信息。
Prisma ORM 工作流程
Prisma ORM 的核心是 Prisma 模式 - 一个声明性配置，您可以在其中定义数据模型和其他与 Prisma ORM 相关的配置。Prisma 模式也是 Prisma Client 和 Prisma Migrate 的单一事实来源。
在本指南中，您将使用 Prisma Migrate 创建数据库模式。Prisma Migrate 基于 Prisma 模式，并通过生成针对数据库执行的 .sql 迁移文件来工作。
Migrate 带有两个主要工作流程
- 使用
prisma migrate dev创建迁移并在本地开发期间应用 - 使用
prisma migrate deploy将生成的迁移应用到生产环境
为简洁起见，本指南不介绍如何使用 prisma migrate dev 创建迁移。相反，它侧重于生产工作流程，并使用示例代码中包含的 Prisma 模式和 SQL 迁移。
您将使用 Heroku 的 发布阶段 运行 prisma migrate deploy 命令，以便在应用程序启动之前应用迁移。
要详细了解如何使用 Prisma Migrate 创建迁移，请查看 从头开始指南
1. 下载示例并安装依赖项
打开您的终端并导航到您选择的某个位置。创建将保存应用程序代码的目录并下载示例代码
mkdir prisma-heroku
cd prisma-heroku
curl https://codeload.github.com/prisma/prisma-examples/tar.gz/latest | tar -xz --strip=3 prisma-examples-latest/deployment-platforms/heroku
检查点：ls -1 应显示
ls -1
Procfile
README.md
package.json
prisma
public
src
安装依赖项
npm install
注意：
Procfile告诉 Heroku 启动应用程序所需的命令，即npm start，以及在发布阶段运行的命令，即npx prisma migrate deploy
2. 为应用程序创建 Git 存储库
在上一步骤中，您下载了代码。在此步骤中，您将从代码创建存储库，以便您可以将其推送到 Heroku 以进行部署。
为此，请从源代码文件夹运行 git init
git init
> Initialized empty Git repository in /Users/alice/prisma-heroku/.git/
要使用 main 分支作为默认分支，请运行以下命令
git branch -M main
初始化存储库后，添加并提交文件
git add .
git commit -m 'Initial commit'
检查点：git log -1 应显示提交
git log -1
commit 895534590fdd260acee6396e2e1c0438d1be7fed (HEAD -> main)
3. Heroku CLI 登录
确保您已使用 CLI 登录到 Heroku
heroku login
这将允许您从终端部署到 Heroku。
检查点：heroku auth:whoami 应显示您的用户名
heroku auth:whoami
> your-email
4. 创建 Heroku 应用
要将应用程序部署到 Heroku，您需要创建一个应用。您可以使用以下命令执行此操作
heroku apps:create your-app-name
注意：使用您选择的唯一名称代替
your-app-name。
检查点：您应该会看到您的 Heroku 应用的 URL 和存储库
heroku apps:create your-app-name
> Creating ⬢ your-app-name... done
> https://your-app-name.herokuapp.com/ | https://git.heroku.com/your-app-name.git
创建 Heroku 应用会将 Heroku 创建的 git 远程添加到您的本地存储库。将提交推送到此远程将触发部署。
检查点：git remote -v 应显示您的应用程序的 Heroku git 远程
heroku https://git.heroku.com/your-app-name.git (fetch)
heroku https://git.heroku.com/your-app-name.git (push)
如果您没有看到 heroku 远程，请使用以下命令添加它
heroku git:remote --app your-app-name
5. 将 PostgreSQL 数据库添加到您的应用程序
Heroku 允许您将 PostgreSQL 数据库作为应用程序的一部分进行配置。
使用以下命令创建数据库
heroku addons:create heroku-postgresql:hobby-dev
检查点：要验证数据库是否已创建，您应该会看到以下内容
Creating heroku-postgresql:hobby-dev on ⬢ your-app-name... free
Database has been created and is available
! This database is empty. If upgrading, you can transfer
! data from another database with pg:copy
Created postgresql-parallel-73780 as DATABASE_URL
注意： 当应用程序在 Heroku 上运行时，Heroku 会自动设置
DATABASE_URL环境变量。Prisma ORM 使用此环境变量，因为它在 Prisma 模式（prisma/schema.prisma）的 数据源 块中使用env("DATABASE_URL")声明。
6. 推送以部署
通过将更改推送到 Heroku 应用程序存储库来部署应用程序
git push heroku main
这将触发构建并将其应用程序部署到 Heroku。Heroku 还将运行 npx prisma migrate deploy 命令，该命令在部署应用程序之前执行迁移以创建数据库模式（如 Procfile 的 release 步骤中定义）。
检查点： git push 将发出构建和发布阶段的日志，并显示已部署应用程序的 URL
remote: -----> Launching...
remote: ! Release command declared: this new release will not be available until the command succeeds.
remote: Released v5
remote: https://your-app-name.herokuapp.com/ deployed to Heroku
remote:
remote: Verifying deploy... done.
remote: Running release command...
remote:
remote: Prisma schema loaded from prisma/schema.prisma
remote: Datasource "db": PostgreSQL database "your-db-name", schema "public" at "your-db-host.compute-1.amazonaws.com:5432"
remote:
remote: 1 migration found in prisma/migrations
remote:
remote: The following migration have been applied:
remote:
remote: migrations/
remote: └─ 20210310152103_init/
remote: └─ migration.sql
remote:
remote: All migrations have been successfully applied.
remote: Waiting for release.... done.
注意： Heroku 还将设置
PORT环境变量，您的应用程序将绑定到该变量。
7. 测试您已部署的应用程序
您可以使用静态前端与您通过预览 URL 部署的 API 进行交互。
在浏览器中打开预览 URL，URL 应如下所示：https://APP_NAME.herokuapp.com。您应该看到以下内容
这些按钮允许您向 REST API 发出请求并查看响应
- 检查 API 状态：将调用返回
{"up":true}的 REST API 状态端点。 - 种子数据：将使用测试
user和post为数据库播种数据。返回创建的用户。 - 加载 Feed：将加载数据库中所有包含其相关
profiles的users。
有关 Prisma Client API 的更多见解，请查看 src/index.js 文件中的路由处理程序。
您可以使用 heroku logs --tail 命令查看应用程序的日志
2020-07-07T14:39:07.396544+00:00 app[web.1]:
2020-07-07T14:39:07.396569+00:00 app[web.1]: > [email protected] start /app
2020-07-07T14:39:07.396569+00:00 app[web.1]: > node src/index.js
2020-07-07T14:39:07.396570+00:00 app[web.1]:
2020-07-07T14:39:07.657505+00:00 app[web.1]: 🚀 Server ready at: https://127.0.0.1:12516
2020-07-07T14:39:07.657526+00:00 app[web.1]: ⭐️ See sample requests: http://pris.ly/e/ts/rest-express#3-using-the-rest-api
2020-07-07T14:39:07.842546+00:00 heroku[web.1]: State changed from starting to up
Heroku 特定说明
本指南介绍了一些与 Heroku 相关的实现细节，值得重申
- 端口绑定：Web 服务器绑定到端口以便接受连接。当部署到 Heroku 时，
PORT环境变量由 Heroku 设置。确保绑定到process.env.PORT，以便您的应用程序在部署后可以接受请求。一种常见的模式是尝试绑定到process.env.PORT并回退到预设端口，如下所示
const PORT = process.env.PORT || 3000
const server = app.listen(PORT, () => {
console.log(`app running on port ${PORT}`)
})
- 数据库 URL：作为 Heroku 配置过程的一部分，
DATABASE_URL配置变量将添加到您的应用程序配置中。它包含您的应用程序用于访问数据库的 URL。确保您的schema.prisma文件使用env("DATABASE_URL")，以便 Prisma Client 可以成功连接到数据库。
总结
恭喜！您已成功将使用 Prisma ORM 的 Node.js 应用程序部署到 Heroku。
您可以在 此 GitHub 存储库中找到示例的源代码。
有关 Prisma Client API 的更多见解，请查看 src/index.js 文件中的路由处理程序。