@infly/libs 2.0.38 → 2.0.42

package/README.md

@@ -37,3 +37,69 @@
 # 项目安装
 npm/pnpm install @infly/libs
 ```
+
+## Docker 镜像构建
+
+在应用目录中执行：
+
+```bash
+infly-libs build:docker --local --env prod
+```
+
+可通过可选参数 `--cicd-url` 在构建和镜像推送全部成功后输出蓝色发布系统链接。支持等号和空格两种传参形式：
+
+```bash
+infly-libs build:docker --local --cicd-url="https://cicd.sutpay.com/view/积分商城/"
+```
+
+```bash
+infly-libs build:docker --local --cicd-url "https://cicd.sutpay.com/view/积分商城/"
+```
+
+未传 `--cicd-url` 时保持原有输出。参数值必须是合法的 HTTP/HTTPS URL，且不能包含用户名、密码或控制字符。
+
+## 配置驱动的项目命令
+
+`project` 命令将多平台项目的开发和构建目标从 package scripts 移到项目配置：
+
+```bash
+infly-libs project
+infly-libs project dev
+infly-libs project build
+```
+
+命令从当前目录 `package.json` 的 `infly.targets`、`infly.dev` 和 `infly.build` 读取配置。交互选择会追加“退出”选项；选择退出或按取消键时会正常结束，不执行后续命令。项目命令不支持 `--config` 文件入口。
+
+未指定 action、target 或构建环境时，会在 TTY 中显示单选菜单。CI/CD 必须显式传参：
+
+```bash
+infly-libs project dev --target QDXY
+infly-libs project build --env stage --target SQ223
+```
+
+`--dry-run` 只打印带 `VUE_APP_PLATFORM` 的命令计划。`infly.targets` 推荐使用平台代码数组，例如 `["DEFAULT", "MER", "JXEE"]`；同时兼容对象形式，对象值中的 `label` 只用于交互显示。普通 target 就是注入 `VUE_APP_PLATFORM` 的平台代码，批量构建通过 `build.presets` 组合多个 target。
+
+`dev.command` 以及 `build.before/command/after` 同时支持字符串和参数数组。字符串按空白拆分为可执行文件和参数，不经过 shell；参数本身包含空格时应继续使用数组形式。
+
+`build.environments` 推荐使用 `选择键:实际 mode` 数组，例如 `["prod:production", "stage:staging"]`；CLI 使用冒号前的值进行选择，并把冒号后的值作为 `--mode` 参数。没有冒号时选择键和 mode 同名。对象形式继续兼容，用于自定义 `label`、`mode` 或 `args`。项目如果自行管理构建入口，应设置 `infly.buildConfigs.manageScripts=false`，避免安装阶段重新写入传统 `build:prod/build:stage`。
+
+### Docker Compose 版本发布
+
+`docker:compose` 面向已有 Compose 文件的镜像版本递增、配置校验和构建，与上面的 Dockerfile/commit-tag `build:docker` 流程互不替代：
+
+```bash
+infly-libs docker:compose --target yhqy --bump patch
+```
+
+默认从当前目录 `package.json` 的 `infly.docker.targets` 读取目标，并以该 package 所在目录解析 Compose 相对路径；省略 `--target` 时在 TTY 中交互选择。`--config` 外部 JS 配置和原有 `--project-dir` + `--file` 直传方式继续兼容。
+
+参数约束：
+
+- `--target`：选择 `infly.docker.targets` 或外部配置中的目标；非交互环境必须显式传入。
+- `--config`：可选的外部 JS 配置文件，使用 `targets.<name>.file` 结构。
+- `--project-dir` + `--file`：不使用 target 配置时的兼容直传方式，Compose 文件不能越出 `project-dir`。
+- `--bump patch`：目前只支持 patch 递增，且 Compose 中必须恰好有一个 `x.y.z` 镜像 tag。
+- `--push`：显式推送；未传时只执行 `docker compose config` 和 `build`。
+- `--dry-run`：只打印版本变化和计划命令，不写文件、不调用 Docker。
+
+构建、校验或推送失败时，命令会恢复原 Compose 内容。公共包不内置 yhqy、qdxy 等业务目标映射；目标配置和单一发布 script 应归 Compose 所在项目所有。

package/bin/cli.js

@@ -8,31 +8,113 @@ function loadPreview() {
   return require("../tools/project-preview");
 }
 
-const command = process.argv[2];
-const commandMap = {
-  afterBuild: () => loadBuildDist().init(),
-  initZip: () => loadBuildDist().init(),
-  preview: () => loadPreview().init(),
-  "--preview": () => loadPreview().init(),
-  beforeBuild: () => loadBuildDist().beforeBuild(),
-  scriptOverride: () => {
-    const preview = loadPreview();
-    const buildDist = loadBuildDist();
-
-    preview.scriptInit();
-    buildDist.scriptInit();
-  }
-};
+function parseArgs(argv) {
+  const options = { env: "prod", local: false, dryRun: false };
+  const valueOptions = {
+    "--env": "env",
+    "--cicd-url": "cicdUrl",
+    "--project-dir": "projectDir",
+    "--file": "file",
+    "--bump": "bump",
+    "--config": "config",
+    "--target": "target",
+  };
+
+  let i = 0;
+  while (i < argv.length) {
+    const arg = argv[i];
+    const equalsIndex = arg.indexOf("=");
+    if (equalsIndex > 0) {
+      const flag = arg.slice(0, equalsIndex);
+      const key = valueOptions[flag];
+      if (key) {
+        const value = arg.slice(equalsIndex + 1);
+        if (!value) throw new Error(`${flag} requires a value.`);
+        options[key] = value;
+        i++;
+        continue;
+      }
+    }
+
+    if (arg === "--local") {
+      options.local = true;
+      i++;
+      continue;
+    }
+    if (arg === "--dry-run") {
+      options.dryRun = true;
+      i++;
+      continue;
+    }
+    if (arg === "--push") {
+      options.push = true;
+      i++;
+      continue;
+    }
+
+    const key = valueOptions[arg];
+    if (key) {
+      const value = argv[i + 1];
+      if (!value || value.startsWith("--")) throw new Error(`${arg} requires a value.`);
+      options[key] = value;
+      i += 2;
+      continue;
+    }
+
+    i++;
+  }
+  return options;
+}
+function parseProjectArgs(argv) {
+  const options = parseArgs(argv);
+  const hasExplicitEnv = argv.some((arg) => arg === "--env" || arg.startsWith("--env="));
+  delete options.local;
+  if (!hasExplicitEnv) delete options.env;
+  return options;
+}
+async function main(argv = process.argv.slice(2)) {
+  const command = argv[0];
+  const commandMap = {
+    afterBuild: () => loadBuildDist().init(),
+    initZip: () => loadBuildDist().init(),
+    preview: () => loadPreview().init(),
+    "--preview": () => loadPreview().init(),
+    beforeBuild: () => loadBuildDist().beforeBuild(),
+    scriptOverride: () => {
+      const preview = loadPreview();
+      const buildDist = loadBuildDist();
+      preview.scriptInit();
+      buildDist.scriptInit();
+    },
+    "build:docker": () => {
+      const opts = parseArgs(argv.slice(1));
+      return require("../build/docker/docker-build-push").dockerBuildPush(opts);
+    },
+    "docker:compose": () => {
+      const opts = parseArgs(argv.slice(1));
+      return require("../build/docker/compose-command").runComposeCommand(opts);
+    },
+    project: () => {
+      const action = argv[1] && !argv[1].startsWith("--") ? argv[1] : undefined;
+      const opts = parseProjectArgs(argv.slice(action ? 2 : 1));
+      return require("../tools/project-command").runProjectCommand({ ...opts, action });
+    },
+  };
 
-(async () => {
   if (command && commandMap[command]) {
     await commandMap[command]();
   } else {
     console.error(`未知命令: ${command || "未提供命令"}`);
     console.log(`可用命令: ${Object.keys(commandMap).join(", ")}`);
-    process.exit(1);
+    process.exitCode = 1;
   }
-})().catch((error) => {
-  console.error("执行失败:", error);
-  process.exit(1);
-});
+}
+
+if (require.main === module) {
+  main().catch((error) => {
+    console.error("执行失败:", error.message || error);
+    process.exitCode = 1;
+  });
+}
+
+module.exports = { main, parseArgs, parseProjectArgs };