本页内容
入门
创建组织 跳转到标题
开始使用 Deno DeployEA
- 访问 app.deno.com
- 创建组织
请注意,你无法创建与 Deploy Classic 中任何现有项目具有相同 slug 的组织。组织名称和 slug 在创建后无法更改。
创建应用 跳转到标题
创建组织后,你将被定向到组织应用页面,该页面显示你的所有应用,并提供对组织设置和自定义域的访问。
要创建应用,请按 + New App
按钮
应用是一个已部署的 Web 服务,具有单个构建配置、构建历史记录、环境变量、关联的自定义域、链接的 GitHub 仓库等。
选择仓库 跳转到标题
- 选择你的应用的 GitHub 仓库
如果你的仓库未显示,请使用 Add another GitHub account
或 Configure GitHub App permissions
按钮授予 Deno Deploy GitHub 应用访问你仓库的权限。
⏳ Monorepo(应用程序位于子目录中的仓库)尚不支持。
配置你的应用 跳转到标题
Deno DeployEA 会自动尝试检测你的应用类型并配置适当的构建设置。你可以在 App Config
框中看到检测到的配置
要修改此配置,请点击 Edit build config
。
配置你的构建 跳转到标题
在构建配置抽屉中,你可以自定义
框架预设 跳转到标题
选择你的框架,如果使用自定义设置,则选择 No Preset
。
安装命令 跳转到标题
用于安装依赖项的命令(例如 npm install
, deno install
)。对于没有 package.json
的 Deno 应用,此项可以为空。
构建命令 跳转到标题
用于编译/打包应用的命令(例如 next build
, deno task build
)。如果你的应用不需要构建,请留空。
运行时配置 跳转到标题
对于大多数框架,此处没有可配置的选项,因为 Deno DeployEA 会根据框架预设为应用找出理想的运行时配置。当未配置框架时,你可以在此处选择应用是需要为每个请求在服务器端执行代码的动态
应用(如 API 服务器、服务器端渲染应用等),还是仅由一组需要托管的静态文件组成的静态
应用。
动态入口 跳转到标题
用于启动应用的 JavaScript 或 TypeScript 文件。这是你在本地传递给 deno run
或 node
以启动应用的路径。路径必须是相对于工作目录的。
动态参数 跳转到标题
在入口点之后,启动时要传递给应用的额外命令行参数。这些参数是传递给应用的,而不是 Deno 本身。
静态目录 跳转到标题
工作目录中包含要提供服务的静态文件的目录。例如,dist
、_site
或 .output
。
单页应用模式 跳转到标题
应用是否为单页应用,即对于静态目录中不存在的文件路径,应提供根 index.html
而不是 404 页面。
关闭抽屉将保存设置。
环境变量 跳转到标题
添加环境变量
- 点击
Add/Edit environment variables
- 在抽屉中点击
+ Add variable
- 输入名称和值
- 选择它是纯文本变量还是秘密
- 选择应在哪些上下文中可用
- 生产环境:用于生产域的请求
- 开发环境:用于预览/分支域的请求
- 点击
Save
以应用更改
构建并部署你的应用 跳转到标题
- 点击
Create App
以创建应用并开始首次构建 - 通过实时日志查看构建进度
构建日志显示以下阶段
- 准备:克隆仓库并恢复缓存
- 安装:运行安装命令和框架特定设置
- 构建:执行构建命令并准备部署工件
- 预热:通过请求测试部署
- 路由:将构建部署到全球区域
你可以通过左上角的按钮取消构建,或从同一位置重新启动失败的构建。
完成后,右上角显示预览 URL,下方显示构建部署到的所有时间线。
监控你的应用 跳转到标题
部署后,使用可观测性工具监控你的应用
日志 跳转到标题
查看应用日志,可选择按上下文、修订和文本内容进行筛选
使用搜索栏筛选日志(例如,context:production
, revision:<id>
)。时间选择器调整显示的时间范围。
如果日志与追踪相关联,你可以点击“查看追踪”以查看相应的追踪信息。
追踪 跳转到标题
查看包含详细计时信息的请求追踪
点击任意追踪以打开追踪视图,该视图以瀑布图形式显示所有跨度
追踪视图显示
- 包含持续时间的跨度时间线
- 跨度详情,包括属性
- 跨度期间发出的日志。要保存环境变量,请按保存按钮。你可以重新打开抽屉以编辑/删除已添加的环境变量。
你还可以在此页面上编辑应用名称,并选择应用应从哪些区域提供服务。
构建并部署你的应用 跳转到标题
最后,你可以按 Create App
按钮创建应用。这将创建应用并立即触发首次构建。
在构建页面,你可以看到实时流式构建日志,分为多个部分
- 准备: 克隆 GitHub 仓库并恢复构建缓存
- 安装: 执行安装命令,以及任何框架特定的预安装设置
- 构建: 执行构建命令,任何框架特定的构建前和构建后设置,以及准备部署的构建工件
- 预热: 向部署的预览 URL 发送请求,以确保它正确启动。预热部分中显示的日志是运行时日志,而不是构建日志。
- 路由: Deno Deploy 正在将此构建的新版本推出到所有全球区域。
此构建的左上角有一个按钮可以取消构建。对于失败的构建,还有一个按钮可以重新启动构建。
对于已完成的构建,右上角显示构建的预览 URL。再往下,显示此构建部署到的所有时间线,例如 生产环境
或 Git 分支
时间线。
你还可以在此页面上看到构建是如何触发的。它可以是 手动操作
(通过 UI 触发的构建),也可以是 GitHub 仓库
(通过 GitHub 集成触发的构建)。
你可以通过预览 URL 或时间线列表中显示的其他任何 URL 查看应用。
监控你的应用 跳转到标题
访问你的应用后,你可以通过我们可观测性面板中提供的日志和追踪来查看有关应用的遥测数据。你可以通过点击左侧边栏中相应的按钮来访问这些页面。
日志 跳转到标题
日志页面显示项目中的所有最新日志。默认情况下,显示来自所有上下文(生产和开发)的日志,但使用顶部的筛选按钮和搜索栏,可以限制显示的日志。例如,要仅筛选生产日志,请在搜索栏中添加 context:production
。要仅显示来自特定修订的日志,请使用 revision:<id>
等。
你还可以在搜索栏中使用全文搜索。全文搜索将不区分大小写地筛选日志条目,使其仅包含所写入的文本。
默认情况下,显示最近一小时的日志。右上角的时间选择器可用于调整日志显示的时间范围。显示的时间戳的时区是时间选择器中设置的时区。
如果日志行与追踪相关联,则日志行右侧会显示“查看追踪”按钮。当日志行在活跃追踪中发生时,就会出现这种情况。点击此按钮将以覆盖层形式打开相应的追踪。
追踪 跳转到标题
追踪页面显示项目中的所有最新追踪。默认情况下,显示来自所有上下文(生产和开发)的追踪,但使用顶部的筛选按钮和搜索栏,可以限制显示的追踪。例如,要仅筛选生产追踪,请在搜索栏中添加 context:production
。要仅显示来自特定修订的追踪,请使用 revision:<id>
等。
列表中显示所有包含传入 HTTP 请求的追踪。每个追踪显示的文本是请求的路径和追踪的持续时间(以毫秒为单位)。
点击追踪将打开追踪视图,该视图显示完整的追踪,包括作为追踪一部分的所有跨度和日志。
对于追踪中的每个跨度,你可以看到跨度的持续时间、跨度的名称、开始和结束时间以及记录的属性。通过点击时间线中的跨度,该跨度的详细信息将显示在底部的摘要面板中。
作为给定跨度一部分发出的日志显示在底部的日志选项卡中。更改选定的跨度将更新此面板中显示的日志。