部署到 Render
本指南解释了如何将使用 Prisma ORM 和 PostgreSQL 的 Node.js 服务器部署到 Render。
Prisma Render 部署示例 包含一个带有 REST 端点和简单前端的 Express.js 应用程序。此应用程序使用 Prisma Client 从其数据库中获取、创建和删除记录。
关于 Render
Render 是一个云应用程序平台，使开发人员可以轻松部署和扩展全栈应用程序。对于此示例，了解以下内容很有帮助：
- Render 允许您部署长时间运行的“有服务器”全栈应用程序。您可以配置 Render 服务以根据 CPU 和/或内存使用情况进行 自动扩展。这是您可以选择的几种 部署范例 之一。
- Render 原生支持 常用运行时，包括 Node.js 和 Bun。在本指南中，我们将使用 Node.js 运行时。
- Render 与 Git 仓库集成，以便在提交时自动部署。您可以从 GitHub、GitLab 或 Bitbucket 部署到 Render。在本指南中，我们将从 Git 仓库进行部署。
先决条件
- 注册一个 Render 帐户
获取示例代码
将 示例代码 下载到您的本地机器。
curl https://codeload.github.com/prisma/prisma-examples/tar.gz/latest | tar -xz --strip=2 prisma-examples-latest/deployment-platforms/render
cd render
了解示例
在部署应用程序之前，让我们看一下示例代码。
Web 应用程序
Express 应用程序的逻辑在两个文件中：
src/index.js：API。端点使用 Prisma Client 从数据库中获取、创建和删除数据。public/index.html：Web 前端。前端调用一些 API 端点。
Prisma schema 和迁移
此应用程序的 Prisma 组件在两个文件中：
prisma/schema.prisma：此应用程序的数据模型。此示例定义了两个模型，User和Post。此文件的格式遵循 Prisma schema。prisma/migrations/<migration name>/migration.sql：在 PostgreSQL 数据库中构建此 schema 的 SQL 命令。您可以通过运行prisma migrate dev自动生成像这样的迁移文件。
Render Blueprint
render.yaml 文件是一个 Render blueprint。Blueprint 是 Render 的基础设施即代码格式。您可以使用 Blueprint 以编程方式在 Render 上创建和修改服务。
render.yaml 定义了 Blueprint 将在 Render 上启动的服务。在此 render.yaml 中，我们看到：
- 使用 Node 运行时的 Web 服务：这是 Express 应用程序。
- PostgreSQL 数据库：这是 Express 应用程序使用的数据库。
此文件的格式遵循 Blueprint 规范。
Render 部署如何与 Prisma Migrate 协同工作
通常，您希望在 Web 应用程序启动之前运行所有数据库迁移。否则，当应用程序查询没有预期表和行的数据库时，可能会遇到错误。
您可以使用 Render 部署中的“Pre-Deploy Command”设置在应用程序启动之前运行任何命令，例如数据库迁移。
有关 Pre-Deploy Command 的更多详细信息，请参阅 Render 的部署指南。
在我们的示例代码中，render.yaml 显示了 Web 服务的构建命令、Pre-Deploy Command 和启动命令。值得注意的是，npx prisma migrate deploy（Pre-Deploy Command）将在 npm run start（启动命令）之前运行。
| 命令 | 值 |
|---|---|
| 构建命令 | npm install --production=false |
| Pre-Deploy Command | npx prisma migrate deploy |
| 启动命令 | npm run start |
部署示例
1. 初始化您的 Git 仓库
- 将 示例代码 下载到您的本地机器。
- 在 GitHub、GitLab 或 BitBucket 上创建一个新的 Git 仓库。
- 将示例代码上传到您的新仓库。
2. 手动部署
- 在 Render 仪表板中，单击 New > PostgreSQL。提供数据库名称，然后选择一个计划。（免费计划适用于此演示。）
- 在您的数据库准备就绪后，查找其 内部 URL。
- 在 Render 仪表板中，单击 New > Web Service 并连接包含示例代码的 Git 仓库。
- 在服务创建期间提供以下值：
| 设置 | 值 |
|---|---|
| 语言 | Node |
| 构建命令 | npm install --production=false |
| Pre-Deploy Command（注意：这可能在“Advanced”选项卡中） | npx prisma migrate deploy |
| 启动命令 | npm run start |
| 环境变量 | 将 DATABASE_URL 设置为数据库的内部 URL |
就是这样。您的 Web 服务将在构建完成后立即在其 onrender.com URL 上上线。
3. （可选）使用基础设施即代码部署
您还可以使用 Render Blueprint 部署示例。按照 Render 的 [Blueprint 设置指南] 并使用示例中的 render.yaml。
奖励：Seed 数据库
Prisma ORM 包括一个用于使用启动数据 seed 数据库 的框架。在我们的示例中，prisma/seed.js 定义了一些测试用户和帖子。
要将这些用户添加到数据库，我们可以选择：
- 将 seed 脚本添加到我们的 Pre-Deploy Command，或者
- 通过 SSH shell 在我们的服务器上手动运行命令
方法 1：Pre-Deploy Command
如果您手动部署了 Render 服务：
- 在 Render 仪表板中，导航到您的 Web 服务。
- 选择 Settings。
- 将 Pre-Deploy Command 设置为：
npx prisma migrate deploy; npx prisma db seed
如果您使用 Blueprint 部署了 Render 服务：
- 在您的
render.yaml文件中，将preDeployCommand更改为：npx prisma migrate deploy; npx prisma db seed - 将更改提交到您的 Git 仓库。
方法 2：SSH
Render 允许您 SSH 进入您的 Web 服务。
- 按照 Render 的 SSH 指南 连接到您的服务器。
- 在 shell 中，运行：
npx prisma db seed