用途:通过 Portainer 的 REST API 管理 Docker 基础设施,无需打开 Web UI,即可在命令行或 ThinkFleetBot 流程中操作容器、环境和 Compose 栈。
主要能力: 状态查询:./portainer.sh status 查看 Portainer 服务器版本。 环境端点:./portainer.sh endpoints 列出所有 Docker 环境及在线状态。 容器管理:./portainer.sh containers [endpoint] 列出容器;./portainer.sh start|stop|restart <容器名> [endpoint] 控制单个容器。 日志:./portainer.sh logs <容器名> [endpoint] [行数],默认显示最近 100 行。 栈管理:./portainer.sh stacks 列出全部栈;./portainer.sh stack-info <栈ID> 查看栈详情。 重新部署:./portainer.sh redeploy <栈ID> 从 git 拉取最新代码、按需重建容器并重启栈;脚本会自动读取已有栈配置中的 repositoryGitCredentialID。
使用前提与配置:需要 Portainer 2.x 且开放 API 访问,本地具备 curl 与 jq,并准备 API Access Token。在 Portainer Web UI 中进入用户名 → My Account → Access tokens 创建令牌并复制(之后不再显示)。然后在 ~/.thinkfleetbot/.env 中设置 PORTAINER_URL 与 PORTAINER_API_KEY。默认端点号为 4,可在命令中显式指定其他端点。
适用场景:合并 PR 后重新部署网站、排查容器运行时先查列表再看日志再重启、查看整体系统概况(状态、端点、容器、栈),以及通过自然语言指令触发上述脚本操作。
限制与注意:容器名需与列表输出的完整名称完全一致且区分大小写;栈重新部署若出现 git 认证或仓库未找到错误,依赖脚本自动处理凭据参数;未配置 URL 与 API Key 时会报错。文档未提供价格、并发限制、权限模型或失败恢复等更多细节。