跳转到内容

使用 Panel 应用

每个已发布的应用都会显示在应用屏幕中,并带有其运行时、状态、标识和时间戳。最左侧的列用于打开应用;其余的行图标可用于锁定应用以防误改、编辑、移除,以及(针对服务器应用)重新构建、查看日志和查看使用指标。打开图标会反映应用的运行时,因此一眼就能区分 WASM 应用和服务器应用。

服务器应用的状态列会跟踪其构建过程,构建进行期间列表会自动刷新:

  • 正在构建…:PlaidCloud 正在将您的存储库构建为容器。此时应用还没有 URL。
  • 就绪:构建成功。应用的 URL 已生效,其所在行上会出现打开图标。
  • 失败:构建未能完成。请检查入口点和分支,然后编辑应用以重新发布。

WASM 应用没有构建步骤,发布后即可使用。

单击服务器应用所在行的重新构建图标,即可在不更改其设置的情况下重新构建并重新部署。应用的状态会回到正在构建…,此时 PlaidCloud 会再次构建同一分支和入口点,新构建上线后状态会切换回就绪。

在依赖项变更、基础映像更新或构建偶发失败之后,请使用重新构建。编辑并保存服务器应用同样会重新构建它,但重新构建不需要打开编辑表单。

对于 App Runner 应用(为转换后的 Alteryx 应用生成的输入表单),重新构建和保存编辑会先将其生成的文件刷新到当前的 App Runner 版本,然后再进行构建。PlaidCloud 自身更新时,也会对每个未锁定的 App Runner 应用执行同样的操作;已锁定的应用需要在解锁后执行重新构建。

单击应用所在行的锁定图标,可保护其免受意外更改。应用处于锁定状态时:

  • 编辑、移除和重新构建会拒绝执行,并提示该应用已锁定。
  • 向服务器应用的分支推送不会触发重新构建:自动重新构建会被跳过,直到解锁应用。被跳过的推送不会运行任何构建,因此应用的构建日志中不会出现新内容;解锁后请再次推送(或使用重新构建)以应用更改。
  • 打开应用、查看其日志以及查看其使用指标都仍可正常使用:锁定只会阻止更改,绝不会妨碍查看者。

再次单击该图标即可解锁。图标显示应用的当前状态:锁定时为闭合,未锁定时为打开。

锁定用于防止意外,例如误编辑、误删除,或在演示应用时有 Git 推送落到该应用上,这与工作流和工作流步骤上的锁定相同。它不是安全控制:任何可以编辑 Panel 应用的人也可以将其解锁。

锁定不涵盖两种情况:锁定时已在进行的构建仍会完成并上线;WASM 应用的文件位于其文档账户中,因此替换这些文件会在不触及已锁定记录的情况下更改正在运行的应用。

单击就绪应用所在行开头的打开图标,即可在新选项卡中启动它。打开也是该行 ⋯ 菜单中的第一项。请参阅行操作菜单。

  • 服务器应用的访问地址为 https://<your-tenant-host>/serve/<slug>/。
  • 只有服务器应用就绪后,才会出现打开图标。

服务器应用在空闲时会缩容至零以节省资源,因此空闲一段时间后的首次打开需要先将其启动。在此期间会看到 PlaidCloud 加载屏幕,而不是空白选项卡:屏幕以浅色或深色主题显示应用名称、应用依次经历正在启动、正在准备和正在加载应用的进度,以及工作区 ID。应用一旦就绪就会自动出现(通常需要几秒钟,冷启动时最长约一分钟),之后在再次空闲之前会正常响应。

从其他任何指向该应用的链接打开应用、应用正在唤醒时,也会显示加载屏幕,例如从地址栏复制的链接,或警报、摘要消息中的链接。如果已退出登录并在浏览器选项卡中打开,则会先要求登录。

如果应用无法启动,加载屏幕会变为一条消息,说明应用未能启动以及停在了哪一步,并附带重试按钮,而不会一直转圈。如果问题持续出现,请编辑应用,检查其入口点和分支并重新发布,或联系 PlaidCloud 管理员。

服务器 Panel 应用默认使用 PlaidCloud 现代的 Fast 设计,但当现有 CSS 依赖 Panel 的样式时,可通过应用的设计设置切回 Panel 的默认样式。主题(浅色、深色,或查看者可切换的浅色/深色开关)需在应用的模板中设置。相关模式请参阅创建指南中的设置主题。如果应用的表或自定义样式是为浅色背景设计的,请将其固定为浅色。

单击服务器应用所在行的查看日志图标,即可打开其日志查看器。(WASM 应用完全在浏览器中运行,没有服务器日志,因此该图标只出现在服务器应用的行上。)

查看器有两个选项卡:

  • 运行时(默认显示在前):正在运行的应用自身的输出,包括它记录的任何日志、打印的任何内容以及任何未捕获的错误。即使应用缩容至零,这些内容也会保留,因此可以回顾之前的会话做了什么。
  • 构建:构建应用容器的输出。可用它查看构建为何显示失败,例如某个依赖项无法安装。

每个选项卡都提供信息 / 警告 / 错误筛选器、日志起始时间时间范围(从最近一小时到 30 天,或全部)、刷新按钮,以及用于轮询新条目的自动刷新,在观察运行中的应用或正在进行的构建时很方便。最新的条目排在最前面。

如果无法捕获构建输出,“构建”选项卡会显示一条简短说明解释原因,而不会显示为空。

日志表会截断过长的行,以保持列表易读。选择某一日志行,会在表格旁边打开一个详细信息窗格,显示该条目的完整消息。对于表格中放不下的内容,例如很长的错误消息或完整的堆栈跟踪,这是最简便的阅读方式,不会被截断。

可以同时选择多个日志行,然后单击复制将其放入剪贴板。在调试应用时,这便于将日志粘贴到与 AI 助手的对话中,或发送给团队或 PlaidCloud 支持人员的消息里。

当应用对查看者进行登录验证时,每条日志行都会标记产生该行的会话所属的用户,因此可以知道是哪位查看者遇到了某个特定的错误或警告。标记只是尽力而为:某些框架和启动日志行在任何查看者介入之前运行,可能不显示用户。

单击服务器应用所在行的 Usage Metrics 图标(位于查看日志旁边),即可查看应用的使用情况。该视图汇总了:

  • 唯一用户:有多少不同的人打开过该应用。
  • 会话:该应用被打开了多少次。
  • 平均和中位会话时长:一次访问大致持续多久。
  • 上次使用:应用最近一次被打开的时间。

汇总下方提供按用户和按天的明细,因此可以看出谁在使用该应用,以及使用量随时间的变化趋势。

时长为近似值。服务器应用在无人使用时会空闲并缩容,因此并不总能观察到会话的确切结束时间,请将时长数据视为参考,而非精确度量。

单击应用所在行的铅笔图标即可编辑。编辑表单与应用的运行时相匹配。

对于服务器应用,可以更改名称、标识、分支、入口点、CPU、内存、设计、空闲时间窗口、公开标志、嵌入式服务域以及备注。Git 连接在应用创建后即固定,并以只读方式显示。保存会重新构建应用,其状态会回到正在构建…,直到新构建就绪。

单击应用所在行的减号图标并确认;删除或取消发布应用时始终会先要求确认。移除服务器应用会拆除其构建和部署;移除 WASM 应用会取消发布其静态文件。应用的 URL 会立即失效。

MCP 工具 panel_deployment_manage 不再提供取消发布功能。请改为从此列表中移除应用。