@cloudbase/manager-node 5.6.5 → 5.6.7

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## @cloudbase/manager-node v5.6.6 版本发布 🚀(2026-07-31)
+
+- 新增 uploadCode 新增 onPhase 分步计时回调
+- 优化 标记 HTTP Service (CloudBaseGW) 模块自 v5.0.0 起废弃，并添加迁移指引
+
+---
+
+## @cloudbase/manager-node v5.6.5 版本发布 🚀(2026-07-28)
+
+- 新增 PostgreSQL 数据库迁移相关 API 与类型定义
+- 新增 统一 SCF/TCBR Agent 日志查询走 CLS searchClsLog
+- 新增 code 入参并完善相关文档与测试
+
+---
+
+## @cloudbase/manager-node v5.6.4 版本发布 🚀(2026-07-23)
+
+- 新增 code 入参并完善相关文档与测试
+- 重构 更新默认 Runtime 为 Nodejs20.19
+- 修复 移除创建云函数时 Timeout 默认值，改为透传 SCF 默认值
+
+---
+
+## @cloudbase/manager-node v5.6.3 版本发布 🚀(2026-07-16)
+
+- 重构 更新默认 Runtime 为 Nodejs20.19
+- 修复 移除创建云函数时 Timeout 默认值，改为透传 SCF 默认值
+
+---
+
 ## @cloudbase/manager-node v5.6.2 版本发布 🚀(2026-07-09)
 
 - 新增 支持镜像部署模式

package/lib/access/index.js

@@ -8,6 +8,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AccessService = void 0;
 const utils_1 = require("../utils");
+/**
+ * HTTP Service（CloudBaseGW）访问服务。
+ * 注意：HTTP Service 模块自 v5.0.0 起已废弃，建议迁移到 EnvService 的域名与路由能力
+ * （如 createHttpServiceRoute / modifyHttpServiceRoute / deleteHttpServiceRoute）。
+ */
 class AccessService {
     constructor(environment) {
         this.environment = environment;

package/lib/cloudApp/index.js

@@ -126,7 +126,7 @@ class CloudAppService {
      * @param params 上传参数
      */
     async uploadCode(params) {
-        const { serviceName, localPath, ignore = [] } = params;
+        const { serviceName, localPath, ignore = [], onPhase } = params;
         // 1. 验证本地路径
         if (!fs_1.default.existsSync(localPath)) {
             throw new error_1.CloudBaseError(`本地路径不存在: ${localPath}`);
@@ -138,20 +138,27 @@ class CloudAppService {
         // 2. 打包本地文件为 ZIP
         const tmpZipPath = path_1.default.join(os_1.default.tmpdir(), `cloudapp-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`);
         const defaultIgnore = ['node_modules/**', '.git/**', '.DS_Store', '**/.DS_Store'];
+        const packStart = Date.now();
         await (0, utils_1.compressToZip)({
             dirPath: localPath,
             outputPath: tmpZipPath,
             ignore: [...defaultIgnore, ...ignore]
         });
+        const zipSize = fs_1.default.statSync(tmpZipPath).size;
+        onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'pack', durationMs: Date.now() - packStart, bytes: zipSize });
         try {
             // 3. 获取上传凭证
+            const credStart = Date.now();
             const cosInfo = await this.describeCosInfo({
                 deployType: params.deployType,
                 serviceName,
                 suffix: '.zip'
             });
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'credential', durationMs: Date.now() - credStart });
             // 4. 读取 ZIP 文件
+            const readStart = Date.now();
             const zipBuffer = fs_1.default.readFileSync(tmpZipPath);
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'read', durationMs: Date.now() - readStart, bytes: zipBuffer.length });
             // 5. 构建请求头
             const headers = {
                 'Content-Type': 'application/zip'
@@ -162,6 +169,7 @@ class CloudAppService {
                 }
             }
             // 6. 使用预签名 URL 上传
+            const putStart = Date.now();
             const response = await (0, http_request_1.fetchStream)(cosInfo.UploadUrl, {
                 method: 'PUT',
                 body: zipBuffer,
@@ -178,6 +186,7 @@ class CloudAppService {
                 }
                 throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
             }
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'upload', durationMs: Date.now() - putStart, bytes: zipBuffer.length });
             // 7. 返回结果（返回 cosTimestamp，用于创建应用）
             return {
                 cosTimestamp: cosInfo.UnixTimestamp,

package/lib/cloudrun/index.js

@@ -88,6 +88,19 @@ class CloudRunService {
             throw new Error(`云托管代码下载地址为空（请求ID: ${cloudBaseBuildServiceRes.RequestId}）`);
         }
     }
+    /**
+     * 查询服务管理任务信息
+     * @param {Object} params 查询参数
+     * @param {string} params.serverName 服务名
+     * @param {number} [params.taskId=0] 任务 ID，传 0 表示查询该服务当前最新的任务
+     * @param {string} [params.operatorRemark] 操作标识
+     * @returns {Promise<{ IsExist?: boolean; Task?: IServerManageTaskInfo; RequestId?: string }>} 任务是否存在及任务信息
+     */
+    async describeServerManageTask(params) {
+        var _a;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        return this.tcbrService.request('DescribeServerManageTask', Object.assign({ EnvId: envConfig.EnvId, ServerName: params.serverName, TaskId: (_a = params.taskId) !== null && _a !== void 0 ? _a : 0 }, (params.operatorRemark ? { OperatorRemark: params.operatorRemark } : {})));
+    }
     /**
      * 获取云托管服务列表
      * @param {Object} [params] 查询参数
@@ -197,6 +210,78 @@ class CloudRunService {
             OperateType: 'go_back',
         });
     }
+    /**
+     * 回滚版本（SubmitServerRollback）
+     * @param {ISubmitServerRollbackParams} params 回滚参数（服务名、当前版本名、目标回滚版本名）
+     * @returns {Promise<ISubmitServerRollbackResponse>} 返回任务 ID 和请求 ID
+     */
+    async submitServerRollback(params) {
+        var _a, _b, _c, _d;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const serverName = (_a = params === null || params === void 0 ? void 0 : params.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
+        const currentVersionName = (_b = params === null || params === void 0 ? void 0 : params.CurrentVersionName) === null || _b === void 0 ? void 0 : _b.trim();
+        const rollbackVersionName = (_c = params === null || params === void 0 ? void 0 : params.RollbackVersionName) === null || _c === void 0 ? void 0 : _c.trim();
+        const operatorRemark = (_d = params === null || params === void 0 ? void 0 : params.OperatorRemark) === null || _d === void 0 ? void 0 : _d.trim();
+        if (!serverName) {
+            throw new Error('Missing required parameters: ServerName');
+        }
+        if (!currentVersionName) {
+            throw new Error('Missing required parameters: CurrentVersionName');
+        }
+        if (!rollbackVersionName) {
+            throw new Error('Missing required parameters: RollbackVersionName');
+        }
+        return this.tcbrService.request('SubmitServerRollback', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName, CurrentVersionName: currentVersionName, RollbackVersionName: rollbackVersionName }, (operatorRemark ? { OperatorRemark: operatorRemark } : {})));
+    }
+    /**
+     * 批量删除版本
+     * @param {IDeleteCloudRunVersionsParams} params 删除参数
+     * @returns {Promise<IDeleteCloudRunVersionsResponse>} 删除结果
+     */
+    async deleteCloudRunVersions(params) {
+        var _a;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const operatorRemark = (_a = params === null || params === void 0 ? void 0 : params.OperatorRemark) === null || _a === void 0 ? void 0 : _a.trim();
+        if (!Array.isArray(params === null || params === void 0 ? void 0 : params.SimpleVersions) || params.SimpleVersions.length === 0) {
+            throw new Error('Missing required parameters: SimpleVersions');
+        }
+        const simpleVersions = params.SimpleVersions.map((item, index) => {
+            var _a, _b, _c;
+            const serverName = (_a = item === null || item === void 0 ? void 0 : item.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
+            const versionName = (_b = item === null || item === void 0 ? void 0 : item.VersionName) === null || _b === void 0 ? void 0 : _b.trim();
+            if (!serverName) {
+                throw new Error(`Invalid SimpleVersions[${index}].ServerName`);
+            }
+            if (!versionName) {
+                throw new Error(`Invalid SimpleVersions[${index}].VersionName`);
+            }
+            return {
+                EnvId: ((_c = item === null || item === void 0 ? void 0 : item.EnvId) === null || _c === void 0 ? void 0 : _c.trim()) || envConfig.EnvId,
+                ServerName: serverName,
+                VersionName: versionName
+            };
+        });
+        return this.tcbrService.request('DeleteCloudRunVersions', Object.assign({ EnvId: envConfig.EnvId, IsDeleteServer: params.IsDeleteServer, IsDeleteImage: params.IsDeleteImage, SimpleVersions: simpleVersions }, (operatorRemark ? { OperatorRemark: operatorRemark } : {})));
+    }
+    /**
+     * 查询版本详情
+     * @param {IDescribeVersionDetailParams} params 查询参数（服务名、版本名、可选渠道）
+     * @returns {Promise<IDescribeVersionDetailResponse>} 版本详情
+     */
+    async describeVersionDetail(params) {
+        var _a, _b, _c;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const serverName = (_a = params === null || params === void 0 ? void 0 : params.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
+        const versionName = (_b = params === null || params === void 0 ? void 0 : params.VersionName) === null || _b === void 0 ? void 0 : _b.trim();
+        const channel = (_c = params === null || params === void 0 ? void 0 : params.Channel) === null || _c === void 0 ? void 0 : _c.trim();
+        if (!serverName) {
+            throw new Error('Missing required parameters: ServerName');
+        }
+        if (!versionName) {
+            throw new Error('Missing required parameters: VersionName');
+        }
+        return this.tcbrService.request('DescribeVersionDetail', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName, VersionName: versionName }, (channel ? { Channel: channel } : {})));
+    }
     /**
      *查询云托管服务详情
      * @param {Object} params 查询参数
@@ -433,6 +518,9 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "download", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "describeServerManageTask", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "list", null);
@@ -445,6 +533,15 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "rollback", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "submitServerRollback", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "deleteCloudRunVersions", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "describeVersionDetail", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "detail", null);

package/lib/index.js

@@ -64,6 +64,10 @@ class CloudBase {
     get hosting() {
         return this.currentEnvironment().getHostingService();
     }
+    /**
+     * HTTP Service（CloudBaseGW）访问服务
+     * @deprecated 自 v5.0.0 起 HTTP Service 模块已废弃，请改用 env 下的域名与路由相关 API。
+     */
     get access() {
         return this.currentEnvironment().getAccessService();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "5.6.5",
+    "version": "5.6.7",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/access/index.d.ts

@@ -1,6 +1,11 @@
 import { Environment } from '../environment';
 import { ICreateAccessOptions, IApi, IUpdateOptions, IService, IDeleteOptions, IGetOptions, IDomainOptions } from './types';
 import { IResponseInfo } from '../interfaces';
+/**
+ * HTTP Service（CloudBaseGW）访问服务。
+ * 注意：HTTP Service 模块自 v5.0.0 起已废弃，建议迁移到 EnvService 的域名与路由能力
+ * （如 createHttpServiceRoute / modifyHttpServiceRoute / deleteHttpServiceRoute）。
+ */
 export declare class AccessService {
     private tcbService;
     private environment;

package/types/cloudApp/types.d.ts

@@ -299,6 +299,21 @@ export interface IProgressData {
     total: number;
     percent: number;
 }
+/**
+ * 代码上传的分步阶段
+ */
+export type UploadPhase = 'pack' | 'credential' | 'read' | 'upload';
+/**
+ * 单个阶段计时信息（由 uploadCode 的 onPhase 回调触发）
+ */
+export interface IUploadPhaseTiming {
+    /** 阶段名 */
+    phase: UploadPhase;
+    /** 耗时(ms) */
+    durationMs: number;
+    /** 字节数（pack: zip 大小; read/upload: buffer 大小） */
+    bytes?: number;
+}
 /**
  * 上传代码参数
  */
@@ -313,6 +328,8 @@ export interface IUploadCloudAppCodeParams {
     ignore?: string[];
     /** 进度回调 */
     onProgress?: (progress: IProgressData) => void;
+    /** 分步计时回调（各阶段完成时触发，用于 verbose 模式输出耗时） */
+    onPhase?: (timing: IUploadPhaseTiming) => void;
 }
 /**
  * 上传代码结果

package/types/cloudrun/index.d.ts

@@ -1,6 +1,6 @@
 import { Environment } from '../environment';
 import { IResponseInfo } from '../interfaces';
-import { CloudrunServerType, ICloudrunDetailResponse, ICloudrunListResponse, ICloudrunServerBaseConfig, ICreateVpcInfo, IBuildLogResponse, IProcessLogResponse, IDiffConfigItem, ITemplate, ReleaseTypeEnum, IDescribeCloudRunDeployRecordResponse } from './type';
+import { CloudrunServerType, ICloudrunDetailResponse, ICloudrunListResponse, ICloudrunServerBaseConfig, ICreateVpcInfo, IBuildLogResponse, IProcessLogResponse, IDiffConfigItem, ITemplate, ReleaseTypeEnum, IServerManageTaskInfo, IDescribeCloudRunDeployRecordResponse, IDescribeVersionDetailParams, IDescribeVersionDetailResponse, ISubmitServerRollbackParams, ISubmitServerRollbackResponse, IDeleteCloudRunVersionsParams, IDeleteCloudRunVersionsResponse } from './type';
 /**
  * 云托管服务管理类
  * 提供云托管服务的初始化、下载、列表查询和删除等功能
@@ -41,6 +41,23 @@ export declare class CloudRunService {
         serverName: string;
         targetPath: string;
     }): Promise<void>;
+    /**
+     * 查询服务管理任务信息
+     * @param {Object} params 查询参数
+     * @param {string} params.serverName 服务名
+     * @param {number} [params.taskId=0] 任务 ID，传 0 表示查询该服务当前最新的任务
+     * @param {string} [params.operatorRemark] 操作标识
+     * @returns {Promise<{ IsExist?: boolean; Task?: IServerManageTaskInfo; RequestId?: string }>} 任务是否存在及任务信息
+     */
+    describeServerManageTask(params: {
+        serverName: string;
+        taskId?: number;
+        operatorRemark?: string;
+    }): Promise<{
+        IsExist?: boolean;
+        Task?: IServerManageTaskInfo;
+        RequestId?: string;
+    }>;
     /**
      * 获取云托管服务列表
      * @param {Object} [params] 查询参数
@@ -82,6 +99,24 @@ export declare class CloudRunService {
     rollback(serverName: string): Promise<{
         RequestId?: string;
     }>;
+    /**
+     * 回滚版本（SubmitServerRollback）
+     * @param {ISubmitServerRollbackParams} params 回滚参数（服务名、当前版本名、目标回滚版本名）
+     * @returns {Promise<ISubmitServerRollbackResponse>} 返回任务 ID 和请求 ID
+     */
+    submitServerRollback(params: ISubmitServerRollbackParams): Promise<ISubmitServerRollbackResponse>;
+    /**
+     * 批量删除版本
+     * @param {IDeleteCloudRunVersionsParams} params 删除参数
+     * @returns {Promise<IDeleteCloudRunVersionsResponse>} 删除结果
+     */
+    deleteCloudRunVersions(params: IDeleteCloudRunVersionsParams): Promise<IDeleteCloudRunVersionsResponse>;
+    /**
+     * 查询版本详情
+     * @param {IDescribeVersionDetailParams} params 查询参数（服务名、版本名、可选渠道）
+     * @returns {Promise<IDescribeVersionDetailResponse>} 版本详情
+     */
+    describeVersionDetail(params: IDescribeVersionDetailParams): Promise<IDescribeVersionDetailResponse>;
     /**
      *查询云托管服务详情
      * @param {Object} params 查询参数

package/types/cloudrun/type.d.ts

@@ -426,6 +426,136 @@ export interface IReleaseOrderInfo {
     CreateTime?: string;
     IsReleasing?: boolean;
 }
+/**
+ * DescribeVersionDetail 请求参数
+ */
+export interface IDescribeVersionDetailParams {
+    /** 服务名 */
+    ServerName: string;
+    /** 版本名 */
+    VersionName: string;
+    /** 可选渠道 */
+    Channel?: string;
+}
+/**
+ * BuildPacksInfo（CreateCloudRunServer / DescribeVersionDetail / UpdateCloudRunServer）
+ */
+export interface IBuildPacksInfo {
+    /** 基础镜像 */
+    BaseImage: string;
+    /** 启动命令 */
+    EntryPoint: string;
+    /** 语言 */
+    RepoLanguage: string;
+    /** 上传文件名 */
+    UploadFilename: string;
+    /** 语言版本 */
+    LanguageVersion?: string;
+}
+/**
+ * DescribeVersionDetail 响应
+ */
+export interface IDescribeVersionDetailResponse {
+    Name: string;
+    Port: number;
+    Cpu: number;
+    Mem: number;
+    MinNum: number;
+    MaxNum: number;
+    PolicyDetails: ICloudrunHpaPolicy[];
+    Dockerfile: string;
+    BuildDir: string;
+    EnvParams: string;
+    Status: string;
+    CreatedTime: string;
+    UpdatedTime: string;
+    LogPath: string;
+    EntryPoint: string | null;
+    Cmd: string | null;
+    VpcConf: IVpcConf | null;
+    VolumesConf: IVolumeConf[] | null;
+    BuildPacks: IBuildPacksInfo | null;
+    RequestId: string;
+}
+/**
+ * SubmitServerRollback 请求参数
+ */
+export interface ISubmitServerRollbackParams {
+    /** 服务名 */
+    ServerName: string;
+    /** 当前版本名 */
+    CurrentVersionName: string;
+    /** 目标回滚版本名 */
+    RollbackVersionName: string;
+    /** 操作标识 */
+    OperatorRemark?: string;
+}
+/**
+ * SubmitServerRollback 响应
+ */
+export interface ISubmitServerRollbackResponse {
+    /** 任务 ID */
+    TaskId: number;
+    /** 请求 ID */
+    RequestId: string;
+}
+/**
+ * DeleteCloudRunVersions 版本信息
+ */
+export interface ISimpleVersion {
+    /** 环境 ID（可选，不传时由 SDK 自动注入当前环境） */
+    EnvId?: string;
+    /** 服务名 */
+    ServerName: string;
+    /** 版本名 */
+    VersionName: string;
+}
+/**
+ * DeleteCloudRunVersions 请求参数
+ */
+export interface IDeleteCloudRunVersionsParams {
+    /** 是否删除服务（仅最后一个版本时生效） */
+    IsDeleteServer: boolean;
+    /** 是否删除镜像（仅删除服务时生效） */
+    IsDeleteImage: boolean;
+    /** 待删除版本列表 */
+    SimpleVersions: ISimpleVersion[];
+    /** 操作标识 */
+    OperatorRemark?: string;
+}
+/**
+ * FailDeleteVersions（删除失败版本信息）
+ */
+export interface IFailDeleteVersions {
+    /** 删除失败版本信息 */
+    Version: ISimpleVersion;
+    /** 删除失败错误码 */
+    ErrorCode: number;
+    /** 删除失败错误信息 */
+    ErrorMsg: string;
+    /** 删除操作 RequestId */
+    RequestId: string;
+}
+/**
+ * SuccessDeleteVersions（删除成功的版本信息）
+ */
+export interface ISuccessDeleteVersions {
+    /** 版本简化信息 */
+    Version: ISimpleVersion;
+    /** 删除版本的 RequestId */
+    RequestId: string;
+    /** 删除版本结果 */
+    Result: string;
+}
+/**
+ * DeleteCloudRunVersions 响应
+ */
+export interface IDeleteCloudRunVersionsResponse {
+    Result: 'succ' | 'fail' | 'partial' | string;
+    FailVersions: IFailDeleteVersions[];
+    SuccessVersions: ISuccessDeleteVersions[];
+    RequestId: string;
+}
 /**
  * DescribeCloudRunDeployRecord 单条部署记录
  */

package/types/index.d.ts

@@ -56,6 +56,10 @@ declare class CloudBase {
     get storage(): StorageService;
     get database(): DatabaseService;
     get hosting(): HostingService;
+    /**
+     * HTTP Service（CloudBaseGW）访问服务
+     * @deprecated 自 v5.0.0 起 HTTP Service 模块已废弃，请改用 env 下的域名与路由相关 API。
+     */
     get access(): AccessService;
     get mysql(): MysqlService;
     /**