SuperAPI AI 工具集

experience-ui-bundle-deploy

部署与运维

查看项目

更新于 10-15 21:43

技能介绍

用途:在 Salesforce 项目中部署 UI Bundle 应用并完成部署后的 org 配置。当项目存在 uiBundles/*/src/ 目录且任务涉及部署到 org 或部署后设置时激活。

主要能力与顺序(顺序不可颠倒,前一步输出是后一步前提):

  1. Org 认证:sf org login web --alias <org>,不可跳过。
  2. 部署前构建 UI bundle:在每个 bundle 目录执行 npm install 与 npm run build,确保 dist/ 存在。
  3. 部署元数据:先做 license 预检(若配置自助注册),再执行 sf project deploy start --source-dir <sourceRoot> --target-org <org>。sourceRoot 由 scripts/get-source-root.sh 从 sfdx-project.json 解析,禁止硬编码 force-app/main/default;不要手写 package.xml 或转 mdapi。 3b. 设置站点登出 URL(仅当配置含 logoutUrl),通过 node scripts/set-logout-url.mjs 完成,属尽力而为,退出码 3 视为跳过。
  4. 分配权限集:按 org-setup.config.json 的 permsetAssignments 执行 sf org assign permset,assignee 可为 currentUser、guestUser 或 skip。
  5. 分配角色(配置驱动),使 Experience Cloud 自助注册可用。
  6. 启用自助注册(配置驱动,需先询问用户),含 license 预检、站点推导、翻转 selfRegistration 并重部署 network 文件、创建 Account 与 NetworkSelfRegistration。 6b. 启用社交登录(配置驱动,幂等,无需询问),链接 Auth Provider 与 SAML SSO 到站点 AuthConfig。
  7. 数据导入(存在 data-plan.json 时,需先询问),先清理后导入。
  8. 在 UI bundle 目录执行 npm install、SF_TARGET_ORG=<org> npm run graphql:schema、npm run graphql:codegen、npm run build。

关键限制:必须先部署元数据再拉取 schema,先分配权限再拉取 schema;每次改动对象、字段或权限的部署后都要重跑 schema 与 codegen;不得静默跳过权限分配、自助注册、社交登录或数据导入;assets/ 下的 Apex 与 XML 模板须原样使用。本地预览 npm run dev:preview 不属于本流程。