子托管资源

为了使用 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 文档（包括基于浏览器的测试工具） 此处。