SuperAPI AI 工具集

volcengine-prepare

部署与运维

查看项目

更新于 10-19 16:17

技能介绍

volcengine-prepare 是一个用于部署决策支持的技能,主要帮助用户在将项目部署到火山引擎之前,分析项目并确定合适的部署路径。它不执行实际部署,而是提供分析和推荐。

用途:当用户希望将本地目录或 GitHub 仓库部署到火山引擎时,该技能可以分析项目结构,理解应用形态,并给出 ECS、VKE 或 veFaaS 的排序推荐。它强调决策支持而非工作流引擎,不追求生成重型报告。

主要能力:

  1. 解析仓库:支持本地路径或 Git URL,自动克隆到临时缓存或就地分析。
  2. 运行分析器:识别语言、框架、端口、Docker/Compose 形态、依赖、迁移、入口点以及可部署的服务表面。
  3. 可选身份检查:如果设置了环境变量 VOLCENGINE_ACCESS_KEY、VOLCENGINE_SECRET_KEY 和 VOLCENGINE_REGION,则验证身份;否则继续推荐,并提示凭据检查将在执行所选路径时进行。
  4. 推荐部署路径:在明确可部署服务表面后,呈现 ECS、VKE、veFaaS 的排序列表,包括每个路径的吸引力或成本原因、大致成本水平、运维权衡、已知阻碍或所需设置。
  5. 推荐资源管理方式:根据内部规则建议使用 CLI 或 IaC,并请用户确认。
  6. 持久化选择:仅在需要跨步骤继续时,将最小状态写入 .volcengine/deploy-choice.json。

使用方式:

  • 用户提供本地路径或 Git URL。
  • 技能调用 scripts/analyze-repo.sh 分析仓库,并以纯语言展示重要发现。
  • 如果分析器无法识别具体的 ECS/VKE/veFaaS 部署目标,会询问子目录、服务、命令、工件、静态输出或现有 veFaaS 应用/函数。
  • 在推荐前,会先识别具体部署目标:仓库、子目录、命令、工件、静态输出或现有云应用/函数。文件级信号(如 Dockerfile、compose 文件、package.json)仅作为证据,不单独证明可部署性。
  • 展示排序列表后,仅询问无法安全推断的问题:部署模式(默认首选)、资源策略(默认新建隔离项目 deploy-<repo>)、数据库产品/引擎(仅当检测到或请求托管数据库时)、资源管理方式(CLI 或 IaC)。
  • 如果用户说“你决定”,则使用首选运行时路径、推荐的资源管理方式和新隔离资源。

适用场景:

  • 用户需要将项目部署到火山引擎,但不确定选择 ECS、VKE 还是 veFaaS。
  • 需要快速了解项目的可部署性、依赖和入口点。
  • 需要获得资源管理方式(CLI 或 IaC)的建议。

限制:

  • 该技能是决策支持,不是工作流引擎,不执行实际部署。
  • 不运行严格的工具依赖检查,除非用户选择路径后。
  • 不读取 ~/.volcengine/config.json 以避免泄露密钥。
  • 预检查是建议性的,不是门槛。
  • 如果账户实名验证或余额无法可靠查询,会给出简短提醒而不编造检查。
  • 不强制进行完整的 ECS/VKE/veFaaS 比较,仅在排除有帮助时提及不可行路径。
  • 对于 veFaaS,仅当目标符合 volcengine-vefaas 技能工作流时才推荐;否则优先 ECS/VKE。

分类:该技能主要用于部署决策支持,属于部署与运维领域,因此分类为 devops。