子托管资源

要使用 Deno Deploy 构建子托管，了解系统中的一些关键资源会有所帮助。这些资源也在 REST API 中有所体现。

组织 跳到标题#

组织是与子托管实现相关的所有数据的容器。您的组织将拥有一个名称和一个 ID。每个组织都有一个分析端点，可用于获取整个组织的指标（例如请求计数和使用的带宽）。

其他 Deploy 用户可以被邀请在组织内协作，并且访问令牌可以赋予拥有组织访问权限的开发者通过 API 修改组织内资源的能力。新组织可以在Deploy 控制面板中创建。

项目 跳到标题#

项目作为部署的组织容器。一个项目包含其部署以及这些部署的分析和使用信息。

项目是免费的，可以根据需要设置。

为了跟踪个人用户的计费使用情况，有一个 API 端点可以按项目提供分析数据（带宽使用量、请求计数等），粒度为 15 分钟。

所有部署（无论是同一项目内还是不同项目之间）默认情况下互不共享。项目是组织部署的一种方式，不产生任何费用。然而，分析报告是按项目进行的，如果您有多个租户，我们建议为每个租户设置一个项目。特别是如果您期望根据用户的使用情况进行计费。

部署 跳到标题#

部署：部署是可以在 Deno Deploy 中隔离运行的一组配置、可运行代码和支持性静态文件。部署有一个可以启动服务器的入口文件，可以关联 Deno KV 数据库，并且可以设置为在自定义域上运行。

部署是一个不可变对象，由以下部分组成：

• 要运行的源代码
• 静态资源
• 环境变量
• 数据库绑定
• 其他设置

我们提供用于查询或流式传输构建日志以及查询或流式传输执行日志的端点。

如果您需要阻止或解除阻止部署，可以通过删除需要阻止的部署或取消分配其域来实现。这将使该部署无法访问。

子托管系统旨在使一个部署的行为或负载不会影响其他部署。这同样适用于一个组织内的不同部署。容量按需自动扩展。如果您想限制特定部署或应用程序的资源，可以使用分析 API 以项目级别粒度为您提供详细指标（请求计数、带宽等）。您可以使用此信息来决定是否关闭部署并使其无法访问。

注意：部署是不可变的，但是，您可以创建一个新部署，然后将其域重新映射到新部署。重新部署端点可以从现有部署创建具有不同设置的新部署。

自定义域 跳到标题#

自定义域可以动态映射到部署，赋予它们唯一的 URL（例如 mycompany.com）。

在使用域之前，您需要验证所有权并配置或上传 TLS 证书。

如果您是 Builder 等级，您可以使用通配符域。注册通配符域后，您可以以两种方式使用它：

• 将 *.mycompany.com 的所有请求发送到特定部署
• （即将推出）将不同的子域（例如 foo.mycompany.com 和 bar.mycompany.com）分配给单独的部署。

预发布与生产环境 跳到标题#

Deno Deploy 最终用户平台在开发者打开 GitHub 拉取请求时自动创建预览部署，并将对“main”分支的提交自动转换为生产部署。虽然子托管不直接提供 GitHub 集成，但它拥有您定义自己的预览和生产部署创建语义所需的所有基本功能。

连接 KV 数据库 跳到标题#

KV (键值) 数据库存储键值对。您可以在创建部署时使数据库可供该部署访问。KV 数据库可以同时被多个部署使用。

若要在子托管中使用 KV：

• 使用 API 创建数据库
• 使用子托管 API 创建部署时，指定您创建的数据库。

注意：Deno Cron 和 Queues 目前不适用于子托管。

OpenAPI 规范与工具 跳到标题#

Deploy API 的 OpenAPI 规范可以在这里找到

https://api.deno.com/v1/openapi.json

此规范文档可与大量兼容 OpenAPI 的工具一起使用。除了此处维护的 REST API 文档外，您还可以在此处找到自动生成的 API 文档（包括基于浏览器的测试工具）。