Deno 子托管的 KV 备份

子托管允许您以编程方式在安全的沙箱中运行来自多个用户的不可信 JavaScript，而无需管理复杂的基础设施。自其自助式启动以来，许多客户使用子托管来将电子商务店面托管在靠近用户的服务器上，为低代码工作流构建器提供代码级定制逃生舱，甚至简单地转售无服务器边缘函数。

今天，我们很高兴地宣布**KV 备份现已可用于子托管**。此功能为您和您的用户提供了改进的数据持久性，因为您现在可以将KV 数据库不断备份到您自己的与 S3 兼容的对象存储，使用时间点恢复，以及更多功能。

让我们深入了解如何使用此功能。

为您的用户提供简单、持久的数据存储

您的用户可能希望为其代码添加数据持久性。虽然他们可以导入任意数量的 npm 包来连接到数据存储，但最简单的方法是使用内置的 KV API

const kv = await Deno.openKv();

您的用户可以访问全局复制的 ACID 数据库，只需一行代码即可，无需任何配置。

这使您的用户可以跳过配置新数据库实例和处理 API 密钥，直接进入编写代码。但是请注意，要为您的用户启用 KV，您需要以编程方式创建一个 KV 数据库，然后将其附加到新部署。

了解有关使用 Deno KV 构建的更多信息.

设置 KV 数据库

在我们向您展示如何对 KV 数据库执行备份操作之前，让我们首先使用POST /organizations/{organizationId}/databases 在您的组织中创建一个数据库。

import { assert } from "jsr:@std/assert/assert";

const orgId = "your-organization-id";
const orgToken = "your-organization-token";

// Create a new database in your organization
const res = await fetch(
  `https://api.deno.com/v1/organizations/${orgId}/databases`,
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${orgToken}`,
    },
    body: JSON.stringify({
      description: "my database",
    }),
  },
);

assert(res.ok);

// You can get database ID from response body
const { id: databaseId } = await res.json();
console.log(databaseId);

启用 KV 备份

拥有 KV 数据库后，您可以使用POST /databases/{databaseId}/database_backups 启用备份。以下示例展示了如何将备份启用到与 S3 兼容的对象存储，在本例中为 Google Cloud Storage

import { assert } from "jsr:@std/assert/assert";

const ACCESS_KEY_ID = Deno.env.get("ACCESS_KEY_ID")!;
const SECRET_ACCESS_KEY = Deno.env.get("SECRET_ACCESS_KEY")!;

const orgToken = "your-organization-token";
// Database ID you got from the previous step
const databaseId = "database-id";

const res = await fetch(
  `https://api.deno.com/v1/databases/${databaseId}/database_backups`,
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${orgToken}`,
    },
    body: JSON.stringify({
      kind: "s3",
      endpoint: "https://storage.googleapis.com",
      bucketName: "test-kv-backup",
      bucketRegion: "us-central1",
      accessKeyId: ACCESS_KEY_ID,
      secretAccessKey: SECRET_ACCESS_KEY,
      prefix: "backup/",
    }),
  },
);

assert(res.ok);

// You can get database backup ID from response body
const { id: databaseBackupId } = await res.json();
console.log(databaseBackupId);

然后，您可以使用GET /database_backups/{databaseBackupId} 获取备份状态以及其他信息。

import { assert } from "jsr:@std/assert/assert";

const orgToken = "your-organization-token";
// Database backup ID you got from the previous step
const databaseBackupId = "database-backup-id";

const res = await fetch(
  `https://api.deno.com/v1/database_backups/${databaseBackupId}`,
  {
    headers: {
      authorization: `Bearer ${orgToken}`,
    },
  },
);

assert(res.ok);

console.log(await res.json());
// You would see something like:
// {
//   id: "database-id",
//   kind: "s3",
//   endpoint: "https://storage.googleapis.com",
//   bucketName: "test-kv-backup",
//   bucketRegion: "us-central1",
//   accessKeyId: "YOUR_ACCESS_KEY_ID",
//   prefix: "backup/",
//   status: {
//     code: "active"
//   }
// }

如果您忘记了数据库备份 ID，请不要担心，您可以调用GET /databases/{databaseId}/database_backups 端点来列出数据库的所有备份。

import { assert } from "jsr:@std/assert/assert";

const orgToken = "your-organization-token";
const databaseId = "database-id";

const res = await fetch(
  `https://api.deno.com/v1/databases/${databaseId}/database_backups`,
  {
    headers: {
      authorization: `Bearer ${orgToken}`,
    },
  },
);

assert(res.ok);

console.log(await res.json());
// You would see something like:
// [
//   {
//     id: "database-id",
//     kind: "s3",
//     endpoint: "https://storage.googleapis.com",
//     bucketName: "test-kv-backup",
//     bucketRegion: "us-central1",
//     accessKeyId: "YOUR_ACCESS_KEY_ID",
//     prefix: "backup/",
//     status: {
//       code: "active"
//     }
//   }
// ]

请注意，当前每个数据库只能启用一个备份。这意味着如果您想使用不同的配置设置更新备份、备份到不同的目的地或修复配置错误的凭据，您需要先禁用现有备份。您可以使用DELETE /database_backups/{databaseBackupId} 完成此操作。

import { assert } from "jsr:@std/assert/assert";

const orgToken = "your-organization-token";
const databaseBackupId = "database-backup-id";

const res = await fetch(
  `https://api.deno.com/v1/database_backups/${databaseBackupId}`,
  {
    method: "DELETE",
    headers: {
      authorization: `Bearer ${orgToken}`,
    },
  },
);

assert(res.ok);

之后，您可以使用新设置启用新的备份。

使用备份数据的进阶用法

您可以使用denokv 工具管理备份数据。例如，您可以将数据同步到本地 SQLite 文件，并查看或检出可恢复的点。有关更多详细信息，请参考denokv 文档。

下一步

使用Deno 子托管安全地部署和运行不可信代码的平台构建变得简单。您可以在几周内（而不是几个月内）以一小部分成本启动您的集成平台、低代码解决方案、应用市场等。

我们计划继续投资，以确保 Deno 子托管是运行第三方不可信代码的最简单安全方式，这样您就可以继续专注于为您的用户创造价值。

🚨️ 详细了解 Deno 子托管 🚨️

子托管与 AWS Lambda 用于运行不可信用户代码

子托管：从一开始就设计为安全

巴西顶级电子商务平台如何使用子托管将页面加载速度提高 5 倍