云应用 安装参数手册

一、表单组件清单

四、描述

地域及可用区选择组件。

五、示例

预览效果

六、属性

七、输出

结果值

八、多选模式

当 multiple: true 时，组件输出对象数组，同时自动生成一组拍平的同级变量（命名规则 ${name}__xxx），可在 Terraform 中直接引用，无需 for 表达式拆解。

示例：

# <package.yaml>args: – name: app_target widget: subnet-select label: 安装网络 – name: replica_zones widget: region-and-zone-select label: 副本可用区 multiple: true optional: true regions: – ${app_target.region} excludeZones: – ${app_target.subnet.zone}

拍平变量说明（name 为组件变量名）：

十、描述

PostgreSQL 售卖可用区选择组件，支持主可用区与备可用区联动选择。

组件数据来源为云数据库 PostgreSQL 的 DescribeZones 接口，仅展示 PostgreSQL 实际售卖的可用区。

注意：RegionAndZoneSelect 的可用区数据来自云服务器（CVM）售卖可用区，与 PostgreSQL 实际售卖的可用区并不一致。创建 PostgreSQL 实例时请使用本组件，避免用户选到 PostgreSQL 不支持的可用区，导致安装失败。

十一、示例

# <package.yaml>args: – name: app_target label: 目标网络 widget: subnet-select # 主可用区 – name: db_primary_zone label: 主可用区 widget: postgres-zone-select mode: primary region: ${app_target.region} description: PostgreSQL 主节点所在可用区 # 备可用区，按主可用区支持的备可用区联动过滤 – name: db_standby_zone label: 备可用区 widget: postgres-zone-select mode: standby region: ${app_target.region} primaryZone: ${db_primary_zone.zone} description: PostgreSQL 备节点所在可用区

在 Terraform 中通过变量获取所选可用区：

resource "tencentcloud_postgresql_instance" "postgresql" { availability_zone = var.db_primary_zone.zone vpc_id = var.app_target.vpc.id subnet_id = var.app_target.subnet.id db_node_set { role = "Primary" zone = var.db_primary_zone.zone } db_node_set { role = "Standby" zone = var.db_standby_zone.zone }}

预览效果：

十二、属性

注意：说明：

注意：mode 为 standby 时，组件会读取主可用区的 StandbyZoneSet，仅展示该主可用区支持搭配的备可用区；未选择主可用区前，该表单项不可用。

十三、输出

结果值

十五、描述

私有网络及子网选择组件。

十六、示例

# <package.yaml>args: – name: subnet widget: subnet-select label: 安装网络 regions: – ap-guangzhou – ap-beijing – ap-shanghai – ap-chongqing

预览效果

十七、属性

十八、输出

结果值

20、描述

安全组选择组件。

21、示例

# <package.yaml>args: – name: subnet widget: subnet-select label: 安装网络 regions: – ap-guangzhou – ap-beijing – ap-shanghai – ap-chongqing – name: app_sg label: 安全组 widget: security-group-select regions: – ${subnet.region}

预览效果

22、属性

23、输出

结果值

25、描述

对象存储桶选择组件。

26、示例

# <package.yaml>args: – name: app_cos widget: cos-bucket-select label: 对象存储 optional: true description: 可以前往 COS 控制台进行设置

预览效果

27、属性

28、输出

结果值

30、描述

CVM 机型选择组件。

31、示例

# <package.yaml>args: – name: subnet widget: subnet-select label: 目标网络 regions: – ap-guangzhou – ap-beijing – ap-shanghai – ap-chongqing – name: cvm_type label: CVM 机型 widget: cvm-instance-type-select zone: ${subnet.subnet.zone} region: ${subnet.region} cpu: [4, 16] memory: [8, 32]

预览效果

32、属性

33、输出

结果值

35、描述

云硬盘选择组件。

36、示例

# <package.yaml>args: – name: cvm_system_disk label: 云硬盘 widget: disk-select usage: system cvmConfig: ${cvm_type}

预览效果

37、属性

38、输出

结果值

40、描述

CVM 镜像选择组件。

41、示例

# <package.yaml>args: – name: app_target label: 目标网络 widget: subnet-select – name: cvm_type label: 云服务器类型 widget: cvm-instance-type-select region: ${app_target.region} zone: ${app_target.subnet.zone} – name: app_cvm_image label: cvm 镜像 widget: image-select region: ${app_target.region} instanceType: ${cvm_type.instance_type} incompleteTips: 请先选择 cvm 机型

预览效果

42、属性

43、输出

结果值

45、描述

私有域名解析选择组件。

46、示例

# <package.yaml>args: – name: app_target label: 目标网络 widget: subnet-select – name: app_privatedns_domain label: 域名解析 widget: privatedns-domain-select description: 私有域解析域名，配置后将通过此域名来提供私有网络环境的服务访问 relatedVpcId: ${app_target.vpc.id} validator: – reg: str: ${app_privatedns_domain.privatedns_sub_domain} exp: "^[a-zA-Z0-9]+(?:[a-zA-Z0-9-]*[a-zA-Z0-9]+)*(?:\\\\.[a-zA-Z0-9]+(?:[a-zA-Z0-9-]*[a-zA-Z0-9]+)*)*$|^[@]{1}$" message: 域名配置不符合规范

预览效果

47、属性

48、输出

结果值

50、描述

SSL 证书选择组件，只支持选择公有云证书。

51、示例

# <package.yaml>args: – name: ssl_certificate label: SSL证书 widget: certificate-select

预览效果

52、属性

53、输出

结果值

55、描述

SSH 密钥对选择组件。

56、示例

# <package.yaml>args: – name: ssh_ak label: ssh 密钥 widget: ssh-key-pairs-select

预览效果

57、属性

58、输出

结果值

60、描述

CIDR 输入框组件。

61、示例

# <package.yaml>args: – name: app_target label: 目标网络 widget: subnet-select – name: cluster_cidr label: 容器网络 CIDR widget: ip-cidr-input description: 创建后不能修改，请做好网络规划，并确保安全组规则放通子网内容器网络和其他资源 region: ${app_target.region} vpcId: ${app_target.vpc.id} cidrType: service

预览效果

62、属性

63、输出

结果值

65、描述

域名输入组件，如果传入 SSL 证书，则限制必须输入和 SSL 证书匹配的域名。

66、示例

# <package.yaml>args: – name: app_certification label: SSL 证书 widget: certificate-select optional: true – name: app_domain label: 域名 widget: domain-input optional: true certId: ${app_certification.certId}

预览效果

67、属性

68、输出

结果值

70、描述

角色绑定权限策略组件，安装应用时如果需要为角色绑定策略，可以使用此组件。

71、示例

# <package.yaml># 为 TKE_QCSRole 角色绑定 QcloudAccessForTKERoleInCreatingCFSStorageclass 策略，用于安装容器集群的 cfs 组件args: – name: app_role_policy label: CAM 角色权限 widget: cam-role-policy-attach roles: – roleName: TKE_QCSRole principalService: 'ccs.qcloud.com' policy: – QcloudAccessForTKERoleInCreatingCFSStorageclass description: 安装当前应用需要为角色授权

预览效果

72、属性

73、输出

结果值

75、描述

开关组件，用于切换两种状态。

76、示例

# <package.yaml># 设置是否自动续费args: – name: charge_type label: 计费类型 description: 云资源购买使用付费方式 widget: select defaultValue: PREPAID options: – label: 包年包月 value: PREPAID – label: 按量计费 value: POSTPAID – name: charge_perpaid_auto_renew label: 自动续费 widget: switch defaultValue: false when: – eq: a: ${charge_type} b: "PREPAID" # 包年包月

预览效果

77、属性

78、输出

结果值

类型：boolean

80、描述

选择框组件。

81、示例

# <package.yaml># 设置是否同意用户协议args: – name: charge_type label: 计费类型 description: 云资源购买使用付费方式 widget: select defaultValue: PREPAID options: – label: 包年包月 value: PREPAID – label: 按量计费 value: POSTPAID – name: charge_perpaid_auto_renew label: 自动续费 widget: switch defaultValue: false when: – eq: a: ${charge_type} b: "PREPAID" # 包年包月 – name: accept_info label: 用户协议 widget: check text: 我已同意用户协议 defaultValue: false

预览效果

82、属性

83、输出

结果值

类型：boolean

85、描述

密码或者敏感信息输入组件。

86、示例

# <package.yaml>args: – name: app_cos_secret_id label: COS 密钥 ID defaultValue: "cos_id" widget: input – name: app_cos_secret_key label: COS 密钥 Key defaultValue: "cos_key" widget: secret

预览效果

87、属性

88、输出

结果值

类型：string

90、描述

密码或者敏感信息多行输入组件。

91、示例

# <package.yaml>args: – name: app_cos_secret_id label: COS 密钥 ID defaultValue: "cos_id" widget: input – name: app_cos_secret_key label: COS 密钥 Key defaultValue: "cos_key" widget: secret – name: web_private_token label: token 信息 widget: secret-textarea

预览效果

92、属性

93、输出

结果值

类型：string

95、描述

下拉选择组件。

96、示例

# <package.yaml>args: – name: charge_type label: 计费类型 description: 云资源购买使用付费方式 widget: select defaultValue: PREPAID options: – label: 包年包月 value: PREPAID – label: 按量计费 value: POSTPAID – name: charge_perpaid_period label: 购买时长 widget: input-number defaultValue: 1 description: 云资源包年包月购买的月份数 when: – eq: a: ${charge_type} b: "PREPAID" # 包年包月

预览效果

97、属性

98、输出

结果值：-

100、描述

数字输入组件。

101、示例

# <package.yaml>args: – name: charge_type label: 计费类型 description: 云资源购买使用付费方式 widget: select defaultValue: PREPAID options: – label: 包年包月 value: PREPAID – label: 按量计费 value: POSTPAID – name: charge_perpaid_auto_renew label: 自动续费 widget: switch defaultValue: false when: – eq: a: ${charge_type} b: "PREPAID" # 包年包月 – name: charge_perpaid_period label: 购买时长 widget: input-number defaultValue: 1 description: 云资源包年包月购买的月份数 when: – eq: a: ${charge_type} b: "PREPAID" # 包年包月 optional: true

预览效果

102、属性

103、输出

结果值

类型：number

105、描述

多行输入组件。

106、示例

# <package.yaml>args: – name: charge_type label: 计费类型 description: 云资源购买使用付费方式 widget: select defaultValue: PREPAID options: – label: 包年包月 value: PREPAID – label: 按量计费 value: POSTPAID – name: charge_perpaid_auto_renew label: 自动续费 widget: switch defaultValue: false when: – eq: a: ${charge_type} b: "PREPAID" # 包年包月 – name: app-description label: 描述信息 widget: input-textarea defaultValue: 描述

预览效果

107、属性

108、输出

结果值

类型：string

110、描述

输入框组件，不建议直接使用 input 组件，可以优先使用上述资源和通用组件。

111、示例

# <package.yaml># 设置是否自动续费args: – name: charge_type label: 计费类型 description: 云资源购买使用付费方式 widget: select defaultValue: PREPAID options: – label: 包年包月 value: PREPAID – label: 按量计费 value: POSTPAID – name: charge_perpaid_auto_renew label: 自动续费 widget: switch defaultValue: false when: – eq: a: ${charge_type} b: "PREPAID" # 包年包月 – name: app_nacos_host label: nacos 地址 widget: input optional: true defaultValue: "172.16.0.2:8848" description: 请提前创建 nacos 配置中心

预览效果

112、属性

113、输出

结果值

类型：string

114、公共类型 PackageArgOp

枚举值：

·{ eq: { a: any; b: any; }; }

·{ ne: { a: any; b: any; }; }

·{ reg: { str: any; exp: string; }; }

·{ gt: { a: any; b: any; }; }

·{ gte: { a: any; b: any; }; }

·{ lt: { a: any; b: any; }; }

·{ lte: { a: any; b: any; }; }

·{ and: PackageArgOp[]; }

·{ or: PackageArgOp[]; }

·{ notIncludes: { arr: any; value: any; }; }

notIncludes 用于校验数组不包含某值，适用于多选组件的校验场景。空数组 / null / undefined 均视为校验通过，天然支持 optional 可选项。比较时统一转成字符串，避免类型陷阱。

示例：

validator: – notIncludes: arr: ${replica_zones__zone_list} value: ${app_target.subnet.zone} message: 副本可用区不能与主可用区相同

115、公共类型 PackageArgValidator

枚举值：

·{ eq: { a: any; b: any; }; } & { message: string; }

·{ ne: { a: any; b: any; }; } & { message: string; }

·{ reg: { str: any; exp: string; }; } & { message: string; }

·{ gt: { a: any; b: any; }; } & { message: string; }

·{ gte: { a: any; b: any; }; } & { message: string; }

·{ lt: { a: any; b: any; }; } & { message: string; }

·{ lte: { a: any; b: any; }; } & { message: string; }

·{ and: PackageArgOp[]; } & { message: string; }

·{ or: PackageArgOp[]; } & { message: string; }

·{ notIncludes: { arr: any; value: any; }; } & { message: string; }

116、公共类型 CamRolePolicy