@cloudbase/manager-node 4.2.12 → 4.3.0

package/lib/cloudrun/index.js

@@ -0,0 +1,157 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudRunService = void 0;
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("../utils");
+/**
+ * 云托管服务管理类
+ * 提供云托管服务的初始化、下载、列表查询和删除等功能
+ */
+class CloudRunService {
+    constructor(environment) {
+        this.environment = environment;
+        this.tcbrService = new utils_1.CloudService(environment.cloudBaseContext, 'tcbr', '2022-02-17');
+        this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+    }
+    /**
+     * 初始化云托管代码项目
+     * @param {Object} params 初始化参数
+     * @param {string} params.serverName 服务名称，将作为项目目录名
+     * @param {string} [params.template='helloworld'] 模板标识符，默认为'helloworld'
+     * @param {string} [params.targetPath='.'] 目标路径，默认为当前目录
+     * @returns {Promise<void>}
+     * @throws 当模板不存在、下载失败或解压失败时抛出错误
+     */
+    async init(params) {
+        const { serverName, template = 'helloworld', targetPath = '.' } = params || {};
+        // 1. 获取模板列表
+        const templates = await this.getTemplates();
+        const templateData = templates.find(item => item.identifier === template);
+        if (!templateData || !templateData.zipFileStore) {
+            throw new Error(`未找到匹配的模板: ${template}`);
+        }
+        // 2. 下载并解压模板到目标目录
+        const downloadUrl = templateData.zipFileStore;
+        const projectDir = path_1.default.resolve(targetPath, serverName);
+        await (0, utils_1.downloadAndExtractRemoteZip)(downloadUrl, projectDir);
+        return { projectDir };
+    }
+    /**
+     * 下载云托管服务代码到本地目录
+     * @param {Object} params 下载参数
+     * @param {string} params.serverName 要下载的服务名称
+     * @param {string} params.targetPath 下载的目标路径(绝对路径或相对路径)
+     * @returns {Promise<void>}
+     * @throws 当以下情况发生时抛出错误:
+     * - 未找到服务版本
+     * - 获取下载地址失败
+     * - 下载或解压过程中出错
+     */
+    async download(params) {
+        var _a, _b;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const { serverName, targetPath } = params;
+        /**
+         * 获取最新版本
+         */
+        const cloudRunServerDetailRes = await this.tcbrService.request('DescribeCloudRunServerDetail', {
+            EnvId: envConfig.EnvId,
+            ServerName: serverName
+        });
+        const version = (_b = (_a = cloudRunServerDetailRes.OnlineVersionInfos) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.VersionName;
+        if (!version) {
+            throw new Error('未找到云托管服务版本');
+        }
+        /**
+         * 获取下载地址
+         */
+        const cloudBaseBuildServiceRes = await this.tcbService.request('DescribeCloudBaseBuildService', {
+            EnvId: envConfig.EnvId,
+            ServiceName: serverName,
+            ServiceVersion: version
+        });
+        if (cloudBaseBuildServiceRes === null || cloudBaseBuildServiceRes === void 0 ? void 0 : cloudBaseBuildServiceRes.DownloadUrl) {
+            await (0, utils_1.downloadAndExtractRemoteZip)(cloudBaseBuildServiceRes === null || cloudBaseBuildServiceRes === void 0 ? void 0 : cloudBaseBuildServiceRes.DownloadUrl, path_1.default.resolve(targetPath));
+        }
+        else {
+            throw new Error(`云托管代码下载地址为空（请求ID: ${cloudBaseBuildServiceRes.RequestId}）`);
+        }
+    }
+    /**
+     * 获取云托管服务列表
+     * @param {Object} [params] 查询参数
+     * @param {number} [params.pageSize] 每页数量
+     * @param {number} [params.pageNum] 页码
+     * @param {string} [params.serverName] 服务名称筛选
+     * @param {string} [params.serverType] 服务类型筛选
+     * @returns {Promise<ICloudrunListResponse>} 包含服务列表和总数等信息的响应对象
+     */
+    async list(params) {
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        return this.tcbrService.request('DescribeCloudRunServers', Object.assign({ EnvId: envConfig.EnvId }, {
+            PageSize: (params === null || params === void 0 ? void 0 : params.pageSize) || 10,
+            PageNum: (params === null || params === void 0 ? void 0 : params.pageNum) || 1,
+            ServerName: params === null || params === void 0 ? void 0 : params.serverName,
+            ServerType: params === null || params === void 0 ? void 0 : params.serverType
+        }));
+    }
+    /**
+     *查询云托管服务详情
+     * @param {Object} params 查询参数
+     * @param {string} params.serverName 要查询的服务名称
+     * @returns {Promise<ICloudrunDetailResponse>} 返回服务详情响应对象
+     */
+    async detail(params) {
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        return this.tcbrService.request('DescribeCloudRunServerDetail', {
+            EnvId: envConfig.EnvId,
+            ServerName: params.serverName
+        });
+    }
+    /**
+     * 删除指定的云托管服务
+     * @param {string} serverName - 要删除的服务名称，必须是在当前环境中已存在的服务
+     * @returns {Promise<IResponseInfo>} 返回删除操作的响应信息
+     */
+    async delete(params) {
+        // 获取当前环境配置(包含EnvId)
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        // 调用TCBR服务的DeleteCloudRunServer接口执行删除
+        return this.tcbrService.request('DeleteCloudRunServer', {
+            EnvId: envConfig.EnvId, // 环境ID
+            ServerName: params.serverName // 要删除的服务名称
+        });
+    }
+    /**
+     * 获取云托管服务模板列表
+     * @returns {Promise<ITemplate[]>} 返回模板数组
+     */
+    async getTemplates() {
+        return (0, utils_1.fetchTemplates)(['tcbrFunc', 'tcbrContainer']);
+    }
+}
+exports.CloudRunService = CloudRunService;
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "init", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "download", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "list", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "detail", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "delete", null);

package/lib/cloudrun/type.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudrunServerType = void 0;
+var CloudrunServerType;
+(function (CloudrunServerType) {
+    /**
+     * 函数型服务
+     */
+    CloudrunServerType["Function"] = "function";
+    /**
+     * 容器型服务
+     */
+    CloudrunServerType["Container"] = "container";
+})(CloudrunServerType || (exports.CloudrunServerType = CloudrunServerType = {}));

package/lib/environment.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Environment = void 0;
 const database_1 = require("./database");
 const function_1 = require("./function");
+const cloudrun_1 = require("./cloudrun");
 const storage_1 = require("./storage");
 const env_1 = require("./env");
 const common_1 = require("./common");
@@ -22,6 +23,7 @@ class Environment {
         this.envType = context.envType;
         // 拉取当前环境 的环境信息 todo
         this.functionService = new function_1.FunctionService(this);
+        this.cloudRunService = new cloudrun_1.CloudRunService(this);
         this.databaseService = new database_1.DatabaseService(this);
         this.storageService = new storage_1.StorageService(this);
         this.envService = new env_1.EnvService(this);
@@ -62,6 +64,9 @@ class Environment {
     getFunctionService() {
         return this.functionService;
     }
+    getCloudRunService() {
+        return this.cloudRunService;
+    }
     getEnvService() {
         return this.envService;
     }

package/lib/index.js

@@ -46,6 +46,9 @@ class CloudBase {
     get functions() {
         return this.currentEnvironment().getFunctionService();
     }
+    get cloudrun() {
+        return this.currentEnvironment().getCloudRunService();
+    }
     get storage() {
         return this.currentEnvironment().getStorageService();
     }

package/lib/utils/http-request.js

@@ -10,7 +10,7 @@ const node_fetch_1 = __importDefault(require("node-fetch"));
 const https_proxy_agent_1 = require("https-proxy-agent");
 const error_1 = require("../error");
 // 使用 fetch + 代理
-async function fetch(url, config = {}, proxy) {
+async function fetch(url, config = {}, proxy = null) {
     if (proxy || process.env.http_proxy) {
         config.agent = new https_proxy_agent_1.HttpsProxyAgent(proxy || process.env.http_proxy);
     }
@@ -33,7 +33,7 @@ async function fetch(url, config = {}, proxy) {
     }
     return json;
 }
-async function fetchStream(url, config = {}, proxy) {
+async function fetchStream(url, config = {}, proxy = null) {
     if (proxy || process.env.http_proxy) {
         config.agent = new https_proxy_agent_1.HttpsProxyAgent(proxy || process.env.http_proxy);
     }

package/lib/utils/index.js

@@ -19,28 +19,35 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.guid6 = void 0;
 exports.compressToZip = compressToZip;
+exports.downloadAndExtractRemoteZip = downloadAndExtractRemoteZip;
 exports.getRuntime = getRuntime;
 exports.getEnvVar = getEnvVar;
 exports.rsaEncrypt = rsaEncrypt;
 exports.sleep = sleep;
 exports.upperCaseStringFisrt = upperCaseStringFisrt;
 exports.upperCaseObjKey = upperCaseObjKey;
-const fs_1 = __importDefault(require("fs"));
+exports.fetchTemplates = fetchTemplates;
 const archiver_1 = __importDefault(require("archiver"));
 const crypto_1 = __importDefault(require("crypto"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const lodash_1 = __importDefault(require("lodash"));
+const path_1 = __importDefault(require("path"));
+const stream_1 = require("stream");
+const unzipper_1 = __importDefault(require("unzipper"));
 const constant_1 = require("../constant");
-var uuid_1 = require("./uuid");
-Object.defineProperty(exports, "guid6", { enumerable: true, get: function () { return uuid_1.guid6; } });
-__exportStar(require("./cloud-api-request"), exports);
+const http_request_1 = require("./http-request");
 __exportStar(require("./auth"), exports);
+__exportStar(require("./cloud-api-request"), exports);
 __exportStar(require("./cloudbase-request"), exports);
-__exportStar(require("./http-request"), exports);
 __exportStar(require("./envLazy"), exports);
 __exportStar(require("./fs"), exports);
+__exportStar(require("./http-request"), exports);
+var uuid_1 = require("./uuid");
+Object.defineProperty(exports, "guid6", { enumerable: true, get: function () { return uuid_1.guid6; } });
 async function compressToZip(option) {
     const { dirPath, outputPath, ignore, pattern = '**/*' } = option;
     return new Promise((resolve, reject) => {
-        const output = fs_1.default.createWriteStream(outputPath);
+        const output = fs_extra_1.default.createWriteStream(outputPath);
         const archive = (0, archiver_1.default)('zip');
         output.on('close', function () {
             resolve({
@@ -62,6 +69,36 @@ async function compressToZip(option) {
         archive.finalize();
     });
 }
+/**
+ * 下载并解压云托管模板到指定目录
+ * @param {string} downloadUrl 模板下载地址
+ * @param {string} targetPath 目标路径
+ * @returns {Promise<void>}
+ * @throws 当下载失败或解压失败时抛出错误
+ */
+async function downloadAndExtractRemoteZip(downloadUrl, targetPath) {
+    const downloadResponse = await (0, http_request_1.fetchStream)(downloadUrl);
+    if (!downloadResponse.ok) {
+        throw new Error(`下载失败，状态码: ${downloadResponse.status}`);
+    }
+    if (!downloadResponse.body) {
+        throw new Error('下载响应中没有数据流');
+    }
+    // 将响应数据转为Buffer
+    const zipBuffer = Buffer.from(await downloadResponse.arrayBuffer());
+    // 创建目标目录
+    const dirPath = path_1.default.resolve(targetPath);
+    await fs_extra_1.default.ensureDir(dirPath);
+    // 使用unzipper解压
+    await new Promise((resolve, reject) => {
+        const bufferStream = new stream_1.PassThrough();
+        bufferStream.end(zipBuffer);
+        bufferStream
+            .pipe(unzipper_1.default.Extract({ path: dirPath }))
+            .on('close', resolve)
+            .on('error', reject);
+    });
+}
 function getRuntime() {
     return process.env[constant_1.ENV_NAME.ENV_RUNENV];
 }
@@ -105,3 +142,15 @@ function upperCaseObjKey(object) {
     }
     return object;
 }
+/**
+ * 获取函数模板列表
+ * @param type 函数模板类型，支持 'scfFunc' 和 'tcbrFunc'
+ * @returns
+ */
+async function fetchTemplates(types) {
+    const apiUrl = 'https://qcloud-tcb-console-1258344699.ap-shanghai.service.tcloudbase.com/func_tpl/v1.0/function_list/find?skip=0&limit=500';
+    const responseData = await (0, http_request_1.fetch)(apiUrl, {
+        method: 'POST'
+    });
+    return responseData.data.filter((item) => lodash_1.default.intersection(types, item.funcTypes).length > 0);
+}

package/package.json

@@ -1,15 +1,18 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "4.2.12",
+    "version": "4.3.0",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {
         "build": "rimraf lib types && npx tsc",
-        "test": "jest --runInBand --detectOpenHandles --coverage --testTimeout=50000",
+        "test:coverage": "jest --runInBand --detectOpenHandles --coverage --testTimeout=50000",
+        "test": "jest --runInBand --detectOpenHandles --testTimeout=50000",
         "lint": "eslint \"./**/*.ts\"",
         "lint:fix": "eslint --fix \"./**/*.ts\"",
         "prepublishOnly": "npm run build",
-        "watch": "rimraf lib types && tsc -w"
+        "watch": "rimraf lib types && tsc -w",
+        "link": "node scripts/link.js",
+        "unlink": "node scripts/link.js -d"
     },
     "repository": {
         "type": "git",
@@ -19,9 +22,12 @@
     "license": "ISC",
     "typings": "types/index.d.ts",
     "devDependencies": {
+        "@lerna/create-symlink": "^6.4.1",
+        "@types/fs-extra": "^11.0.4",
         "@types/jest": "^24.0.18",
         "@types/node": "^12.7.4",
         "@types/node-fetch": "^2.5.0",
+        "@types/unzipper": "^0.10.11",
         "@typescript-eslint/eslint-plugin": "^3.7.1",
         "@typescript-eslint/parser": "^3.7.1",
         "eslint": "^7.6.0",
@@ -38,11 +44,14 @@
         "archiver": "^3.1.1",
         "cos-nodejs-sdk-v5": "^2.14.0",
         "del": "^5.1.0",
+        "fs-extra": "^11.3.0",
         "https-proxy-agent": "^5.0.1",
+        "lodash": "^4.17.21",
         "make-dir": "^3.0.0",
         "micromatch": "^4.0.2",
         "node-fetch": "^2.6.0",
         "query-string": "^6.8.3",
+        "unzipper": "^0.12.3",
         "walkdir": "^0.4.1"
     },
     "husky": {

package/scripts/link.js

@@ -0,0 +1,98 @@
+/**
+ * Tencent is pleased to support the open source community by making CloudBaseFramework - 云原生一体化部署工具 available.
+ *
+ * Copyright (C) 2020 THL A29 Limited, a Tencent company.  All rights reserved.
+ *
+ * Please refer to license text included with this package for license details.
+ */
+
+const os = require('os')
+const fs = require('fs')
+const fse = require('fs-extra')
+const del = require('del')
+const path = require('path')
+const mkdirp = require('mkdirp')
+const { execSync } = require('child_process')
+const { createSymlink } = require('@lerna/create-symlink')
+
+const globalNpmPath = execSync('npm root -g', {
+    encoding: 'utf-8'
+}).trim()
+// 如果不支持workspace 可以用下面写死
+// const globalNpmPath = '/usr/local/lib/node_modules';
+
+async function main() {
+    const unlink = process.argv?.[2] === '-d'
+    await linkCore(unlink)
+}
+
+async function linkCore(unlink = false) {
+    const jsonString = await fs.readFileSync(path.join(__dirname, '../package.json'))
+    const { name } = JSON.parse(jsonString)
+    await link(path.join(process.cwd()), path.join(globalNpmPath, '@cloudbase/cli'), name, unlink)
+}
+
+function isSymlink(path) {
+    const stats = fs.lstatSync(path)
+    return stats.isSymbolicLink()
+}
+
+// 将 global tcb cli 工具中的 framework-core link 到 packages/framework-core
+async function link(src, dest, packageName, unlink = false) {
+    const prevCwd = process.cwd()
+    const destPlugin = path.join(dest, 'node_modules', '@cloudbase')
+    // 确保目录存在
+    mkdirp.sync(destPlugin)
+    // 切换 cwd
+    process.chdir(destPlugin)
+
+    const pathName = packageName.replace('@cloudbase/', '')
+    const backupPathName = `${pathName}_backup`
+
+    if (unlink) {
+        if (fs.existsSync(pathName) && !isSymlink(pathName)) {
+            console.log(`【失败】${pathName} 不是软链接`, process.cwd())
+            return
+        }
+
+        if (fs.existsSync(pathName) && fs.existsSync(backupPathName)) {
+            // 删除软链接
+            del.sync([pathName])
+
+            // 恢复备份
+            fse.moveSync(backupPathName, pathName)
+
+            // 删除软链接
+            console.log('【成功】删除软链接：', process.cwd())
+        } else {
+            console.info(
+                `不存在 ${pathName} 或 ${backupPathName}，请重装安装 npm i @cloudbase/cli -g`,
+                process.cwd()
+            )
+        }
+    } else {
+        // 创建软链接
+
+        if (fs.existsSync(pathName)) {
+            if (!fs.existsSync(backupPathName)) {
+                // 不存在备份则进行备份
+
+                if (!isSymlink(pathName)) {
+                    // 不是软链接才备份
+                    fse.moveSync(pathName, backupPathName)
+                }
+            } else {
+                // 存在备份则直接删除
+                del.sync([pathName])
+            }
+        }
+
+        await createSymlink(src, pathName, 'junction')
+        console.log('【成功】创建软链接：', process.cwd())
+    }
+
+    // 切回源目录
+    process.chdir(prevCwd)
+}
+
+main()

package/tsconfig.json

@@ -11,7 +11,8 @@
         "declaration": true,
         "declarationDir": "./types",
         "experimentalDecorators": true,
-        "newLine": "LF"
+        "newLine": "LF",
+        "skipLibCheck": true
     },
     "include": ["src/**/*"],
     "exclude": ["node_modules", "test"]

package/types/cloudrun/index.d.ts

@@ -0,0 +1,81 @@
+import { Environment } from '../environment';
+import { IResponseInfo } from '../interfaces';
+import { CloudrunServerType, ICloudrunDetailResponse, ICloudrunListResponse, ITemplate } from './type';
+/**
+ * 云托管服务管理类
+ * 提供云托管服务的初始化、下载、列表查询和删除等功能
+ */
+export declare class CloudRunService {
+    private environment;
+    private tcbrService;
+    private tcbService;
+    constructor(environment: Environment);
+    /**
+     * 初始化云托管代码项目
+     * @param {Object} params 初始化参数
+     * @param {string} params.serverName 服务名称，将作为项目目录名
+     * @param {string} [params.template='helloworld'] 模板标识符，默认为'helloworld'
+     * @param {string} [params.targetPath='.'] 目标路径，默认为当前目录
+     * @returns {Promise<void>}
+     * @throws 当模板不存在、下载失败或解压失败时抛出错误
+     */
+    init(params: {
+        serverName: string;
+        template?: string;
+        targetPath?: string;
+    }): Promise<{
+        projectDir: string;
+    }>;
+    /**
+     * 下载云托管服务代码到本地目录
+     * @param {Object} params 下载参数
+     * @param {string} params.serverName 要下载的服务名称
+     * @param {string} params.targetPath 下载的目标路径(绝对路径或相对路径)
+     * @returns {Promise<void>}
+     * @throws 当以下情况发生时抛出错误:
+     * - 未找到服务版本
+     * - 获取下载地址失败
+     * - 下载或解压过程中出错
+     */
+    download(params: {
+        serverName: string;
+        targetPath: string;
+    }): Promise<void>;
+    /**
+     * 获取云托管服务列表
+     * @param {Object} [params] 查询参数
+     * @param {number} [params.pageSize] 每页数量
+     * @param {number} [params.pageNum] 页码
+     * @param {string} [params.serverName] 服务名称筛选
+     * @param {string} [params.serverType] 服务类型筛选
+     * @returns {Promise<ICloudrunListResponse>} 包含服务列表和总数等信息的响应对象
+     */
+    list(params?: {
+        pageSize?: number;
+        pageNum?: number;
+        serverName?: string;
+        serverType?: CloudrunServerType;
+    }): Promise<ICloudrunListResponse>;
+    /**
+     *查询云托管服务详情
+     * @param {Object} params 查询参数
+     * @param {string} params.serverName 要查询的服务名称
+     * @returns {Promise<ICloudrunDetailResponse>} 返回服务详情响应对象
+     */
+    detail(params: {
+        serverName: string;
+    }): Promise<ICloudrunDetailResponse>;
+    /**
+     * 删除指定的云托管服务
+     * @param {string} serverName - 要删除的服务名称，必须是在当前环境中已存在的服务
+     * @returns {Promise<IResponseInfo>} 返回删除操作的响应信息
+     */
+    delete(params: {
+        serverName: string;
+    }): Promise<IResponseInfo>;
+    /**
+     * 获取云托管服务模板列表
+     * @returns {Promise<ITemplate[]>} 返回模板数组
+     */
+    getTemplates(): Promise<ITemplate[]>;
+}

package/types/cloudrun/type.d.ts

@@ -0,0 +1,315 @@
+export declare enum CloudrunServerType {
+    /**
+     * 函数型服务
+     */
+    Function = "function",
+    /**
+     * 容器型服务
+     */
+    Container = "container"
+}
+/**
+ * 服务基础信息接口
+ */
+export interface ICloudrunServerBaseInfo {
+    /**
+     * 服务名称
+     * @example "serverName"
+     */
+    ServerName: string;
+    /**
+     * 默认服务域名
+     * @example "http://xxx.xxx.xxx"
+     */
+    DefaultDomainName: string;
+    /**
+     * 自定义域名
+     * @example "http://xxx.xxx.xxx"
+     */
+    CustomDomainName: string;
+    /**
+     * 服务状态
+     * @example "running" | "deploying" | "deploy_failed"
+     */
+    Status: 'running' | 'deploying' | 'deploy_failed';
+    /**
+     * 更新时间
+     * @example "2022-03-09 14:00:00"
+     */
+    UpdateTime: string;
+    /**
+     * 公网访问类型数组
+     * @example ["OA","MINIAPP","VPC"]
+     */
+    AccessTypes: string[];
+    /**
+     * 展示自定义域名数组
+     * @example ["http://xxx.xxx.xxx","http://xxx.xxx.xxx"]
+     */
+    CustomDomainNames: string[];
+    /**
+     * 服务类型
+     * @example "function" | "container"
+     */
+    ServerType: CloudrunServerType;
+    /**
+     * 流量类型（请根据实际业务补充具体类型定义）
+     */
+    TrafficType?: string;
+}
+/**
+ * 扩缩容策略配置
+ */
+export interface ICloudrunHpaPolicy {
+    /**
+     * 扩缩容类型
+     * @example "cpu" | "mem" | "cpu/mem"
+     */
+    PolicyType: string;
+    /**
+     * 扩缩容阈值(百分比)
+     * @example 60
+     */
+    PolicyThreshold: number;
+}
+/**
+ * 定时扩缩容配置
+ */
+export interface ICloudrunTimerScale {
+    /**
+     * 循环类型
+     * @example "none"
+     */
+    CycleType?: string;
+    /**
+     * 循环起始日期
+     * @example "2022-09-08"
+     */
+    StartDate?: string;
+    /**
+     * 循环结束日期
+     * @example "2022-09-08"
+     */
+    EndDate?: string;
+    /**
+     * 起始时间
+     * @example "00:00:00"
+     */
+    StartTime?: string;
+    /**
+     * 结束时间
+     * @example "23:59:00"
+     */
+    EndTime?: string;
+    /**
+     * 副本个数
+     * @example 1
+     */
+    ReplicaNum?: number;
+}
+/**
+ * 服务基础配置信息
+ */
+export interface ICloudrunServerBaseConfig {
+    /**
+     * 环境 ID
+     * @example "test-1gbtbgkjf8f48e2c"
+     */
+    EnvId: string;
+    /**
+     * 服务名称
+     * @example "server-name"
+     */
+    ServerName: string;
+    /**
+     * 公网访问类型数组
+     * @example ["PUBLIC", "OA", "MINIAPP", "VPC", ""]
+     */
+    OpenAccessTypes: string[];
+    /**
+     * CPU 规格
+     * @example 0.25
+     */
+    Cpu: number;
+    /**
+     * 内存规格
+     * @example 0.25
+     */
+    Mem: number;
+    /**
+     * 最小副本数
+     * @example 1
+     */
+    MinNum: number;
+    /**
+     * 最大副本数
+     * @example 2
+     */
+    MaxNum: number;
+    /**
+     * 扩缩容配置
+     * @example cpu, mem, cpu/mem
+     */
+    PolicyDetails: ICloudrunHpaPolicy[];
+    /**
+     * 日志采集路径
+     * @example "stdout"
+     */
+    CustomLogs: string;
+    /**
+     * 环境变量
+     * @example {"MYSQL_USERNAME":"root"}
+     */
+    EnvParams: string;
+    /**
+     * 延迟检测时间(秒)
+     * @example 2
+     */
+    InitialDelaySeconds: number;
+    /**
+     * 创建时间
+     * @example "2022-03-10 19:44:07"
+     */
+    CreateTime: string;
+    /**
+     * 服务端口
+     * @example 8080
+     */
+    Port: number;
+    /**
+     * 是否有 Dockerfile
+     * @example true
+     */
+    HasDockerfile: boolean;
+    /**
+     * Dockerfile 文件名
+     * @example "Dockerfile"
+     */
+    Dockerfile: string;
+    /**
+     * 构建目录
+     * @example "src/"
+     */
+    BuildDir: string;
+    /**
+     * 日志类型
+     * @example "none" | "default" | "custom"
+     */
+    LogType?: string;
+    /**
+     * CLS 日志集 ID
+     * @example "dafslakfjkdal"
+     */
+    LogSetId?: string;
+    /**
+     * CLS 主题 ID
+     * @example "sfafkslkfj"
+     */
+    LogTopicId?: string;
+    /**
+     * 日志解析类型
+     * @example "json" | "line"
+     */
+    LogParseType?: string;
+    /**
+     * 服务标签
+     * @example "function"
+     */
+    Tag?: string;
+    /**
+     * 内网访问开关
+     * @example "close" | "open"
+     */
+    InternalAccess?: string;
+    /**
+     * 内网域名
+     * @example "https://sdfsdf"
+     */
+    InternalDomain?: string;
+    /**
+     * 运行模式
+     * @example "custom"
+     */
+    OperationMode?: string;
+    /**
+     * 定时扩缩容配置
+     */
+    TimerScale?: ICloudrunTimerScale[];
+    /**
+     * Dockerfile EntryPoint 参数
+     * @example ["echo", "test"]
+     */
+    EntryPoint?: string[];
+    /**
+     * Dockerfile Cmd 参数
+     * @example ["echo", "test"]
+     */
+    Cmd?: string[];
+}
+/**
+ * 在线版本信息
+ */
+export interface ICloudrunOnlineVersionInfo {
+    /**
+     * 版本名称
+     * @example "test-001"
+     */
+    VersionName: string;
+    /**
+     * 镜像URL
+     * @example "imageurl"
+     */
+    ImageUrl: string;
+    /**
+     * 流量比例
+     * @example "100"
+     */
+    FlowRatio: string;
+}
+/**
+ * 服务列表响应接口
+ */
+export interface ICloudrunListResponse {
+    /**
+     * 服务列表数组
+     */
+    ServerList: ICloudrunServerBaseInfo[];
+    /**
+     * 服务总数
+     * @example 10
+     */
+    Total: number;
+    /**
+     * 请求ID
+     */
+    RequestId: string;
+}
+/**
+ * 服务详情响应接口
+ */
+export interface ICloudrunDetailResponse {
+    /**
+     * 服务基本信息
+     */
+    BaseInfo: ICloudrunServerBaseInfo;
+    /**
+     * 服务配置信息
+     */
+    ServerConfig: ICloudrunServerBaseConfig;
+    /**
+     * 在线版本信息
+     */
+    OnlineVersionInfos: ICloudrunOnlineVersionInfo[];
+    /**
+     * 请求ID
+     */
+    RequestId: string;
+}
+export interface ITemplate {
+    identifier: string;
+    title: string;
+    description: string;
+    runtimeVersion: string;
+    language: string;
+    zipFileStore: string;
+}

package/types/environment.d.ts

@@ -1,5 +1,6 @@
 import { DatabaseService } from './database';
 import { FunctionService } from './function';
+import { CloudRunService } from './cloudrun';
 import { StorageService } from './storage';
 import { EnvService } from './env';
 import { CommonService } from './common';
@@ -17,6 +18,7 @@ export declare class Environment {
     private envId;
     private envType?;
     private functionService;
+    private cloudRunService;
     private databaseService;
     private storageService;
     private envService;
@@ -32,6 +34,7 @@ export declare class Environment {
     getStorageService(): StorageService;
     getDatabaseService(): DatabaseService;
     getFunctionService(): FunctionService;
+    getCloudRunService(): CloudRunService;
     getEnvService(): EnvService;
     getHostingService(): HostingService;
     getThirdService(): ThirdService;

package/types/index.d.ts

@@ -1,5 +1,6 @@
 import { EnvService } from './env';
 import { FunctionService } from './function';
+import { CloudRunService } from './cloudrun';
 import { StorageService } from './storage';
 import { DatabaseService } from './database';
 import { CommonService } from './common';
@@ -37,6 +38,7 @@ declare class CloudBase {
     addEnvironment(envId: string): void;
     currentEnvironment(): Environment;
     get functions(): FunctionService;
+    get cloudrun(): CloudRunService;
     get storage(): StorageService;
     get database(): DatabaseService;
     get hosting(): HostingService;

package/types/utils/http-request.d.ts

@@ -1,3 +1,3 @@
 import _fetch from 'node-fetch';
-export declare function fetch(url: string, config: Record<string, any>, proxy: any): Promise<any>;
-export declare function fetchStream(url: string, config: Record<string, any>, proxy: any): Promise<_fetch.Response>;
+export declare function fetch(url: string, config?: Record<string, any>, proxy?: any): Promise<any>;
+export declare function fetchStream(url: string, config?: Record<string, any>, proxy?: any): Promise<_fetch.Response>;

package/types/utils/index.d.ts

@@ -1,10 +1,11 @@
-export { guid6 } from './uuid';
-export * from './cloud-api-request';
+import { ITemplate } from '../cloudrun/type';
 export * from './auth';
+export * from './cloud-api-request';
 export * from './cloudbase-request';
-export * from './http-request';
 export * from './envLazy';
 export * from './fs';
+export * from './http-request';
+export { guid6 } from './uuid';
 interface IZipOption {
     dirPath: string;
     outputPath: string;
@@ -12,9 +13,23 @@ interface IZipOption {
     pattern?: string;
 }
 export declare function compressToZip(option: IZipOption): Promise<unknown>;
+/**
+ * 下载并解压云托管模板到指定目录
+ * @param {string} downloadUrl 模板下载地址
+ * @param {string} targetPath 目标路径
+ * @returns {Promise<void>}
+ * @throws 当下载失败或解压失败时抛出错误
+ */
+export declare function downloadAndExtractRemoteZip(downloadUrl: string, targetPath: string): Promise<void>;
 export declare function getRuntime(): string;
 export declare function getEnvVar(envName: string): string;
 export declare function rsaEncrypt(data: string): string;
 export declare function sleep(time: number): Promise<void>;
 export declare function upperCaseStringFisrt(str: string): string;
 export declare function upperCaseObjKey(object: any): any;
+/**
+ * 获取函数模板列表
+ * @param type 函数模板类型，支持 'scfFunc' 和 'tcbrFunc'
+ * @returns
+ */
+export declare function fetchTemplates(types: ('scfFunc' | 'tcbrFunc' | 'tcbrContainer')[]): Promise<ITemplate[]>;