在 Railway 上使用 Bun 和 PostgreSQL 的 Drizzle

创建 Railway 项目

登录你的 Railway 控制台并点击 New Project 按钮。

配置 PostgreSQL 数据库

在项目画布中，点击右上角的 New 按钮，然后选择 Database → PostgreSQL。你也可以使用命令面板（Cmd/Ctrl + K）并搜索 PostgreSQL。Railway 将为你提供一个新的 PostgreSQL 实例。

获取连接字符串

点击项目中的 PostgreSQL 服务，进入 Variables 选项卡，找到 DATABASE_PUBLIC_URL 变量。复制其值——它应该类似于这样：

postgresql://postgres:password@region.railway.app:port/railway

设置连接字符串变量

在项目根目录创建一个 .env 文件，并添加 DATABASE_URL 环境变量。使用来自 Railway 的公共连接字符串：

DATABASE_URL=postgresql://postgres:password@region.railway.app:port/railway

将 Drizzle ORM 连接到数据库

创建一个 db.ts 文件并设置数据库配置：

import { drizzle } from "drizzle-orm/node-postgres";

export const db = drizzle(process.env.DATABASE_URL!);

创建表

创建一个 schema.ts 文件并声明你的表：

import * as p from "drizzle-orm/pg-core";

export const usersTable = p.pgTable("users", {
  id: p.serial().primaryKey(),
  name: p.text().notNull(),
  age: p.integer().notNull(),
  email: p.text().notNull().unique(),
});

export const postsTable = p.pgTable("posts", {
  id: p.serial().primaryKey(),
  title: p.text().notNull(),
  content: p.text().notNull(),
  userId: p
    .integer()
    .notNull()
    .references(() => usersTable.id, { onDelete: "cascade" }),
  createdAt: p.timestamp().notNull().defaultNow(),
  updatedAt: p
    .timestamp()
    .notNull()
    .$onUpdate(() => new Date()),
});

export type InsertUser = typeof usersTable.$inferInsert;
export type SelectUser = typeof usersTable.$inferSelect;

export type InsertPost = typeof postsTable.$inferInsert;
export type SelectPost = typeof postsTable.$inferSelect;

设置 Drizzle 配置文件

Drizzle config - 一个由 Drizzle Kit 使用的配置文件，包含数据库连接、迁移文件夹和 schema 文件的所有信息。

在项目根目录创建一个 drizzle.config.ts 文件并添加以下内容：

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  schema: "./src/schema.ts",
  out: "./migrations",
  dialect: "postgresql",
  dbCredentials: {
    url: process.env.DATABASE_URL!,
  },
});

将更改应用到数据库

你可以使用 drizzle-kit generate 命令生成迁移，然后使用 drizzle-kit migrate 命令运行它们。

生成迁移：

bunx drizzle-kit generate

generate 命令仅会根据你的 schema 创建迁移 SQL 文件——它不会将任何更改应用到数据库。这些迁移会按照 drizzle.config.ts 中的配置存储在 migrations 目录中。该目录将包含更新数据库 schema 所需的 SQL 文件，以及用于存储不同迁移阶段 schema 快照的 meta 文件夹。

生成的迁移示例：

CREATE TABLE "posts" (
	"id" serial PRIMARY KEY NOT NULL,
	"title" text NOT NULL,
	"content" text NOT NULL,
	"userId" integer NOT NULL,
	"createdAt" timestamp DEFAULT now() NOT NULL,
	"updatedAt" timestamp NOT NULL
);
--> statement-breakpoint
CREATE TABLE "users" (
	"id" serial PRIMARY KEY NOT NULL,
	"name" text NOT NULL,
	"age" integer NOT NULL,
	"email" text NOT NULL,
	CONSTRAINT "users_email_unique" UNIQUE("email")
);
--> statement-breakpoint
ALTER TABLE "posts" ADD CONSTRAINT "posts_userId_users_id_fk" FOREIGN KEY ("userId") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;

将生成的迁移应用到数据库：

bunx drizzle-kit migrate

另外，你也可以使用 Drizzle kit push 命令直接将更改推送到数据库：

bunx drizzle-kit push

为部署准备你的项目

一旦你生成了迁移，请将 migrations 目录提交到你的仓库——当应用启动时，这些文件将会自动应用。

创建一个 index.ts 文件作为应用入口。下面的示例会在启动时运行迁移，然后使用 Bun 启动一个简单的 HTTP 服务器：

import { drizzle } from "drizzle-orm/node-postgres";
import { migrate } from "drizzle-orm/node-postgres/migrator";
import { usersTable } from "./schema";

const db = drizzle(process.env.DATABASE_URL!);

await migrate(db, { migrationsFolder: "./migrations" });

const server = Bun.serve({
  port: process.env.PORT || 3000,
  async fetch(req) {
    const url = new URL(req.url);

    if (url.pathname === "/users") {
      const users = await db.select().from(usersTable);
      return new Response(JSON.stringify(users), {
        headers: { "Content-Type": "application/json" },
      });
    }

    return new Response("OK");
  },
});

console.log(`Server running on port ${server.port}`);

migrate() 函数会读取 migrations 目录中的 SQL 文件，并将所有尚未应用的迁移应用到数据库。它可以安全地在每次启动时运行——已经应用过的迁移会被跳过。

确保你的 package.json 包含一个 start 脚本：

{
  "scripts": {
    "start": "bun src/index.ts"
  }
}

将项目推送到 GitHub

Railway 从 GitHub 仓库部署。初始化 git 仓库并推送你的代码：

git init
git add .
git commit -m "initial commit"

在 GitHub 上创建一个新仓库并将你的代码推送过去。

将你的 GitHub 仓库连接到 Railway

在你的 Railway 项目中，点击画布右上角的 New 按钮并选择 GitHub Repo。如有提示，请连接你的 GitHub 账户，然后选择你刚刚推送的仓库。

配置环境变量

在已部署服务的设置中，进入 Variables 选项卡。通过引用 PostgreSQL 服务变量添加 DATABASE_URL 变量：

点击 Add Variable，将名称设为 DATABASE_URL，并使用 Railway 变量引用 ${{Postgres.DATABASE_URL}} 作为值。

部署

当你推送到已连接的分支时，Railway 会自动部署你的应用。你可以在 Deployments 选项卡中监控部署过程。

验证你的设置

部署完成后，前往 Railway 项目的 Architecture 选项卡。你应该能看到你的应用服务已连接到 PostgreSQL 数据库。

bunx drizzle-kit migrate

从模板添加一个新服务

在你的 Railway 项目中，点击画布右上角的 New 按钮，然后选择 Template。

选择 Drizzle Studio 模板

搜索 drizzle studio，然后选择 Drizzle 提供的 Drizzle Studio 模板。

配置环境变量并部署

该模板包含两个预配置的环境变量：

• PASSCODE - 访问你的 Studio 实例的密码。默认值为 ${{secret()}}，它会生成一个随机密钥。
• DATABASE_URL - 数据库连接字符串。将其设置为 ${{Postgres.DATABASE_URL}}，以引用你现有的 PostgreSQL 服务。

点击 Deploy Template 进行部署。

找到你的 Drizzle Studio URL

部署完成后，点击项目中的 Drizzle Studio 服务，进入 Settings 选项卡，并向下滚动到 Networking 部分。你会在 Public Networking 下找到你的公共域名。

使用 Drizzle Studio 浏览你的数据库

在浏览器中打开 Drizzle Studio 的 URL。你应该可以看到数据库表，并能直接浏览、筛选和编辑数据。

验证你的设置

进入你 Railway 项目中的 Architecture 选项卡。现在你应该能看到三个服务：你的应用、PostgreSQL 数据库和 Drizzle Studio。