ApplyScalingGroup
如果您需要通过配置文件方式快速创建、管理伸缩组,则可以通过调用API ApplyScalingGroup来创建和管理伸缩组
服务地址:
华东1 金融云
输入参数
只看必填
Content配置文件内容
RegionId所属地域的ID
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

ApplyScalingGroup 目前支持 Kubernetes Deployment 资源定义格式快速创建 ECI 伸缩组。同时支持 ECI 对 Kubernetes YAML 拓展 annotation,详情参考《支持 annotation 列表》。

YAML 配置与伸缩组映射关系:通过 YAML 定义中的 namespace、kind、name 三元组映射伸缩组 name。一个 region 下同一个 YAML 配置只能映射同一个伸缩组。示例:如果使用默认 namespace 下 name 为 nginx 的 Deployment YAML 配置,则映射同 region 下名称为 k8s_default_Deployment_nginx 伸缩组。

基于 YAML 配置管理伸缩组逻辑:

  • 当 YAML 配置映射伸缩组存在时,会基于 YAML 配置更新伸缩组;
  • 当 YAML 配置映射伸缩组不存在时,会基于 YAML 配置创建对应伸缩组。

注意事项

  1. 当 YAML 配置未指定专有网络、vSwitch、安全组 annotation 时,系统会自动创建默认 VPC,在该 VPC 下创建默认交换机,以及 ESS 默认安全组 ess-default-sg。其中安全组策略默认开放 TCP 协议的 22、3389 端口以及 ICMP(IPv4)协议,如果用户有其他端口协议需求,可以另行调整安全组策略。
  2. 当使用公网镜像时,需配置开启公网访问能力,设置 k8s.aliyun.com/eci-with-eip pod annotation 开启 eip。
  3. ApplyScalingGroup 应用 YAML 配置后,伸缩组、伸缩配置会立即生效,如果指定 replicas > 0 时,会自动创建资源。

支持的 annotation 列表

annotation 参考自ECI Pod Annotation

参数示例值说明
k8s.aliyun.com/ess-scaling-group-min-size1伸缩组最小值。默认值 0。
k8s.aliyun.com/ess-scaling-group-max-size20伸缩组最大值。默认为 max(replicas, 30)。
k8s.aliyun.com/eci-ntp-server100.100..NTP Server。
k8s.aliyun.com/eci-use-specs2-4Gi2 核 4G 规格配置。更多信息,请参见多规格创建 Pod
k8s.aliyun.com/eci-vswitchvsw-bp1xpiowfm5vo8o3c****指定交换机 ID,支持指定多个交换机实现多可用区功能。
k8s.aliyun.com/eci-security-groupsg-bp1dktddjsg5nktv****指定安全组 ID。要求如下:
  • 支持指定一个或多个安全组,最多可以指定 5 个安全组。
  • 指定的安全组必须属于同一 VPC。
  • 指定的安全组的类型必须相同。
k8s.aliyun.com/eci-sls-enable"false"配置为 false 表示关闭日志采集功能。

通过 SLS CRD 方式采集日志时,如果某些 Pod 不需要采集日志,可配置该 Annotation 来关闭日志采集功能,避免系统自动创建 Logtail 而造成资源浪费。

k8s.aliyun.com/eci-spot-strategySpotAsPriceGo抢占式实例的出价策略。可根据需要配置为:
  • SpotWithPriceLimit:自定义设置抢占实例价格上限。此时必须设置 k8s.aliyun.com/eci-spot-price-limit。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。
k8s.aliyun.com/eci-spot-price-limit"0.5"抢占式实例的每小时价格上限,最多支持精确到小数点后三位。

仅当 k8s.aliyun.com/eci-spot-strategy 设置为 SpotWithPriceLimit 时有效。

k8s.aliyun.com/eci-with-eip"true"配置为 true 表示自动创建并绑定 EIP。
k8s.aliyun.com/eci-data-cache-bucketdefault指定 DataCache 的 Bucket。使用 DataCache 创建 Pod 时必须配置。
k8s.aliyun.com/eci-data-cache-plPL1基于 DataCache 创建的云盘的性能等级。

默认使用 ESSD 云盘,性能等级默认为 PL1。

k8s.aliyun.com/eci-data-cache-provisionedIops"40000"ESSD AutoPL 云盘预配置的读写 IOPS。取值范围:0~min{50000, 1000 * 容量-基准性能}。基准性能=min{1800+50 * 容量, 50000}。更多信息,请参见ESSD AutoPL 云盘

如果添加了该 Annotation,则基于 DataCache 创建的云盘类型为 ESSD AutoPL 云盘。

k8s.aliyun.com/eci-data-cache-burstingEnabled"true"ESSD AutoPL 云盘是否开启 Burst(性能突发)。更多信息,请参见ESSD AutoPL 云盘

如果添加了该 Annotation,则基于 DataCache 创建的云盘类型为 ESSD AutoPL 云盘。

k8s.aliyun.com/eci-custom-tags"env:test,name:alice"绑定的标签(Tag)字符串,最多可以绑定 3 个标签。标签键和标签值之间用半角冒号隔开,多个标签之间用半角逗号隔开。

请求参数

字段名称字段详情
Contentstring

配置文件内容。

示例值:apiVersion: apps/v1 kind: Deployment metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 selector: matchLabels: app: nginx template: metadata: labels: app: nginx annotations: k8s.aliyun.com/eip-bandwidth: 10 k8s.aliyun.com/eci-with-eip: true spec: containers: - name: nginx image: nginx:1.14.2 ports: - containerPort: 80
RegionIdstring

所属地域的 ID。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:CC107349-57B7-4405-B1BF-9BF5AF7F****
ScalingGroupIdstring

生效伸缩组的 ID。

示例值:asg-bp1igpak5ft1flyp****
变更历史
暂无变更历史