注意

该命令目前仅支持 Python 的智能体工作流。前端的打包尚未支持。

pkg 命令组用于打包并导出你的应用，以便做自定义部署。目前它支持导出一个 Dockerfile，可用任意符合 OCI 规范的镜像构建器（例如 docker 或 podman）构建成镜像。

用量

终端窗口

llamactl pkg [COMMAND] [options]

可用命令

• container —— 为你的工作流生成一个精简、可直接构建的容器文件（例如 Dockerfile）。

命令：container

终端窗口

llamactl pkg container [DEPLOYMENT_FILE] [options]

根据给定的部署文件与用户指定的选项，生成一个容器构建文件。

选项

• deployment_file - 部署文件的路径。默认为当前目录（.）
• --python-version - 基础镜像使用的 Python 版本。未指定时，从 .python-version 或 pyproject.toml 推断；都找不到则默认 3.12。
• --port <int> - 为 API 服务端暴露的端口。默认为 4501。
• --dockerignore-path - 生成的 .dockerignore 文件路径。默认为 .dockerignore。
• --overwrite - 覆盖已存在的输出文件。无默认值。
• --exclude <path> - 要从构建中排除的路径（会追加到 .dockerignore）。可多次使用。无默认值。
• --output-file - 生成的容器构建文件的路径与文件名。默认为 Dockerfile。
• --help - 显示本命令的帮助并退出。无默认值。

注

• 生成的 .dockerignore 文件会自动排除常见的 Python 相关目录，例如：

  • 本地虚拟环境
  • 缓存
  • 可能含敏感数据的文件（例如 .env）

• 产出的容器文件刻意保持精简。多数情况下它够用，但特定场景你可能需要自行定制。

示例

1. 生成默认的 Dockerfile 与 .dockerignore：

终端窗口

llamactl pkg container

2. 生成一个指定文件名、Python 版本与端口的自定义容器文件：

终端窗口

llamactl pkg container --output-file Containerfile --python-version 3.14 --port 4502

3. 从构建中排除某些文件或目录：

终端窗口

llamactl pkg container --exclude .env.local --exclude .github/workflows/ --exclude "*.pdf"