@anonymousmister/crane-tool 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+
+
+# Crane-Jib-Tool 🚀
+
+一个轻量级、声明式的容器镜像构建工具。无需 Docker 守护进程，通过 `crane` 实现类似 Google Jib 的文件分层打包与推送功能。支持 JSON 模板、INI 配置注入以及动态变量替换。
+
+## ✨ 特性
+
+* **免 Docker 构建**：直接生成 OCI 兼容镜像并推送到远程仓库。
+* **声明式分层**：通过 `crane.json` 定义本地文件到镜像路径的精确映射。
+* **动态模板引擎**：支持 `${Variable}` 占位符，可从环境、文件或命令行注入。
+* **内置时间戳**：自动生成 `${TimestampTag}` 变量，支持版本回溯。
+* **多格式支持**：变量源支持 `.json`、`.ini` 文件及 `KEY=VALUE` 字符串。
+
+## 📦 安装
+
+首先，确保您的项目中已安装必要的依赖：
+
+```bash
+npm install tar ini
+# 或者
+pnpm add tar ini
+
+```
+
+## 🛠 快速开始
+
+### 1. 准备镜像模板 `crane.json`
+
+在项目根目录创建模板文件，使用占位符定义动态内容：
+
+```json
+{
+  "from": "nginx:stable-alpine",
+  "image": "swr.cn-east-3.myhuaweicloud.com/your-project/${APP_NAME}",
+  "tag": "${TimestampTag}",
+  "exposedPorts": [80, 443],
+  "envs": {
+    "APP_ENV": "${NODE_ENV}",
+    "BUILD_VERSION": "${VERSION}"
+  },
+  "layers": [
+    {
+      "name": "nginx-conf",
+      "files": [
+        { "from": "./nginx.conf", "to": "etc/nginx/conf.d/default.conf" }
+      ]
+    },
+    {
+      "name": "static-assets",
+      "files": [
+        { "from": "./dist", "to": "usr/share/nginx/html" }
+      ]
+    }
+  ]
+}
+
+```
+
+### 2. 执行构建
+
+使用 `-t` 指定模板，使用 `-f` 注入变量：
+
+```bash
+# 基础用法（使用内置时间戳）
+node bin/build.js -t crane.json -f "APP_NAME=my-admin" -f "NODE_ENV=prod"
+
+# 覆盖自动生成的 Tag
+node bin/build.js -t crane.json -f "TimestampTag=v1.0.0" -f "APP_NAME=web"
+
+```
+
+## 📖 详细用法
+
+### 变量注入优先级
+
+工具会按以下顺序合并变量（后者覆盖前者）：
+
+1. **系统环境变量** (`process.env`)。
+2. **内置变量**：`${TimestampTag}` (格式: `YYYYMMDDHHMMSS`)。
+3. **文件变量**：通过 `-f config.json` 或 `-f config.ini` 加载。
+4. **命令行变量**：通过 `-f "KEY=VALUE"` 直接指定。
+
+### 使用 INI 文件作为变量源
+
+您可以创建一个 `deploy.ini`：
+
+```ini
+APP_NAME = wlhy-wj-admin
+VERSION = 2.4.5
+DOCKER_USER = your_username
+DOCKER_PASS = your_password
+
+```
+
+然后运行：
+
+```bash
+node bin/build.js -t crane.json -f deploy.ini
+
+```
+
+## 🚀 运行流程说明
+
+1. **变量初始化**：收集环境、内置时间戳及 `-f` 传入的所有参数。
+2. **模板渲染**：将 `crane.json` 中的占位符替换为实际数值。
+3. **本地打包**：根据 `layers` 定义，将本地文件临时打包为 `tar` 层。
+4. **推送镜像**：调用 `crane append` 将所有层合并推送到目标仓库。
+5. **修改元数据**：调用 `crane mutate` 配置 `ExposedPorts` 和 `Env` 变量。
+6. **自动清理**：构建完成后自动删除 `.crane_tmp` 临时目录。
+
+## ⚠️ 注意事项
+
+* **认证**：如果提供了 `DOCKER_USER` 和 `DOCKER_PASS` 变量，工具会自动执行 `crane auth login`。
+* **安全性**：对于私有仓库（如 `192.168.x.x`），工具会自动添加 `--insecure` 标志。

package/bin/build.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import os from 'os';
+import * as tar from 'tar';
+import * as ini from 'ini';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const platform = os.platform();
+const isWin = platform === 'win32';
+const CRANE_BIN = isWin ? 'crane.exe' : 'crane';
+const CRANE_PATH = path.join(__dirname, CRANE_BIN);
+
+/**
+ * 核心：解析变量池
+ * 优先级：环境变量 < 内置变量 < -f 文件变量 < -f 字符串变量
+ */
+function buildVarPool(args) {
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    const defaultTimestamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+
+    const pool = {
+        ...process.env,
+        TimestampTag: defaultTimestamp
+    };
+
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '-f' && args[i + 1]) {
+            const val = args[i + 1];
+            const fullPath = path.resolve(val);
+
+            if (fs.existsSync(fullPath)) {
+                const ext = path.extname(val).toLowerCase();
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                if (ext === '.json') {
+                    try { Object.assign(pool, JSON.parse(content)); } catch (e) { console.error(`❌ JSON 变量文件解析失败: ${val}`); }
+                } else if (ext === '.ini') {
+                    try { Object.assign(pool, ini.parse(content)); } catch (e) { console.error(`❌ INI 变量文件解析失败: ${val}`); }
+                }
+            } else if (val.includes('=')) {
+                const [k, ...vParts] = val.split('=');
+                pool[k.trim()] = vParts.join('=').trim();
+            }
+            i++;
+        }
+    }
+    return pool;
+}
+
+/**
+ * 核心：递归替换对象中的占位符
+ */
+function injectVars(obj, vars) {
+    const str = JSON.stringify(obj);
+    return JSON.parse(str.replace(/\${?(\w+)}?/g, (match, key) => {
+        return vars[key] !== undefined ? vars[key] : match;
+    }));
+}
+
+async function run() {
+    const args = process.argv.slice(2);
+    const tIndex = args.indexOf('-t');
+    const templatePath = (tIndex > -1 && args[tIndex + 1]) ? path.resolve(args[tIndex + 1]) : null;
+
+    if (!templatePath || !fs.existsSync(templatePath)) {
+        console.error("❌ 错误: 请使用 -t 指定有效的模板文件。例如: crane-build -t crane.json");
+        process.exit(1);
+    }
+
+    // 1. 变量处理
+    const varPool = buildVarPool(args);
+    const rawTemplate = JSON.parse(fs.readFileSync(templatePath, 'utf-8'));
+    const cfg = injectVars(rawTemplate, varPool);
+
+    // 2. 核心参数准备
+    const IMAGE_BASE = cfg.image;
+    const FROM_IMAGE = cfg.from || "nginx:stable-alpine";
+    const FINAL_TAG = cfg.tag || varPool.TimestampTag;
+    const FULL_IMAGE = `${IMAGE_BASE}:${FINAL_TAG}`;
+    const isInsecure = IMAGE_BASE.includes('192.168.') || IMAGE_BASE.includes('localhost') || IMAGE_BASE.includes('10.');
+    const flags = isInsecure ? '--insecure' : '';
+
+    try {
+        // 3. 认证逻辑
+        const registryHost = IMAGE_BASE.split('/')[0];
+        if (varPool.DOCKER_USER && varPool.DOCKER_PASS) {
+            console.log(`🔑 [Crane-Build] 正在认证: ${registryHost}`);
+            execSync(`"${CRANE_PATH}" auth login ${registryHost} -u "${varPool.DOCKER_USER}" -p "${varPool.DOCKER_PASS}" ${flags}`, { stdio: 'inherit' });
+        }
+
+        console.log(`\n🚀 [Crane-Build] 变量处理完成`);
+        console.log(`   最终镜像名: ${FULL_IMAGE}`);
+
+        const tmpBase = path.join(process.cwd(), '.crane_tmp');
+        if (fs.existsSync(tmpBase)) fs.rmSync(tmpBase, { recursive: true, force: true });
+        fs.mkdirSync(tmpBase, { recursive: true });
+
+        const layersToAppend = [];
+
+        // 4. 层打包逻辑
+        if (cfg.layers && Array.isArray(cfg.layers)) {
+            for (const layer of cfg.layers) {
+                console.log(`📦 [Crane-Build] 打包层: ${layer.name}`);
+                const layerDir = path.join(tmpBase, `l_${layer.name}`);
+                fs.mkdirSync(layerDir, { recursive: true });
+
+                for (const mapping of layer.files) {
+                    const src = path.resolve(process.cwd(), mapping.from);
+                    const dest = path.join(layerDir, mapping.to);
+                    fs.mkdirSync(path.dirname(dest), { recursive: true });
+                    if (fs.existsSync(src)) {
+                        if (fs.lstatSync(src).isDirectory()) fs.cpSync(src, dest, { recursive: true });
+                        else fs.copyFileSync(src, dest);
+                    } else {
+                        console.warn(`⚠️ [Crane-Build] 警告: 文件不存在 ${src}`);
+                    }
+                }
+
+                const layerTar = path.join(tmpBase, `${layer.name}.tar`);
+                await tar.c({ gzip: false, file: layerTar, cwd: layerDir }, ['.']);
+                layersToAppend.push(`-f "${layerTar}"`);
+            }
+        }
+
+        // 5. 推送层数据
+        if (layersToAppend.length > 0) {
+            console.log(`\n🚚 [Crane-Build] 正在执行合并并推送内容层...`);
+            execSync(`"${CRANE_PATH}" append -b ${FROM_IMAGE} ${layersToAppend.join(' ')} -t ${FULL_IMAGE} ${flags}`, { stdio: 'inherit' });
+        }
+
+        // 6. 修改元数据
+        console.log(`\n🔧 [Crane-Build] 正在修改镜像运行元数据 (Expose/Envs)...`);
+        let mutateCmd = `"${CRANE_PATH}" mutate ${FULL_IMAGE} -t ${FULL_IMAGE} ${flags}`;
+        (cfg.exposedPorts || []).forEach(p => mutateCmd += ` --exposed-ports ${p}`);
+        Object.entries(cfg.envs || {}).forEach(([k, v]) => mutateCmd += ` --env ${k}="${v}"`);
+        execSync(mutateCmd, { stdio: 'inherit' });
+
+        // 7. 清理
+        console.log(`\n🧹 [Crane-Build] 正在清理临时打包文件...`);
+        fs.rmSync(tmpBase, { recursive: true, force: true });
+
+        console.log(`\n✨ [成功] 镜像发布完成！`);
+        console.log(`   👉 镜像地址: ${FULL_IMAGE}\n`);
+
+    } catch (error) {
+        console.error(`\n❌ [Crane-Build] 构建中断`);
+        if (error.stderr) console.error(error.stderr.toString());
+        else console.error(error.message);
+        process.exit(1);
+    }
+}
+
+run();

package/bin/install.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import os from 'os';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const VERSION = '0.20.2';
+
+async function install() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    let platformName = '';
+    if (platform === 'win32') platformName = 'Windows_x86_64';
+    else if (platform === 'darwin') platformName = arch === 'arm64' ? 'Darwin_arm64' : 'Darwin_x86_64';
+    else platformName = arch === 'arm64' ? 'Linux_arm64' : 'Linux_x86_64';
+
+    const url = `https://github.com/google/go-containerregistry/releases/download/v${VERSION}/go-containerregistry_${platformName}.tar.gz`;
+    const exeName = platform === 'win32' ? 'crane.exe' : 'crane';
+    const tarFile = path.join(__dirname, 'crane.tar.gz');
+
+    console.log(`[Crane-Install] 正在下载 Crane v${VERSION} (${platformName})...`);
+
+    try {
+        const response = await fetch(url);
+        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+
+        const arrayBuffer = await response.arrayBuffer();
+        fs.writeFileSync(tarFile, Buffer.from(arrayBuffer));
+
+        // 解压到当前 bin 目录
+        execSync(`tar -xzf "${tarFile}" -C "${__dirname}" ${exeName}`, { stdio: 'inherit' });
+        fs.unlinkSync(tarFile);
+
+        if (platform !== 'win32') {
+            fs.chmodSync(path.join(__dirname, exeName), 0o755);
+        }
+        console.log(`✅ Crane 二进制文件就绪: ${path.join(__dirname, exeName)}`);
+    } catch (err) {
+        console.error('❌ 下载失败:', err.message);
+        process.exit(1);
+    }
+}
+
+install();

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@anonymousmister/crane-tool",
+  "version": "1.0.0",
+  "description": "基于 Crane 的分层镜像构建工具,模仿 jib 的功能",
+  "type": "module",
+  "main": "bin/build.js",
+  "bin": {
+    "crane": "./bin/crane",
+    "crane-tool-build": "./bin/build.js"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xaboy/form-create-designer.git"
+  },
+  "keywords": [
+    "crane",
+    "jib",
+    "docker",
+    "nginx",
+    "vite"
+  ],
+  "author": "misterzhang",
+  "license": "MIT",
+  "dependencies": {
+    "ini": "^6.0.0",
+    "tar": "^7.5.2"
+  },
+  "scripts": {
+    "postinstall": "node bin/install.js"
+  }
+}