模板名称
ACS-ECS-BulkyDownloadFile 上传文件
模板描述
批量上传文件到多个阿里云ECS实例，适用于需要在多台实例间分发文件的场景，例如应用部署、数据同步等。在配置过程中，用户需要提供以下必填参数信息：地域ID（regionId）：用于指定需要上传文件的目标ECS实例所在的区域，目标实例（targets）：用于定义具体需要操作的ECS实例，文件类型（sourceType）：用于指定文件的来源方式（如本地、OSS或HTTPS），以及文件路径（sourcePath）：具体的文件位置。模板在执行后会返回文件上传操作的结果信息，方便用户验证文件上传的状态。
模板类型
自动化
所有者
Alibaba Cloud
输入参数
参数名称 | 描述 | 类型 | 是否必填 | 默认值 | 约束 |
targets | 目标实例 | Json | 是 | ||
sourcePath | 选择文件 | String | 是 | ||
regionId | 地域ID | String | 否 | {{ ACS::RegionId }} | |
sourceType | 文件类型 | String | 否 | local | |
destinationDir | 文件保存路径 | String | 否 | /root | |
timeout | 超时时间 | Number | 否 | 600 | |
fileOwner | 文件所有者 | String | 否 | “” | |
fileGroup | 文件所属组 | String | 否 | “” | |
fileMode | 文件权限 | String | 否 | “” | |
overwrite | 覆盖已存在的文件 | Boolean | 否 | True | |
rateControl | 任务执行的并发比率 | Json | 否 | {‘Mode’: ‘Concurrency’, ‘MaxErrors’: 0, ‘Concurrency’: 10} | |
OOSAssumeRole | OOS扮演的RAM角色 | String | 否 | “” |
输出参数
参数名称 | 描述 | 类型 |
commandOutput | String |
执行此模板需要的权限策略
{
"Version": "1",
"Statement": [
{
"Action": [
"ecs:DescribeInstances",
"ecs:DescribeInvocationResults",
"ecs:DescribeInvocations",
"ecs:RunCommand"
],
"Resource": "*",
"Effect": "Allow"
}
]
}
详情
模板内容
FormatVersion: OOS-2019-06-01
Description:
en: 'Bulky upload files to multiple Alibaba Cloud ECS instances, applicable to scenarios that require distributing files across multiple instances, such as application deployment and data synchronization. During configuration, users need to provide the following required parameter information: Region ID (regionId), which specifies the region of the target ECS instances where the files will be uploaded, Target Instances (targets), which defines the specific ECS instances to be operated on, Source Type (sourceType), which specifies the source method of the file (e.g., local, OSS, or HTTPS), and Source Path (sourcePath), which is the exact location of the file. Upon execution, the template provides the results of the file upload operation, enabling users to verify the status of the file uploads.'
zh-cn: 批量上传文件到多个阿里云ECS实例，适用于需要在多台实例间分发文件的场景，例如应用部署、数据同步等。在配置过程中，用户需要提供以下必填参数信息：地域ID（regionId）：用于指定需要上传文件的目标ECS实例所在的区域，目标实例（targets）：用于定义具体需要操作的ECS实例，文件类型（sourceType）：用于指定文件的来源方式（如本地、OSS或HTTPS），以及文件路径（sourcePath）：具体的文件位置。模板在执行后会返回文件上传操作的结果信息，方便用户验证文件上传的状态。
name-en: Upload File
name-zh-cn: 上传文件
categories:
- instance_manage
- application_manage
- computenest
Parameters:
regionId:
Type: String
Label:
en: RegionId
zh-cn: 地域ID
AssociationProperty: RegionId
Default: '{{ ACS::RegionId }}'
targets:
Type: Json
Label:
en: TargetInstance
zh-cn: 目标实例
Description:
en: <p class="p">Precautions:</p> <ul class="ul"> <li class="li"><font color='red'>Download via https requires the ECS instance to enable public network access </font></li><li class="li"><font color='red'>Downloading via oss requires an ECS instance to configure a RAM role, <a href='https://www.alibabacloud.com/help/en/operation-orchestration-service/latest/download-multiple-objects-to-an-instance#vOk3w'>Reference Document</a></font></li>
zh-cn: <p class="p">注意事项：</p> <ul class="ul"> <li class="li"><font color='red'>通过https方式下载需要ECS实例开启公网访问</font></li><li class="li"><font color='red'>通过oss方式下载需要ECS实例配置RAM角色，<a href='https://help.aliyun.com/document_detail/175396.html?spm=a2c4g.120556.0.0.34c9de53iyt2Z1#vOk3w'>参考文档</a></font></li>
AssociationProperty: Targets
AssociationPropertyMetadata:
ResourceType: 'ALIYUN::ECS::Instance'
RegionId: regionId
Status: Running
sourceType:
Type: String
Description:
en: Local uploaded files cannot exceed 500M
zh-cn: 本地上传文件不能超过500M
Label:
en: SourceType
zh-cn: 文件类型
AllowedValues:
- local
- oss
- https
Default: local
AssociationPropertyMetadata:
LocaleKey: DownloadFileType
RegionId: ${regionId}
sourcePath:
Type: String
Label:
en: SourcePath
zh-cn: 选择文件
AssociationProperty: ALIYUN::OOS::File::FileUrl
AssociationPropertyMetadata:
FileType: ${sourceType}
RegionId: ${regionId}
destinationDir:
Label:
en: DestinationDir
zh-cn: 文件保存路径
Description:
en: The full path of destination directory
zh-cn: 文件在目标机器的完整路径
Type: String
Default: /root
timeout:
Label:
en: Timeout
zh-cn: 超时时间
Type: Number
Default: 600
fileOwner:
Label:
en: FileOwner
zh-cn: 文件所有者
Type: String
Default: ''
fileGroup:
Label:
en: FileGroup
zh-cn: 文件所属组
Type: String
Default: ''
fileMode:
Label:
en: FileMode
zh-cn: 文件权限
Type: String
Default: ''
overwrite:
Label:
en: Overwrite
zh-cn: 覆盖已存在的文件
Type: Boolean
Default: true
rateControl:
Label:
en: RateControl
zh-cn: 任务执行的并发比率
Type: Json
AssociationProperty: RateControl
Default:
Mode: Concurrency
MaxErrors: 0
Concurrency: 10
OOSAssumeRole:
Label:
en: OOSAssumeRole
zh-cn: OOS扮演的RAM角色
Type: String
Default: ''
RamRole: '{{ OOSAssumeRole }}'
Tasks:
- Name: getInstance
Description:
en: Views the ECS instances
zh-cn: 获取ECS实例
Action: 'ACS::SelectTargets'
Properties:
ResourceType: 'ALIYUN::ECS::Instance'
RegionId: '{{ regionId }}'
Filters:
- '{{ targets }}'
Outputs:
instanceIds:
Type: List
ValueSelector: 'Instances.Instance[].InstanceId'
- Name: downloadFileToInstances
Action: 'ACS::ECS::DownloadFile'
Description:
en: Downloads file to the ECS instances
zh-cn: 下载文件到实例
Properties:
regionId: '{{ regionId }}'
instanceId: '{{ ACS::TaskLoopItem }}'
sourceType: '{{ sourceType }}'
sourcePath: '{{ sourcePath }}'
destinationDir: '{{ destinationDir }}'
timeout: '{{ timeout }}'
fileOwner: '{{ fileOwner }}'
fileGroup: '{{ fileGroup }}'
fileMode: '{{ fileMode }}'
overwrite: '{{ overwrite }}'
Loop:
Items: '{{ getInstance.instanceIds }}'
RateControl: '{{ rateControl }}'
Outputs:
commandOutputs:
AggregateType: 'Fn::ListJoin'
AggregateField: commandOutput
Outputs:
commandOutput:
Type: String
ValueSelector: commandOutput
Outputs:
commandOutput:
Type: String
Value: '{{ downloadFileToInstances.commandOutputs }}'
Metadata:
ALIYUN::OOS::Interface:
ParameterGroups:
- Parameters:
- sourceType
- sourcePath
- destinationDir
Label:
default:
zh-cn: 配置参数
en: Configure Parameters
- Parameters:
- regionId
- targets
Label:
default:
zh-cn: 选择实例
en: Select Instances
- Parameters:
- timeout
- fileOwner
- fileGroup
- fileMode
- overwrite
- rateControl
- OOSAssumeRole
Label:
default:
zh-cn: 高级选项
en: Control Options