跳到主要内容

部署到 Netlify

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

Netlify 是一个用于持续部署、静态站点和无服务器函数的云平台。Netlify 与 GitHub 无缝集成,以便在提交时自动部署。当您按照以下步骤操作时,您将使用该方法创建一个 CI/CD 管道,该管道从 GitHub 存储库部署您的应用程序。

先决条件

在您可以按照本指南操作之前,您需要设置您的应用程序以开始部署到 Netlify。我们推荐 “Netlify 入门” 指南以获得快速概览,以及 “部署函数” 以深入了解您的部署选项。

schema.prisma 中的二进制目标

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

根据 Node.js 的版本,您的 Prisma schema 应在 generator 代码块中包含 rhel-openssl-1.0.xrhel-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。这些选项在 Netlfiy 的文档中讨论,其中一种方法是通过 UI 上传,如下所述。

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

现在启动新的 Netlify 构建和部署,以便新的构建可以使用新上传的环境变量。

netlify deploy

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

连接池

当您使用函数即服务提供商(如 Netlify)时,出于性能原因,对数据库连接进行池化是有益的。这是因为每次函数调用都可能导致与数据库的新连接,这可能会很快耗尽打开的连接。

您可以使用 Accelerate 进行连接池化,以减小 Prisma Client 捆绑包大小,并避免冷启动。

有关无服务器环境的连接管理的更多信息,请参阅我们的 连接管理指南