部署到Railway

本指南解释了如何将使用 Prisma ORM 和 Prisma Postgres 的应用程序部署到 Railway。该应用程序公开了一个 REST API，并使用 Prisma Client 查询 Prisma Postgres 数据库。您的应用程序将在 Railway 上运行，并连接到托管的 Prisma Postgres 数据库。

Railway 是一个部署平台，通过即时部署、内置可观察性和轻松扩展来简化软件开发生命周期。它支持来自流行注册表的代码仓库和容器镜像。Railway 处理配置管理、环境变量，并提供服务之间的私有网络。

要获取一个预先连接了 Prisma ORM、Prisma Postgres 和 Railway 的 Next.js 项目，请使用官方 Prisma Railway 模板。

此模板自动化了 Prisma Postgres 数据库的配置和设置，在部署时将其直接链接到您的 Next.js 应用程序，只需一键即可使整个项目准备就绪。

先决条件

要开始，您需要：

• 一个 Railway 账户
• 一个包含您的应用程序代码的 GitHub 仓库。

注意

如果您没有准备好的项目，可以使用我们的示例 Prisma 项目。它是一个简单的 Hono 应用程序，使用 Prisma ORM，并包含一个 REST API、一个用于测试端点的前端以及一个定义了迁移的 Prisma schema。

部署您的应用程序

1. 创建一个新的 Railway 项目

1. 前往 Railway 控制面板
2. 点击 创建新项目
3. 选择 GitHub 仓库
4. 点击 配置 GitHub App 并授权 Railway
5. 选择您的仓库

您的应用程序现在正在部署到 Railway，但如果没有数据库连接，它将无法正常运行。

在下一节中，您将配置数据库并在 Railway 中设置 DATABASE_URL 环境变量。

配置您的数据库

1. 获取您的数据库连接字符串

您将需要一个 Prisma Postgres 连接字符串。有两种方法可以获取：

• 在以下位置创建新数据库：
• 运行 npx create-db 以获取临时数据库（无需账户）

2. 将数据库 URL 添加到 Railway

1. 在您的 Railway 项目中，打开您的服务
2. 转到 变量 选项卡
3. 点击 新建变量
4. 将名称设置为 DATABASE_URL
5. 粘贴您的数据库连接字符串作为值
6. 点击 部署 以使用新的环境变量重新部署您的应用程序

3. 访问您的应用程序

一旦部署完成并配置了数据库 URL

1. 导航到 设置 选项卡
2. 在 网络 下，点击 生成域名
3. 您的应用程序将在生成的 URL 上可用

访问生成的 URL，您将看到已部署的应用程序！

如果您使用了示例项目，您应该会看到三个已设置的 API 端点

• 检查 API 状态 (/api)
• 加载 feed (/api/feed)
• 种子数据 (/api/seed)

如果看到任何错误

• 等待一分钟并刷新
• 确保 DATABASE_URL 已设置
• 检查服务日志
• 重新部署

要了解更多关于 Railway 为您的应用程序提供的各种功能，请访问Railway 文档。