Provision 命令

provision 命令是进行函数预留操作的命令;主要包括预留配置的查看与更新等操作。

⚠️ 注意:预留资源会持续产生费用,如果不需要请及时释放资源

命令解析

当执行命令provision -h/provision --help时,可以获取帮助文档。

在该命令中,包括了四个子命令:

provision list 命令

provision list 命令,是查看函数已发布的版本列表的命令。

当执行命令provision list -h/provision list --help时,可以获取帮助文档。

参数解析

参数全称参数缩写Yaml 模式下必填Cli 模式下必填参数含义
region-选填必填地域名称,取值范围参见函数计算开服地域
function-name-选填必填函数名

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s provision list查看当前预留示例列表;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定函数所在地区以及函数名称,例如s cli fc3 provision list --region cn-hangzhou --function-name test-function

上述命令的执行结果示例:

fc3-deploy-test:
  -
    alwaysAllocateCPU:      false
    current:                10
    currentError:
    functionArn:            acs:fc:cn-hangzhou:143**********149:functions/start-python-9fqu
    scheduledActions:       []
    target:                 10
    targetTrackingPolicies: []

provision put 命令

provision put 命令用于配置预留。

当执行命令provision put -h/provision put --help时,可以获取帮助文档。

参数解析

参数全称参数缩写Yaml 模式下必填Cli 模式下必填参数含义
region-选填必填地域名称,取值范围参见函数计算开服地域
function-name-选填必填函数名
qualifier-必填必填配置预留的版本,仅支持 LATEST 和别名
target-必填必填预留实例数量,target 如果大于 0,配置函数预留,预留资源会持续产生费用,如果不需要请及时释放资源;target 如果等于 0,释放预留资源
always-allocate-cpuac选填选填一直给预留实例分配 CPU 资源
scheduled-actions-选填选填配置预留模式的定时修改限制
target-tracking-policies-选填选填配置预留模式的根据指标修改限制

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

其中scheduledActions参数的数据结构为:

参数名类型是否必填示例描述
namestringdemoScheduler定时任务的名称。
startTimestring2020-10-10T10:10:10Z定时伸缩的起始生效时间。
endTimestring2020-12-10T10:10:10Z定时伸缩的结束生效时间。
targetnumber10预留的目标资源个数。
scheduleExpressionstringcron(0 30 8 * * *)定时信息,支持两种格式。
- At expressions - "at(yyyy-mm-ddThh:mm:ss)":只调度一次,使用 UTC 格式。
- Cron expressions - "cron(0 0 20 * * *)":调度多次,使用标准 crontab 格式,如:每天 20:00 进行调度。

其中targetTrackingPolicies参数的数据结构为:

参数名类型是否必填示例描述
namestringdemoScheduler定时任务的名称。
startTimestring2020-10-10T10:10:10Z定时伸缩的起始生效时间。
endTimestring2020-12-10T10:10:10Z定时伸缩的结束生效时间。
metricTypestringProvisionedConcurrencyUtilization追踪的指标类型。
-ProvisionedConcurrencyUtilization:预留模式实例并发度利用率。
- CPUUtilization:CPU 利用率。
- GPUMemUtilization:GPU 利用率。
metricTargetnumber(double)0.6指标的追踪值。
minCapacitynumber10缩容的最小值。
maxCapacitynumber100扩容的最大值。

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s provision put进行版本的发布,例如s provision put --qualifier release --target 10
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定函数所在地区以及函数名称,例如s cli fc3 provision put --region cn-hangzhou --function-name test-function --qualifier LATEST --target 10

上述命令的执行结果示例:

fc3-deploy-test:
  functionArn:            acs:fc:cn-hangzhou:143**********149:functions/start-python-9fqu
  scheduledActions:       []
  target:                 10
  targetTrackingPolicies: []

provision get 命令

provision get 命令,是获取预留实例详情的命令。

当执行命令provision get -h/provision get --help时,可以获取帮助文档。

参数解析

参数全称参数缩写Yaml 模式下必填Cli 模式下必填参数含义
region-选填必填地域名称,取值范围参见函数计算开服地域
function-name-选填必填函数名
qualifier-必填必填配置预留的版本,仅支持 LATEST 和别名

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s provision get --qualifier qualifier获取预留实例详情;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定函数所在地区以及函数名称,例如s cli fc3 provision get --region cn-hangzhou --function-name test-function --qualifier release

上述命令的执行结果示例:

fc3-deploy-test:
  alwaysAllocateCPU:      false
  current:                10
  currentError:
  functionArn:            acs:fc:cn-hangzhou:143**********149:functions/test-function
  scheduledActions:       []
  target:                 10
  targetTrackingPolicies: []

provision remove 命令

provision remove 命令,是用户删除指定预留资源的命令。

当执行命令provision remove -h/provision remove --help时,可以获取帮助文档。

参数解析

参数全称参数缩写Yaml 模式下必填Cli 模式下必填参数含义
region-选填必填地域名称,取值范围参见函数计算开服地域
function-name-选填必填函数名
qualifier-必填必填配置预留的版本,仅支持 LATEST 和别名
assume-yesy选填选填在交互时,默认选择y

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s provision remove --qualifier release删除指定版本的预留配置;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定函数所在地区以及函数名称,例如s cli fc3 provision remove --region cn-hangzhou --function-name test-function --qualifier LATEST

权限与策略说明

  • provision listprovision get 命令所需要的权限策略: AliyunFCReadOnlyAccess

  • provision put 命令所需要的权限策略:

    {
      "Version": "1",
      "Statement": [
        {
          "Action": "fc:PutProvisionConfig",
          "Effect": "Allow",
          "Resource": [
            "acs:fc:{region}:{uid}:functions/{functionName}",
            "acs:fc:{region}:{uid}:functions/{functionName}/*"
          ]
        }
      ]
    }
    
  • provision remove 命令所需要的权限策略: AliyunFCReadOnlyAccess

    {
      "Version": "1",
      "Statement": [
        {
          "Action": "fc:DeleteProvisionConfig",
          "Effect": "Allow",
          "Resource": [
            "acs:fc:{region}:{uid}:functions/{functionName}",
            "acs:fc:{region}:{uid}:functions/{functionName}/*"
          ]
        }
      ]
    }
    
在 GitHub 上编辑本页面 更新时间: Thu, Feb 22, 2024