SuperAPI AI 工具集

configurator-cli

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:Saleor Configurator CLI 用于把本地 YAML 配置(config.yml)与线上 Saleor 实例同步,通过命令行预览并应用变更。

主要能力:validate 在本地按 schema 校验配置,无需网络;introspect 从 Saleor 实例拉取当前配置写入 config.yml,可用于初始设置、变更前备份或恢复;deploy 将本地配置推送到实例;diff 比较本地与远端差异,输出 + CREATE、~ UPDATE、- DELETE 标记。deploy 支持 --plan 预览、--fail-on-delete、--fail-on-breaking、--include/--exclude、--report-path、--skip-media 等标志。

使用方式:命令通过 pnpm dlx @saleor/configurator 运行,例如 validate、introspect、deploy、diff。凭据可用环境变量 SALEOR_URL 与 SALEOR_TOKEN,或写入 .env.local 自动加载。非 TTY 环境自动输出 JSON 信封,可用 --json 或 --text 强制格式。

适用场景:部署配置、拉取当前配置、部署前预览、CI/CD 安全部署、按实体类型调试与选择性部署。

限制:无内置回滚命令,需借助备份或 git 恢复;URL 必须以 /graphql/ 结尾;环境变量应为 SALEOR_URL 而非 SALEOR_API_URL;产品建模或编写 YAML 应使用 product-modeling 或 configurator-schema。退出码含义:0 成功、1 意外错误、2 认证错误、3 网络错误、4 校验错误、5 部分失败、6 删除被阻止、7 破坏性变更被阻止。