跳到主要内容

部署到 Netlify

本指南涵盖了将使用 Prisma ORM 的应用程序部署到 Netlify 所需的步骤。

Netlify 是一个用于持续部署、静态站点和 serverless 函数的云平台。Netlify 与 GitHub 无缝集成，可在提交时自动部署。按照以下步骤操作，您将使用这种方法从 GitHub 仓库创建一条 CI/CD 流水线来部署您的应用程序。

前提条件​

在遵循本指南之前，您需要设置您的应用程序以开始部署到 Netlify。我们推荐阅读 "Netlify 入门" 指南以快速了解概况，并阅读 "部署函数" 以深入了解您的部署选项。

schema.prisma 中的二进制目标​

由于您的代码将部署到 Netlify 的环境，该环境不一定与您的开发环境相同，因此您需要在构建步骤中设置 binaryTargets，以下载与 Netlify 运行时兼容的查询引擎。如果您不设置此选项，您的部署代码将包含不正确的查询引擎，并且无法正常工作。

根据 Node.js 的版本，您的 Prisma schema 应在 generator 块中包含 rhel-openssl-1.0.x 或 rhel-openssl-3.0.x

binaryTargets = ["native", "rhel-openssl-1.0.x"]

在 Netlify 中存储环境变量​

我们建议将 .env 文件保留在您的 .gitignore 中，以防止敏感连接字符串泄露。相反，您可以使用 Netlify CLI 直接将值导入 Netlify。

假设您有以下文件

.env
# Connect to DB
DATABASE_URL="postgresql://postgres:__PASSWORD__@__HOST__:__PORT__/__DB_NAME__"

您可以使用 env:import 命令将文件作为环境变量上传

netlify env:import .env
显示查询结果
site: my-very-very-cool-site
---------------------------------------------------------------------------------.
                         Imported environment variables                          |
---------------------------------------------------------------------------------|
     Key      |                              Value                               |
--------------|------------------------------------------------------------------|
 DATABASE_URL | postgresql://postgres:__PASSWORD__@__HOST__:__PORT__/__DB_NAME__ |
---------------------------------------------------------------------------------'
如果您没有使用 .env 文件

如果您以不同的方式存储数据库连接字符串和其他环境变量，则需要手动将环境变量上传到 Netlify。这些选项在 Netlify 的文档中有所讨论，下面描述了其中一种方法：通过 UI 上传。

  1. 打开站点的 Netlify 管理 UI。您可以使用 Netlify CLI 如下： 
    netlify open --admin
  2. 点击 站点设置：Netlify 管理 UI
  3. 在左侧边栏中导航到 构建与部署 并选择 环境变量。
  4. 点击 编辑变量 并创建一个键为 DATABASE_URL 的变量，将其值设置为您的数据库连接字符串。Netlify 环境变量
  5. 点击 保存。

现在开始新的 Netlify 构建和部署，以便新的构建可以使用新上传的环境变量。

netlify deploy

您现在可以测试已部署的应用程序了。

连接池​

当您使用 Functions-as-a-Service 提供商（如 Netlify）时，出于性能考虑，对数据库连接进行池化是有益的。这是因为每次函数调用都可能导致与数据库建立新的连接，这会很快耗尽打开的连接。

您可以使用 Accelerate 进行连接池化，或者使用内置连接池的 Prisma Postgres 来减少 Prisma Client 的打包大小，并避免冷启动。

有关 serverless 环境下连接管理的更多信息，请参阅我们的连接管理指南。