SuperAPI AI 工具集

lazycat-lpk-builder

部署与运维

查看项目

更新于 10-15 23:44

技能介绍

用途:把源码、Docker 镜像或 docker-compose 应用移植为懒猫微服 LPK V2 应用,覆盖元数据、权限、运行清单、构建与开发态配置、资源导入导出以及打包验证。

主要能力与流程:编写前先读取并执行 references/spec-sync.md 做版本校准,记录目标 lzcos 与 CLI 版本,获取官方原文并核对本地快照;基线为 lzcos >=1.5.0、lzc-cli >=2.0.0,每项新能力需独立核验门槛。随后分析应用端口/协议、CPU 架构、镜像入口与 UID、内部数据、依赖、鉴权与所需权限,不默认申请 root/privileged/全部权限。配置分四类:package.yml(静态身份、版本、权限,见 references/package-spec.md)、lzc-manifest.yml(服务、路由、inject、entries、运行身份,见 references/manifest-spec.md)、lzc-build.yml(正式构建,见 references/build-spec.md)、lzc-build.dev.yml(开发差异,不能复制整份 release 配置)。资源导出/导入见 references/resource-export.md,权限、初始化、探针、持久化故障见 references/troubleshooting.md,上架审核见 references/store-publish.md。V2 manifest 不包含 package/version/name/locales/permissions/import_resources 等静态字段。

构建与验证:执行 lzc-cli --version、lzc-cli project build -o release.lpk,检查实际 Build config、最终 tar 包中的 package.yml/manifest.yml、必要资源与镜像 lock;buildscript 不得调用 project build。安装/部署会改变设备状态,仅在用户授权时执行 lzc-cli app install ./release.lpk 或 lzc-cli project deploy(优先 dev 配置)。测试首装、升级、重启持久化、最小权限、免密登录与接口鉴权;本地静态校验不得声称部署成功。

限制与边界:内部配置/数据库用 var,缓存用 cache,用户文件放带 document.private 的 /lzcapp/documents/$uid;run_as(>=1.6.0)按镜像兼容性选择,不与同一 service 的 user/setup_script 混用;routes 默认去前缀,保留前缀用 upstreams,非 HTTP 用 ingress;开发机 localhost 需 ctx.net.via.client(ctx.dev.id);public_path 不是业务鉴权,远端发布、提权、Token 创建销毁须明确范围与授权。