@cloudbase/manager-node 5.6.8 → 5.7.0-beta.1

package/lib/deploy/function/cloud-build-service.js

@@ -0,0 +1,170 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCloudBuildService = createCloudBuildService;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const error_1 = require("../../error");
+const utils_1 = require("../../utils");
+const http_request_1 = require("../../utils/http-request");
+const types_1 = require("../types");
+/**
+ * 基于 CloudAppService 的云端构建能力适配器
+ *
+ * 将 CloudApp custom 构建相关的 API/IO 逐一映射为 CloudImageBuilder 所需的
+ * ICloudBuildService 接口，使builder 与具体传输/网络实现解耦、便于测试替换。
+ *
+ * 步骤对应构建方案「阶段 A」（https://iwiki.woa.com/p/4020519533）：
+ * - packContext：打包源码目录为临时 ZIP（复用 compressToZip）
+ * - getCosInfo：DescribeCloudAppCosInfo（DeployType:custom）取上传凭证与UnixTimestamp
+ * - uploadZip：PUT 上传到 COS，携带服务端返回的全部 UploadHeaders
+ * - createBuild：CreateCloudApp（DeployType:custom）触发容器内 build+push
+ * - getVersionStatus：DescribeCloudAppVersion 查询分步状态与产物
+ */
+const CUSTOM_DEPLOY_TYPE = 'custom';
+const CUSTOM_BUILD_TYPE = 'zip';
+/** 云端构建打包默认忽略项，避免上传无关文件或本地环境密钥 */
+const DEFAULT_IGNORE = [
+    'node_modules/**',
+    '.git/**',
+    '.DS_Store',
+    '**/.DS_Store',
+    '**/.env',
+    // 保留 .env.example/.env.sample/.env.template，其余 .env.* 默认视为本地环境密钥
+    '**/.env.!(example|sample|template)'
+];
+/**
+ * 由CloudAppService 构造 ICloudBuildService实现
+ */
+function createCloudBuildService(cloudApp, options = {}) {
+    const ignore = [...DEFAULT_IGNORE, ...(options.ignore || [])];
+    return {
+        async packContext(cwd, extraEntries) {
+            if (!fs_1.default.existsSync(cwd) || !fs_1.default.statSync(cwd).isDirectory()) {
+                throw new error_1.CloudBaseError(`构建上下文目录不存在或不是目录：${cwd}`, {
+                    code: types_1.FUNCTION_DEPLOY_ERROR.BUILD_CONTEXT_INVALID
+                });
+            }
+            const zipPath = path_1.default.join(os_1.default.tmpdir(), `fn-cloud-build-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`);
+            const injectedEntries = (extraEntries || []).map(entry => ({
+                zipPath: entry.zipPath.replace(/\\/g, '/').replace(/^\.\//, ''),
+                content: entry.content,
+                mode: entry.mode
+            }));
+            // 源码中若存在与 SDK 注入文件同名的路径，必须从 glob 中排除，
+            // 避免 ZIP 出现重复 entry 后由解压顺序决定最终执行内容。
+            const contextIgnore = [
+                ...ignore,
+                ...injectedEntries.map(entry => entry.zipPath)
+            ];
+            // 把 SDK 注入的辅助文件（如 push 脚本）随源码一起打进zip，
+            // 通过临时文件注入，绝不写入用户源码目录。
+            try {
+                await (0, utils_1.compressToZip)({
+                    dirPath: cwd,
+                    outputPath: zipPath,
+                    ignore: contextIgnore,
+                    extraEntries: injectedEntries
+                });
+            }
+            catch (error) {
+                try {
+                    if (fs_1.default.existsSync(zipPath)) {
+                        fs_1.default.unlinkSync(zipPath);
+                    }
+                }
+                catch (_a) {
+                    // 清理未完成的临时 ZIP 失败不覆盖原始打包错误
+                }
+                const original = error instanceof Error ? error : new Error(String(error));
+                throw new error_1.CloudBaseError(`打包云端构建上下文失败：${original.message}`, {
+                    code: types_1.FUNCTION_DEPLOY_ERROR.BUILD_CONTEXT_INVALID,
+                    original
+                });
+            }
+            return zipPath;
+        },
+        async getCosInfo(serviceName) {
+            const res = await cloudApp.describeCosInfo({
+                deployType: CUSTOM_DEPLOY_TYPE,
+                serviceName,
+                suffix: '.zip'
+            });
+            return {
+                uploadUrl: res.UploadUrl,
+                uploadHeaders: (res.UploadHeaders || []).map(h => ({
+                    key: h.Key,
+                    value: h.Value
+                })),
+                unixTimestamp: res.UnixTimestamp
+            };
+        },
+        async uploadZip(cosInfo, zipPath) {
+            const zipBuffer = fs_1.default.readFileSync(zipPath);
+            // 必须携带服务端返回的全部 UploadHeaders，缺失会导致 COS 鉴权失败
+            const headers = { 'Content-Type': 'application/zip' };
+            for (const h of cosInfo.uploadHeaders) {
+                headers[h.key] = h.value;
+            }
+            const response = await (0, http_request_1.fetchStream)(cosInfo.uploadUrl, {
+                method: 'PUT',
+                body: zipBuffer,
+                headers
+            });
+            if (!response.ok) {
+                let detail = '';
+                try {
+                    const text = await response.text();
+                    detail = text ? ` - ${text.substring(0, 500)}` : '';
+                }
+                catch (_a) {
+                    // 解析响应体失败不影响主错误抛出
+                }
+                throw new error_1.CloudBaseError(`上传源码到 COS 失败：${response.status} ${response.statusText}${detail}`, { code: types_1.FUNCTION_DEPLOY_ERROR.CLOUD_UPLOAD_FAILED });
+            }
+        },
+        async createBuild(input) {
+            const res = await cloudApp.createApp({
+                deployType: CUSTOM_DEPLOY_TYPE,
+                serviceName: input.serviceName,
+                buildType: CUSTOM_BUILD_TYPE,
+                source: {
+                    type: CUSTOM_BUILD_TYPE,
+                    // 原样回填 DescribeCloudAppCosInfo 返回的时间戳，指向刚上传的源码包
+                    cosTimestamp: input.cosTimestamp,
+                    cosSuffix: '.zip'
+                },
+                env: input.env,
+                secrets: input.secrets,
+                customSteps: input.customSteps
+            });
+            return { buildId: res.BuildId, versionName: res.VersionName, requestId: res.RequestId };
+        },
+        async getVersionStatus(serviceName, versionName) {
+            const res = await cloudApp.describeAppVersion({
+                deployType: CUSTOM_DEPLOY_TYPE,
+                serviceName,
+                versionName
+            });
+            return {
+                status: res.Status,
+                steps: res.Steps,
+                artifacts: res.Artifacts,
+                requestId: res.RequestId
+            };
+        },
+        async cleanup(zipPath) {
+            if (zipPath && fs_1.default.existsSync(zipPath)) {
+                fs_1.default.unlinkSync(zipPath);
+            }
+        },
+        delay(ms) {
+            return new Promise(resolve => {
+                setTimeout(resolve, ms);
+            });
+        }
+    };
+}