跳转到内容
PlaidCloud

从 PlaidCloud Git 部署 Panel 应用

这是从本机上的 Panel 应用代码到线上 URL 的完整路径，以 PlaidCloud Git（内置于工作区的托管 Git 服务）作为来源。由于 PlaidCloud Git 是托管的，应用用于部署的连接 无需服务器 URL、用户名或令牌：PlaidCloud 会代您进行身份验证。

共有五个步骤：

  1. 编写一个最简 Panel 应用。
  2. 将其放入 PlaidCloud Git 仓库。
  3. 创建托管的 PlaidCloud Git 连接。
  4. 发布指向该仓库的服务器应用。
  5. 打开已提供服务的应用，如果无法启动，则查看构建日志。

每个步骤都链接到相应部分的详细指南；本页将它们串联成一条完整路径。

开始之前

Section titled “开始之前”
  • 从工作区打开 Git，确认您可以访问 PlaidCloud Git。默认情况下，工作区的组织包含一个 apps 仓库（以及一个 udfs 仓库），它们是存放 Panel 应用的自然位置。
  • 如果想从本机推送代码，请在本地安装 git（也可以在 Git 网页界面中添加文件）。

1. 编写最简 Panel 应用

Section titled “1. 编写最简 Panel 应用”

应用需要一个 入口点（构建 Panel 应用并将其标记为 .servable() 的 Python 文件），以及可选的 requirements.txt（用于额外的包，位于仓库根目录或入口点旁边）。

apps/
├── app.py            # entry point — calls .servable()
└── requirements.txt  # optional; extra dependencies (repo root or next to app.py)

创建 app.py：

import panel as pn


pn.extension()


pn.pane.Markdown("# Hello from PlaidCloud Git 👋\n\nServed straight from your workspace repository.").servable()

这就是一个完整的应用，PlaidCloud 提供服务的正是 .servable() 调用。panel、bokeh 和 PlaidCloud 客户端库（plaidcloud-rpc、plaidcloud-utilities）已预装，因此在 requirements.txt 中只需列出 额外 的包。有关更丰富的示例、依赖项以及浅色/深色主题，请参阅创建 Panel 应用。

2. 将应用放入 PlaidCloud Git 仓库

Section titled “2. 将应用放入 PlaidCloud Git 仓库”

使用工作区现有的 apps 仓库，或者创建新仓库。然后将代码放入其中。

由于您是通过 PlaidCloud 登录的，您的 Git 账户没有单独的密码：请生成个人访问令牌（您的头像 → 设置 → Applications），授予仓库 读取 和 写入 范围，并在 Git 提示时将其用作密码。从仓库的 代码 按钮复制 HTTPS 克隆 URL，然后：

终端窗口
git clone https://<your-git-host>/<org>/apps.git
cd apps
# add app.py (and requirements.txt), then:
git add app.py requirements.txt
git commit -m "Add hello panel app"
git push

记下仓库路径 <org>/apps，其中 <org> 是工作区的组织名称。您将在下一步中输入该路径。完整的克隆、提交和推送详情请参阅仓库。

这里的令牌仅供 您自己 推送代码使用。 接下来创建的连接是托管的，不需要令牌，请不要混淆两者。

3. 创建托管的 PlaidCloud Git 连接

Section titled “3. 创建托管的 PlaidCloud Git 连接”

连接用于告诉 Panel 部署其代码所在的位置。对于 PlaidCloud Git，连接是 托管的：PlaidCloud 提供主机和凭据，因此您只需输入仓库目标。

  1. 打开 Tools > 连接，单击 新建连接，然后选择 PlaidCloud Git。
  2. 为连接指定 账户名称（例如 Apps Repo）。
  3. 将 Repository Path 设置为 <org>/apps（即您在步骤 2 中记下的路径），将 默认分支 设置为 main。除非应用位于子目录中，否则请将 起始路径 留空。
  4. 单击 创建。

没有服务器 URL、用户、密码或 SSL/SSH 字段：PlaidCloud Git 是托管的，因此平台会处理主机和身份验证。有关完整表单（包括连接的 用法 和 安全模型，即工作区中谁可以使用它），请参阅 PlaidCloud Git 连接。

使用较旧的工作区版本？ 如果表单仍显示服务器 URL 或凭据字段，将它们留空即可，无论哪种情况，平台都会代您进行身份验证。

4. 发布服务器应用

Section titled “4. 发布服务器应用”

现在让服务器部署指向该连接。

  1. 打开 我的 Panel 应用，然后单击 新建服务器应用。
  2. 在 目录设置 下，设置 应用名称 和 URL 标识。该标识是应用的 URL 和内部名称，因此请使用小写字母、数字和连字符，以字母开头，不超过 40 个字符（例如 hello-panel）。
  3. 在 Git 连接和发布监视器 下：
    • Git 连接：您在步骤 3 中创建的 PlaidCloud Git 连接。
    • 分支：main。推送到该分支会自动重新构建并重新部署应用。
    • 入口点：app.py。
  4. 在 运行时 下，选择 CPU、内存、设计（FAST 为 PlaidCloud 的现代外观）和 Idle 时长。仅当应用应在无需登录的情况下可访问时，才勾选 允许公共访问。
  5. 单击 发布。

此对话框中的每个字段都在创建 Panel 应用中有说明。

5. 打开应用，如果无法启动则查看日志

Section titled “5. 打开应用，如果无法启动则查看日志”

发布后，应用开始 构建：PlaidCloud 克隆分支，安装您的 requirements.txt（仓库根目录和应用文件夹中的，如果存在），并构建容器镜像。其 状态 显示在 我的 Panel 应用 列表中并自动更新。

  • 当状态为 就绪 时，在 https://<your-tenant-host>/serve/<slug>/ 打开应用。应用空闲后的第一个请求会将其唤醒（约 15 秒）。
  • 如果构建失败，请打开应用并查看其 构建 日志，缺少依赖项或导入错误会显示在那里。有关各状态的含义、如何读取日志以及如何触发重新构建，请参阅使用 Panel 应用。

从此以后，每次推送到连接的分支都会自动重新构建并重新部署应用：编辑 app.py，执行 git push，更改即可上线。（除非应用已被 锁定，请参阅锁定应用，此时推送会被跳过，直到您解锁为止。）

后续步骤

Section titled “后续步骤”