子托管资源

要使用 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）分配给单独的部署。

暂存环境 vs 生产环境 跳转到标题#

当开发者打开 github pull request 时，Deno Deploy 最终用户平台会自动创建预览部署，并且提交到 “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 文档（包括基于浏览器的测试工具）。