@cloudbase/cli 1.12.0 → 1.12.1-beta

package/src/commands/functions/version/index.ts

@@ -0,0 +1,2 @@
+export * from './publish'
+export * from './list'

package/src/commands/functions/version/list.ts

@@ -0,0 +1,73 @@
+
+import { Command, ICommand } from '../../common'
+import { CloudBaseError } from '../../../error'
+import { loadingFactory, printHorizontalTable } from '../../../utils'
+import { listFunctionVersions } from '../../../function'
+import { InjectParams, CmdContext, ArgsParams, ArgsOptions } from '../../../decorators'
+import { StatusMap } from '../../../constant'
+
+
+@ICommand()
+export class ListFunctionVersion extends Command {
+    get options() {
+        return {
+            cmd: 'fn',
+            childCmd: 'list-function-versions <name>',
+            options: [
+                {
+                    flags: '-e, --envId <envId>',
+                    desc: '环境 Id'
+                },
+                { flags: '-l, --limit <limit>', desc: '返回数据长度，默认值为 20' },
+                {
+                    flags: '-o, --offset <offset>',
+                    desc: '数据偏移量，默认值为 0'
+                }
+            ],
+            desc: '展示函数版本列表'
+        }
+    }
+
+    @InjectParams()
+    async execute(@CmdContext() ctx, @ArgsParams() params, @ArgsOptions() options) {
+        const name = params?.[0]
+        let { limit = 20, offset = 0 } = options
+        limit = Number(limit)
+        offset = Number(offset)
+        if (!Number.isInteger(limit) || !Number.isInteger(offset)) {
+            throw new CloudBaseError('limit 和 offset 必须为整数')
+        }
+
+        if (limit < 0 || offset < 0) {
+            throw new CloudBaseError('limit 和 offset 必须为大于 0 的整数')
+        }
+
+        const {
+            envId
+        } = ctx
+
+        const loading = loadingFactory()
+        loading.start(`拉取函数 [${name}] 版本列表中...`)
+
+        const res = await listFunctionVersions({
+            envId,
+            functionName: name,
+            offset,
+            limit
+        })
+
+        loading.stop()
+
+        const head: string[] = ['版本', '描述', '创建时间', '修改时间', '状态']
+
+        const tableData = res.Versions.map((item) => [
+            item.Version,
+            item.Description,
+            item.AddTime,
+            item.ModTime,
+            StatusMap[item.Status]
+        ])
+
+        printHorizontalTable(head, tableData)
+    }
+}

package/src/commands/functions/version/publish.ts

@@ -0,0 +1,43 @@
+
+import { Command, ICommand } from '../../common'
+import { CloudBaseError } from '../../../error'
+import { loadingFactory } from '../../../utils'
+import { publishVersion } from '../../../function'
+import { InjectParams, CmdContext, ArgsParams } from '../../../decorators'
+
+@ICommand()
+export class PublishFunctionVersion extends Command {
+    get options() {
+        return {
+            cmd: 'fn',
+            childCmd: 'publish-version <name> [description]',
+            options: [
+                {
+                    flags: '-e, --envId <envId>',
+                    desc: '环境 Id'
+                }
+            ],
+            desc: '发布函数新版本'
+        }
+    }
+
+    @InjectParams()
+    async execute(@CmdContext() ctx, @ArgsParams() params) {
+        const name = params?.[0]
+        const description = params?.[1]
+        const {
+            envId
+        } = ctx
+
+        const loading = loadingFactory()
+        loading.start(`发布函数 [${name}] 新版本中...`)
+
+        await publishVersion({
+            envId,
+            functionName: name,
+            description
+        })
+
+        loading.succeed(`发布函数 [${name}] 新版本成功！`)
+    }
+}

package/src/constant.ts

@@ -68,6 +68,12 @@ export const ALL_COMMANDS = [
     'fn trigger create',
     'fn trigger delete',
     'fn invoke',
+    'fn publish-version',
+    'fn list-function-versions',
+    'fn put-provisioned-concurrency',
+    'fn get-provisioned-concurrency',
+    'fn delete-provisioned-concurrency',
+    'fn config-route',
     'functions run',
     'storage upload',
     'storage download',
@@ -94,3 +100,21 @@ export const ALL_COMMANDS = [
     'run standalonegateway turn on',
     'run standalonegateway turn off',
 ]
+
+export const StatusMap = {
+    Active: '部署完成',
+    Creating: '创建中',
+    CreateFailed: '创建失败',
+    Updating: '更新中',
+    UpdateFailed: '更新失败',
+    Publishing: '函数版本发布中',
+    PublishFailed: '函数版本发布失败',
+    Deleting: '函数删除中',
+    DeleteFailed: '函数删除失败'
+}
+
+export const ConcurrencyTaskStatus = {
+    Done: '已完成',
+    InProgress: '进行中',
+    Failed: '失败'
+}

package/src/function/alias.ts

@@ -0,0 +1,43 @@
+import { CloudBaseError } from '../error'
+import { IUpdateFunctionAliasConfig, IGetFunctionAlias, IGetFunctionAliasRes } from '../types'
+import { getFunctionService } from './base'
+
+// 设置函数流量配置信息（ALIAS 配置）
+export async function setFunctionAliasConfig(options: IUpdateFunctionAliasConfig) {
+    const { envId, functionName, name, functionVersion, description, routingConfig } = options
+
+    const scfService = await getFunctionService(envId)
+
+    try {
+        await scfService.updateFunctionAliasConfig({
+            functionName,
+            name,
+            functionVersion,
+            description,
+            routingConfig
+        })
+    } catch (e) {
+        throw new CloudBaseError(`[${functionName}] 设置函数流量配置失败： ${e.message}`, {
+            code: e.code
+        })
+    }
+}
+
+// 查询函数别名配置信息
+export async function getFunctionAliasConfig(options: IGetFunctionAlias): Promise<IGetFunctionAliasRes> {
+    const { envId, functionName, name } = options
+
+    const scfService = await getFunctionService(envId)
+
+    try {
+        return scfService.getFunctionAlias({
+            functionName,
+            name
+        })
+    } catch (e) {
+        throw new CloudBaseError(`[${functionName}] 查询函数别名配置失败： ${e.message}`, {
+            code: e.code
+        })
+    }
+}
+

package/src/function/concurrency.ts

@@ -0,0 +1,57 @@
+import { CloudBaseError } from '../error'
+import { ISetProvisionedConcurrencyConfig, IGetProvisionedConcurrencyConfig, IGetProvisionedConcurrencyRes, IFunctionVersionsRes } from '../types'
+import { getFunctionService } from './base'
+
+// 设置函数预置并发
+export async function setProvisionedConcurrencyConfig(options: ISetProvisionedConcurrencyConfig) {
+    const { envId, functionName, qualifier, versionProvisionedConcurrencyNum } = options
+
+    const scfService = await getFunctionService(envId)
+
+    try {
+        await scfService.setProvisionedConcurrencyConfig({
+            functionName,
+            qualifier,
+            versionProvisionedConcurrencyNum
+        })
+    } catch (e) {
+        throw new CloudBaseError(`[${functionName}] 设置函数预置并发失败： ${e.message}`, {
+            code: e.code
+        })
+    }
+}
+
+// 查看函数预置并发
+export async function getProvisionedConcurrencyConfig(options: IGetProvisionedConcurrencyConfig): Promise<IGetProvisionedConcurrencyRes> {
+    const { envId, functionName, qualifier } = options
+    const scfService = await getFunctionService(envId)
+
+    try {
+        return scfService.getProvisionedConcurrencyConfig({
+            functionName,
+            qualifier,
+        })
+    } catch (e) {
+        throw new CloudBaseError(`[${functionName}] 查看函数预置并发信息失败： ${e.message}`, {
+            code: e.code
+        })
+    }
+}
+
+// 删除函数预置并发
+export async function deleteProvisionedConcurrencyConfig(options: IGetProvisionedConcurrencyConfig): Promise<void> {
+    const { envId, functionName, qualifier } = options
+    const scfService = await getFunctionService(envId)
+
+    try {
+        await scfService.deleteProvisionedConcurrencyConfig({
+            functionName,
+            qualifier
+        })
+    } catch (e) {
+        throw new CloudBaseError(`[${functionName}] 删除函数预置并发失败： ${e.message}`, {
+            code: e.code
+        })
+    }
+}
+

package/src/function/index.ts

@@ -5,4 +5,7 @@ export * from './base'
 export * from './delete'
 export * from './update'
 export * from './layer'
-export * from './vpc'
+export * from './vpc'
+export * from './version'
+export * from './concurrency'
+export * from './alias'

package/src/function/version.ts

@@ -0,0 +1,39 @@
+import { CloudBaseError } from '../error'
+import { IPublishVersionParams, IListFunctionVersionParams, IFunctionVersionsRes } from '../types'
+import { getFunctionService } from './base'
+
+// 发布云函数新版本
+export async function publishVersion(options: IPublishVersionParams) {
+    const { envId, functionName, description = '' } = options
+
+    const scfService = await getFunctionService(envId)
+
+    try {
+        await scfService.publishVersion({
+            functionName,
+            description
+        })
+    } catch (e) {
+        throw new CloudBaseError(`[${functionName}] 函数发布新版本失败： ${e.message}`, {
+            code: e.code
+        })
+    }
+}
+
+// 查看函数所有版本
+export async function listFunctionVersions(options: IListFunctionVersionParams): Promise<IFunctionVersionsRes> {
+    const { envId, functionName, offset = 0, limit = 20 } = options
+    const scfService = await getFunctionService(envId)
+
+    try {
+        return scfService.listVersionByFunction({
+            functionName,
+            offset,
+            limit
+        })
+    } catch (e) {
+        throw new CloudBaseError(`[${functionName}] 查看寒函数版本列表失败： ${e.message}`, {
+            code: e.code
+        })
+    }
+}

package/src/types.ts

@@ -435,4 +435,99 @@ export interface ITurnOffStandaloneGateway {
 export interface IDestroyStandaloneGateway {
     envId: string,
     gatewayName: string
+}
+
+export interface IPublishVersionParams {
+    envId: string
+    functionName: string
+    description?: string
+}
+export interface IListFunctionVersionParams {
+    envId: string
+    functionName: string
+    offset?: number
+    limit?: number
+    order?: string
+    orderBy?: string
+}
+
+export interface IFunctionVersion {
+    Version: string
+    Description: string
+    AddTime: string
+    ModTime: string
+    Status: string //
+}
+
+export interface IFunctionVersionsRes {
+    FunctionVersion: string[]
+    Versions: IFunctionVersion[]
+    TotalCount: number
+}
+
+export interface ISetProvisionedConcurrencyConfig {
+    envId: string
+    functionName: string
+    qualifier: string
+    versionProvisionedConcurrencyNum: number
+}
+
+export interface IGetProvisionedConcurrencyConfig {
+    functionName: string
+    qualifier?: string
+    envId: string
+}
+
+export interface IGetProvisionedConcurrencyRes {
+    UnallocatedConcurrencyNum: number
+    Allocated: IVersionProvisionedConcurrencyInfo[]
+}
+
+export interface IVersionProvisionedConcurrencyInfo {
+    AllocatedProvisionedConcurrencyNum: number // 设置的预置并发数。
+    AvailableProvisionedConcurrencyNum: number // 当前已完成预置的并发数。
+    Status: string // 预置任务状态，Done表示已完成，InProgress表示进行中，Failed表示部分或全部失败。
+    StatusReason: string // 对预置任务状态Status的说明。
+    Qualifier: string // 版本号
+}
+
+export interface IUpdateFunctionAliasConfig {
+    envId: string
+    functionName: string // 函数名
+    name: string // 函数别名 如$DEFAULT
+    functionVersion: string // 函数版本
+    description?: string // 别名描述
+    routingConfig?: IRoutingConfig
+}
+
+export interface IRoutingConfig {
+    AdditionalVersionWeights?: IVersionWeight[]
+    AddtionVersionMatchs?: IVersionMatch[]
+}
+
+export interface IVersionMatch {
+    Version: string // 函数版本名称
+    Key: string // 匹配规则的key，调用时通过传key来匹配规则路由到指定版本 header方式：key填写"invoke.headers.User"，并在 invoke 调用函数时传参 RoutingKey：{"User":"value"}规则匹配调用
+    Method: string // 匹配方式。取值范围：range：范围匹配 exact：字符串精确匹配
+    Expression: string //
+}
+
+export interface IVersionWeight {
+    Version: string
+    Weight: number
+}
+
+export interface IGetFunctionAlias {
+    envId: string
+    functionName: string // 函数名称
+    name: string // 别名
+}
+
+export interface IGetFunctionAliasRes {
+    FunctionVersion: string
+    Name: string
+    RoutingConfig: IRoutingConfig
+    Description: string
+    AddTime: string
+    ModTime: string
 }

package/types/commands/functions/alias/getRoute.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '../../common';
+export declare class getFunctionRoutingConfig extends Command {
+    get options(): {
+        cmd: string;
+        childCmd: string;
+        options: {
+            flags: string;
+            desc: string;
+        }[];
+        desc: string;
+    };
+    execute(ctx: any, params: any): Promise<void>;
+}

package/types/commands/functions/alias/index.d.ts

@@ -0,0 +1,2 @@
+export * from './setRoute';
+export * from './getRoute';

package/types/commands/functions/alias/setRoute.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '../../common';
+export declare class setFunctionRoutingConfig extends Command {
+    get options(): {
+        cmd: string;
+        childCmd: string;
+        options: {
+            flags: string;
+            desc: string;
+        }[];
+        desc: string;
+    };
+    execute(ctx: any, params: any): Promise<void>;
+}

package/types/commands/functions/concurrency/delete.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '../../common';
+export declare class deleteProvisionedConcurrency extends Command {
+    get options(): {
+        cmd: string;
+        childCmd: string;
+        options: {
+            flags: string;
+            desc: string;
+        }[];
+        desc: string;
+    };
+    execute(ctx: any, params: any): Promise<void>;
+}

package/types/commands/functions/concurrency/index.d.ts

@@ -0,0 +1,3 @@
+export * from './delete';
+export * from './list';
+export * from './set';

package/types/commands/functions/concurrency/list.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '../../common';
+export declare class getProvisionedConcurrency extends Command {
+    get options(): {
+        cmd: string;
+        childCmd: string;
+        options: {
+            flags: string;
+            desc: string;
+        }[];
+        desc: string;
+    };
+    execute(ctx: any, params: any, options: any): Promise<void>;
+}

package/types/commands/functions/concurrency/set.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '../../common';
+export declare class setProvisionedConcurrency extends Command {
+    get options(): {
+        cmd: string;
+        childCmd: string;
+        options: {
+            flags: string;
+            desc: string;
+        }[];
+        desc: string;
+    };
+    execute(ctx: any, params: any): Promise<void>;
+}

package/types/commands/functions/index.d.ts

@@ -11,3 +11,6 @@ export * from './trigger-create';
 export * from './trigger-delete';
 export * from './code-update';
 export * from './code-download';
+export * from './version';
+export * from './concurrency';
+export * from './alias';

package/types/commands/functions/version/index.d.ts

@@ -0,0 +1,2 @@
+export * from './publish';
+export * from './list';

package/types/commands/functions/version/list.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '../../common';
+export declare class ListFunctionVersion extends Command {
+    get options(): {
+        cmd: string;
+        childCmd: string;
+        options: {
+            flags: string;
+            desc: string;
+        }[];
+        desc: string;
+    };
+    execute(ctx: any, params: any, options: any): Promise<void>;
+}

package/types/commands/functions/version/publish.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '../../common';
+export declare class PublishFunctionVersion extends Command {
+    get options(): {
+        cmd: string;
+        childCmd: string;
+        options: {
+            flags: string;
+            desc: string;
+        }[];
+        desc: string;
+    };
+    execute(ctx: any, params: any): Promise<void>;
+}

package/types/constant.d.ts

@@ -29,3 +29,19 @@ export declare const STATUS_TEXT: {
     ERROR: string;
 };
 export declare const ALL_COMMANDS: string[];
+export declare const StatusMap: {
+    Active: string;
+    Creating: string;
+    CreateFailed: string;
+    Updating: string;
+    UpdateFailed: string;
+    Publishing: string;
+    PublishFailed: string;
+    Deleting: string;
+    DeleteFailed: string;
+};
+export declare const ConcurrencyTaskStatus: {
+    Done: string;
+    InProgress: string;
+    Failed: string;
+};

package/types/function/alias.d.ts

@@ -0,0 +1,3 @@
+import { IUpdateFunctionAliasConfig, IGetFunctionAlias, IGetFunctionAliasRes } from '../types';
+export declare function setFunctionAliasConfig(options: IUpdateFunctionAliasConfig): Promise<void>;
+export declare function getFunctionAliasConfig(options: IGetFunctionAlias): Promise<IGetFunctionAliasRes>;

package/types/function/concurrency.d.ts

@@ -0,0 +1,4 @@
+import { ISetProvisionedConcurrencyConfig, IGetProvisionedConcurrencyConfig, IGetProvisionedConcurrencyRes } from '../types';
+export declare function setProvisionedConcurrencyConfig(options: ISetProvisionedConcurrencyConfig): Promise<void>;
+export declare function getProvisionedConcurrencyConfig(options: IGetProvisionedConcurrencyConfig): Promise<IGetProvisionedConcurrencyRes>;
+export declare function deleteProvisionedConcurrencyConfig(options: IGetProvisionedConcurrencyConfig): Promise<void>;

package/types/function/index.d.ts

@@ -6,3 +6,6 @@ export * from './delete';
 export * from './update';
 export * from './layer';
 export * from './vpc';
+export * from './version';
+export * from './concurrency';
+export * from './alias';

package/types/function/version.d.ts

@@ -0,0 +1,3 @@
+import { IPublishVersionParams, IListFunctionVersionParams, IFunctionVersionsRes } from '../types';
+export declare function publishVersion(options: IPublishVersionParams): Promise<void>;
+export declare function listFunctionVersions(options: IListFunctionVersionParams): Promise<IFunctionVersionsRes>;

package/types/types.d.ts

@@ -376,3 +376,85 @@ export interface IDestroyStandaloneGateway {
     envId: string;
     gatewayName: string;
 }
+export interface IPublishVersionParams {
+    envId: string;
+    functionName: string;
+    description?: string;
+}
+export interface IListFunctionVersionParams {
+    envId: string;
+    functionName: string;
+    offset?: number;
+    limit?: number;
+    order?: string;
+    orderBy?: string;
+}
+export interface IFunctionVersion {
+    Version: string;
+    Description: string;
+    AddTime: string;
+    ModTime: string;
+    Status: string;
+}
+export interface IFunctionVersionsRes {
+    FunctionVersion: string[];
+    Versions: IFunctionVersion[];
+    TotalCount: number;
+}
+export interface ISetProvisionedConcurrencyConfig {
+    envId: string;
+    functionName: string;
+    qualifier: string;
+    versionProvisionedConcurrencyNum: number;
+}
+export interface IGetProvisionedConcurrencyConfig {
+    functionName: string;
+    qualifier?: string;
+    envId: string;
+}
+export interface IGetProvisionedConcurrencyRes {
+    UnallocatedConcurrencyNum: number;
+    Allocated: IVersionProvisionedConcurrencyInfo[];
+}
+export interface IVersionProvisionedConcurrencyInfo {
+    AllocatedProvisionedConcurrencyNum: number;
+    AvailableProvisionedConcurrencyNum: number;
+    Status: string;
+    StatusReason: string;
+    Qualifier: string;
+}
+export interface IUpdateFunctionAliasConfig {
+    envId: string;
+    functionName: string;
+    name: string;
+    functionVersion: string;
+    description?: string;
+    routingConfig?: IRoutingConfig;
+}
+export interface IRoutingConfig {
+    AdditionalVersionWeights?: IVersionWeight[];
+    AddtionVersionMatchs?: IVersionMatch[];
+}
+export interface IVersionMatch {
+    Version: string;
+    Key: string;
+    Method: string;
+    Expression: string;
+}
+export interface IVersionWeight {
+    Version: string;
+    Weight: number;
+}
+export interface IGetFunctionAlias {
+    envId: string;
+    functionName: string;
+    name: string;
+}
+export interface IGetFunctionAliasRes {
+    FunctionVersion: string;
+    Name: string;
+    RoutingConfig: IRoutingConfig;
+    Description: string;
+    AddTime: string;
+    ModTime: string;
+}