ACS-ECS-BulkyDownloadFile - CloudOps Orchestration Service

模板名稱

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