用途:把 Elastic 集成包从旧式内联 agent 模板迁移为使用必需输入依赖(requires.input)的集成。
主要能力:提供四阶段流程(发现包、收集开发者决策、执行迁移、验证),包含 Gate 0 至 Gate G 决策门;变量覆盖分类(A 集成独有、B 覆盖输入默认、C 继承);数据集管理、策略测试、管道回归测试、系统测试与变更日志处理指引;并列出已知平台缺口与反模式。
必要用法:先阅读权威指南(elastic-package 仓库 docs/howto/migrate_integration_required_input_dependency.md),参考实现为 elastic/integrations#19719。确认 elastic-package 版本至少 v0.125.1。迁移前须完成所有决策门并确认迁移计划,之后按顺序修改 manifest.yml、data_stream 清单、stream.yml.hbs、_dev/test/config.yml、策略测试、管道与系统测试、changelog.yml 和文档。验证命令:elastic-package build、elastic-package check、elastic-package test -v;策略期望仅在开发者审核后用 elastic-package test policy --generate 生成。
限制:需目标栈支持 format_version ≥ 3.6(栈 9.4+)且存在合适输入包,否则应停止。不得在决策门完成前编辑包文件;不得硬编码应可配置的值;不得把 main 上未迁移的参考包当作事实来源。部分平台缺口(如 UI 可见但模板忽略的变量、{{ inputDocs }} 为空等)仍存在,具体修复状态暂未提供。