Volcengine Deploy 是火山引擎智能体工具包中的部署技能,目标是把本地项目目录或远程 Git 仓库部署到火山引擎,并成为可访问的云服务。
用途:在用户选定部署模式与资源管理方式后,完成从代码解析、资源规划、资源创建到部署执行和结果验证的完整流程。支持三种部署模式:ECS(轻量虚拟机)、VKE(Kubernetes 集群)、veFaaS(函数服务,转交 volcengine-vefaas 技能处理)。
主要能力:
- 目标解析:识别本地路径或 Git URL,记录仓库名、目录和提交 SHA;Git 地址优先浅克隆。
- 部署选择:读取或生成 .volcengine/deploy-choice.json,记录区域、模式、端口、依赖、数据库、资源策略和资源管理方式。
- 部署计划:生成 .volcengine/deployment-plan.md,列出将创建或复用的每项资源,并设置 status(draft/validated)与 approval(pending/granted)门禁;创建或复用资源前须校验通过且用户明确授权(approval_evidence 需引用授权原话)。
- 资源管理分发:选择 IaC 时调用 volcengine-iac,经 Terraform 生成、校验、计划与确认应用;选择 CLI 时使用 ve 命令创建资源,并立即将每项资源追加到 .volcengine/created-resources.json,包含删除命令。
- 运行时配置:从 .env.example、框架配置和依赖输出中解析配置与密钥,敏感值不打印、不写入日志,本地文件权限 0600;为 ECS systemd 写入 /opt/<repo>/.env,为 VKE 生成 ConfigMap 与 Secret。
- 依赖接入:支持 RDS(mysql/postgresql/sqlserver)、AIDAP(supabase/postgresql,调用 volcengine-db-supabase)、Redis 的创建或复用、私网端点、白名单及连接串构造,并在健康检查前完成迁移。
- 分支部署:ECS 依据仓库形态选择 compose、Docker、二进制加 systemd 或询问启动命令;SSH 22 未获批准时保持关闭并改用云助手;RunCommand 异步需轮询结果。VKE 按顺序供应集群与镜像仓库、等待 Running、获取 kubeconfig、验证 core-dns、构建并推送镜像、生成清单、执行迁移 Job、应用并等待 LoadBalancer/EIP。veFaaS 转交 volcengine-vefaas 技能。
- 结果与失败处理:验证公网端点、健康、日志及核心行为;失败时按资源清单逆序打印清理命令,复用资源不得未经确认删除。
使用方式:通常在火山引擎环境中由智能体调用,先由 volcengine-prepare 技能完成模式与资源策略选择,再执行本技能。本地状态保存在仓库根目录 .volcengine/ 下,包括 deployment-plan.md、deploy-choice.json、created-resources.json、iac-outputs.json 和 terraform/。
适用场景:需要将项目快速发布为火山引擎上的可访问服务的场景,尤其是希望以隔离项目 deploy-<repo> 新建资源、并通过计划与授权流程控制云资源开销的部署工作。
限制:创建云资源会产生费用且不可自由回退,必须经过计划校验与明确授权;需要对应模式的工具链(ECS:ve、git、jq、curl 等;VKE:ve、docker、kubectl 等);不硬编码实例类型或系统镜像;具体认证要求由所调用的执行技能检查;资源清理需用户手动审阅并运行清单中的删除命令,目前没有一键清理工具;部分细节以实际技能参考文件为准,资料未完整提供。