ACS-ECS-BulkyDownloadFile

模板名称

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"
        }
    ]
}

详情

ACS-ECS-BulkyDownloadFile详情

模板内容

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