跳到主要内容

部署到 Deno Deploy

通过本指南,您可以学习如何构建一个简单的应用程序并将其部署到 Deno Deploy。该应用程序使用 Prisma ORM 将每个请求的日志保存到 Prisma Postgres 数据库。

本指南涵盖了 Prisma CLI 与 Deno CLI、Deno Deploy、Prisma Client 和 Prisma Postgres 的使用。

信息

本指南演示了如何将应用程序部署到 Deno Deploy 并结合 Prisma Postgres 数据库,但您也可以使用 Prisma Accelerate 搭配您自己的数据库

先决条件

  • 一个免费的账户
  • 一个免费的 Deno Deploy 账户
  • 已安装 Node.js 和 npm
  • 已安装 Deno v1.29.4 或更高版本。了解更多
  • (推荐)最新版本的 Prisma ORM。
  • (推荐)VS Code 的 Deno 扩展。了解更多

1. 设置您的应用程序和数据库

首先,为您创建一个项目目录,然后使用 deno runprisma init 将您的应用程序初始化为具有 npm 描述符的 npm 包

要设置您的应用程序,请打开终端并导航到您选择的位置。然后,运行以下命令来设置您的应用程序

mkdir prisma-deno-deploy
cd prisma-deno-deploy
npx prisma@latest init --db

输入项目名称并选择数据库区域。

此命令

  • 将您的 CLI 连接到您的账户。如果您尚未登录或没有账户,浏览器将打开以引导您创建新账户或登录现有账户。
  • 创建一个包含 schema.prisma 文件的 prisma 目录,用于您的数据库模型。
  • 创建一个 .env 文件,其中包含您的 DATABASE_URL(例如,对于 Prisma Postgres,它应该类似于 DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=eyJhbGciOiJIUzI...")。

编辑 prisma/schema.prisma 文件以定义一个 Log 模型,添加自定义的 output 路径,并使用 deno 作为 runtime 添加 prisma-client 生成器

schema.prisma
generator client {
provider = "prisma-client-js"
provider = "prisma-client"
output = "../generated/prisma"
runtime = "deno"
}

datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}

model Log {
id Int @id @default(autoincrement())
level Level
message String
meta Json
}

enum Level {
Info
Warn
Error
}

然后,安装 Prisma Client

deno install npm:@prisma/client

然后,安装使用 Prisma Postgres 所需的客户端扩展

deno install npm:@prisma/extension-accelerate

Prisma Client 在 Deno 上默认不读取 .env 文件,因此您还必须在本地安装 dotenv-cli

deno install npm:dotenv-cli

2. 创建数据库模式

数据模型就绪且数据库连接配置完成后,您现在可以将数据模型应用到数据库。

deno run -A npm:prisma migrate dev --name init

该命令执行两个操作

  1. 它为这次迁移创建一个新的 SQL 迁移文件
  2. 它针对数据库运行 SQL 迁移文件

此时,该命令还有额外的副作用。该命令会安装 Prisma Client 并为项目创建 package.json 文件。

3. 创建您的应用程序

您现在可以创建一个本地 Deno 应用程序。在项目根文件夹中创建 index.ts 并添加以下内容

index.ts
import { serve } from "https://deno.land/std@0.140.0/http/server.ts";
import { withAccelerate } from "npm:@prisma/extension-accelerate";
import { PrismaClient } from "./generated/prisma/client.ts";

const prisma = new PrismaClient().$extends(withAccelerate());

async function handler(request: Request) {
// Ignore /favicon.ico requests:
const url = new URL(request.url);
if (url.pathname === "/favicon.ico") {
return new Response(null, { status: 204 });
}

const log = await prisma.log.create({
data: {
level: "Info",
message: `${request.method} ${request.url}`,
meta: {
headers: JSON.stringify(request.headers),
},
},
});
const body = JSON.stringify(log, null, 2);
return new Response(body, {
headers: { "content-type": "application/json; charset=utf-8" },
});
}

serve(handler);
信息

VS Code 错误:导入路径不能以“.ts”扩展名结尾

如果您使用 VS Code 并在 index.ts 开头的 import 语句中看到错误 导入路径不能以“.ts”扩展名结尾,您需要安装 VS Code 的 Deno 扩展,选择 查看 > 命令面板 并运行命令 Deno: 初始化工作区配置。这会告诉 VS Code 当前项目中的 TypeScript 文件需要用 Deno 运行,从而触发正确的验证。

4. 在本地测试您的应用程序

您现在可以在本地启动应用程序并测试日志条目的创建。

npx dotenv -- deno run -A ./index.ts

在网络浏览器中,打开 http://localhost:8000/。此页面将您的请求写入数据库。

{
"id": 1,
"level": "Info",
"message": "GET http://localhost:8000/",
"meta": {
"headers": "{}"
}
}

刷新页面几次。

每次刷新时,脚本都会生成一个新的日志条目,并且当前日志条目的 id 会递增。

这证实了您的应用程序在本地环境中运行时是正常的。

5. 创建存储库并推送到 GitHub

您需要一个 GitHub 存储库来将您的项目添加到 Deno Deploy 并启用在您推送更改时自动部署。

要设置 GitHub 存储库

  1. 创建一个私有 GitHub 存储库.

  2. 在本地初始化您的存储库并将您的更改推送到 GitHub,使用以下命令

    git init -b main
    git remote add origin https://github.com/<username>/prisma-deno-deploy
    git add .
    git commit -m "initial commit"
    git push -u origin main

6. 部署到 Deno Deploy

使用 GitHub 存储库将您的应用程序添加到 Deno Deploy

  1. 前往 https://dash.deno.com/
  2. 选择一个 GitHub 组织或用户,然后选择一个存储库。
  3. 选择一个生产分支并选择 Fresh (Automatic) 模式,以便 Deno Deploy 可以在您每次推送更改到存储库时进行部署。
  4. Build Step 中添加 deno run -A npm:prisma generate 来生成 Prisma Client。
  5. 选择 index.ts 作为您项目的入口点。
  6. 点击 创建并部署

部署应该会失败,因为您必须添加 DATABASE_URL 环境变量。

找到并导航到项目的设置。

  1. 要定义数据库连接字符串,请在 环境变量 部分点击 添加变量
    1. 对于 KEY,输入 DATABASE_URL
    2. 对于 VALUE,粘贴数据库连接字符串。
  2. 点击 保存

您必须添加一些代码并创建另一个提交以触发重新部署。

在您的 index.ts 文件中添加以下代码

index.ts
import { serve } from "https://deno.land/std@0.140.0/http/server.ts";
import { withAccelerate } from "npm:@prisma/extension-accelerate";
import { PrismaClient } from "./generated/prisma/client.ts";

const prisma = new PrismaClient().$extends(withAccelerate());

async function handler(request: Request) {
// Ignore /favicon.ico requests:
const url = new URL(request.url);
if (url.pathname === "/favicon.ico") {
return new Response(null, { status: 204 });
}

console.log("Request received.")

const log = await prisma.log.create({
data: {
level: "Info",
message: `${request.method} ${request.url}`,
meta: {
headers: JSON.stringify(request.headers),
},
},
});
const body = JSON.stringify(log, null, 2);
return new Response(body, {
headers: { "content-type": "application/json; charset=utf-8" },
});
}

serve(handler);

提交新更改

git add . 
git commit -m "add log"
git push origin main

这将重新构建部署,现在由于添加了环境变量而起作用。完成后,按照部署输出中的 URL。应用程序应该显示与之前相同的结果,带有新的、递增的日志记录 ID

{
"id": 5,
"level": "Info",
"message": "GET https://prisma-deno-deploy.deno.dev/",
"meta": {
"headers": "{}"
}
}

总结

您已成功部署了一个您使用 TypeScript 创建的 Deno 应用程序,该应用程序使用 Prisma Client 连接到 Prisma Postgres 数据库。

© . All rights reserved.