CloudOps Orchestration Service：ACS-ECS-ScheduleToRunCommand

Nama Template

ACS-ECS-ScheduleToRunCommand menjadwalkan eksekusi perintah secara batch pada instans ECS.

Jalankan Sekarang

Deskripsi Template

Template ini menjadwalkan eksekusi batch perintah Cloud Assistant pada beberapa instans Elastic Compute Service (ECS). Template ini ideal untuk tugas periodik, seperti pemeliharaan sistem dan otomasi tugas rutin. Konfigurasi memerlukan ID wilayah (regionId), ekspresi cron (triggerCron), instans target (targets), jenis perintah (commandType), dan isi perintah (commandContent). Setelah dijalankan, template ini mengembalikan daftar output perintah untuk memverifikasi status eksekusi.

Tipe Template

Otomatis

Pemilik

Alibaba Cloud

Parameter Input

Parameter Output

Kebijakan Izin yang Diperlukan untuk Menjalankan Template

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "ecs:DescribeInstances",
                "ecs:DescribeInvocationResults",
                "ecs:DescribeInvocations",
                "ecs:RunCommand"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "oos:GetApplicationGroup"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Detail

Untuk informasi lebih lanjut, lihat ACS-ECS-ScheduleToRunCommand.yml di GitHub.

Konten Template

FormatVersion: OOS-2019-06-01
Description:
  en: 'Schedule to run command on ECS instances, applicable to scenarios that require periodically running commands on multiple ECS instances, such as system maintenance and task automation. During configuration, users need to provide the following required parameter information: Region ID (regionId), which specifies the region of the ECS instances where the commands will be run, Cron Expression (triggerCron), which defines the schedule for the task, Target Instances (targets), which defines the specific ECS instances to be operated on, and Command Type (commandType) and Command Content (commandContent). Upon execution, the template will return a list of the output results of the run command, enabling users to verify the status of the command executions.'
  zh-cn: 'Schedules the batch execution of Cloud Assistant commands on multiple ECS instances. It is ideal for periodic tasks, such as system maintenance and task automation. The configuration requires the region ID (regionId), a cron expression (triggerCron), the target instances (targets), the command type (commandType), and the command content (commandContent). After the template runs, it returns a list of the command outputs to verify the execution status.'
  name-en: ACS-ECS-ScheduleToRunCommand
  name-zh-cn: Schedules batch execution of commands on ECS instances
  categories:
    - time_trigger
Parameters:
  regionId:
    Type: String
    Label:
      en: RegionId
      zh-cn: Region ID
    AssociationProperty: RegionId
    Default: '{{ ACS::RegionId }}'
  triggerCron:
    Description:
      en: 'refer them here: https://www.alibabacloud.com/help/document_detail/169784.html'
      zh-cn: 'For more information, see https://www.alibabacloud.com/help/document_detail/169784.html'
    Label:
      en: Cronexpression
      zh-cn: Ekspresi cron
    Type: String
    AssociationProperty: Cron
    Default: 0 0 12 ? * *
  triggerEndDate:
    Description:
      en: 'Format: yyyy-MM-ddTHH:mm:ssZ.'
      zh-cn: 'Format: yyyy-MM-ddTHH:mm:ssZ'
    Label:
      en: triggerEndDate
      zh-cn: Waktu akhir pemicu waktu
    Type: String
    AssociationProperty: DateTime
    AssociationPropertyMetadata:
      Format: 'YYYY-MM-DDTHH:mm:ssZ'
  timeZone:
    Label:
      en: timeZone
      zh-cn: Zona waktu
    Type: String
    AssociationProperty: TimeZone
    Default: UTC
  targets:
    Type: Json
    Label:
      en: TargetInstance
      zh-cn: Instans target
    AssociationProperty: Targets
    AssociationPropertyMetadata:
      ResourceType: 'ALIYUN::ECS::Instance'
      RegionId: regionId
      Status: Running
  commandType:
    Label:
      en: CommandType
      zh-cn: Jenis perintah Cloud Assistant
    Type: String
    AllowedValues:
      - RunBatScript
      - RunPowerShellScript
      - RunShellScript
    Default: RunShellScript
  commandContent:
    Label:
      en: CommandContent
      zh-cn: Isi perintah Cloud Assistant
    Type: String
    MaxLength: 16384
    AssociationProperty: Code
    Default: echo hello
  workingDir:
    Description:
      en: '<td class="entry colsep-1 rowsep-1">
            <p class="p">Default value: </p>
            <ul class="ul">
            <li class="li"> Linux instances: the home directory of the administrator (the root user), which is<code class="ph codeph">/root</code>.</li>
            <li class="li"> Windows instances: the directory where the Cloud Assistant client process resides,such as <code class="ph codeph">C:\Windows\System32</code>.</li>
            </ul>
          </td>'
      zh-cn: '<td class="entry colsep-1 rowsep-1">
              <p class="p">Default value:</p>
              <ul class="ul">
                <li class="li">For Linux instances, the default directory is the home directory of the administrator (root user), which is <code class="ph codeph">/root</code>.</li>
                <li class="li">For Windows instances, the default directory is where the Cloud Assistant client process is located, such as <code class="ph codeph">C:\Windows\System32</code>.</li>
              </ul>
            </td>'
    Label:
      en: WorkingDir
      zh-cn: Direktori tempat menjalankan perintah pada instans ECS
    Type: String
    Default: ''
  timeout:
    Label:
      en: Timeout (s)
      zh-cn: Timeout (s)
    Type: Number
    Default: 600
  rateControl:
    Label:
      en: RateControl
      zh-cn: Laju konkurensi eksekusi tugas
    Type: Json
    AssociationProperty: RateControl
    Default:
      Mode: Concurrency
      MaxErrors: 0
      Concurrency: 10
  OOSAssumeRole:
    Label:
      en: OOSAssumeRole
      zh-cn: Peran RAM yang diasumsikan oleh OOS
    Type: String
    Default: OOSServiceRole
RamRole: '{{ OOSAssumeRole }}'
Tasks:
  - Name: timerTrigger
    Action: ACS::TimerTrigger
    Description:
      en: Triggers a task as scheduled by specifying type and expression
      zh-cn: Memicu tugas sesuai jadwal dengan menentukan jenis dan ekspresi pemicu
    Properties:
      Type: cron
      Expression: '{{ triggerCron }}'
      EndDate: '{{ triggerEndDate }}'
      TimeZone: '{{ timeZone }}'
  - Name: getInstance
    Description:
      en: Views the ECS instances
      zh-cn: Mendapatkan instans ECS
    Action: 'ACS::SelectTargets'
    Properties:
      ResourceType: 'ALIYUN::ECS::Instance'
      RegionId: '{{ regionId }}'
      Filters:
        - '{{ targets }}'
    Outputs:
      instanceIds:
        Type: List
        ValueSelector: 'Instances.Instance[].InstanceId'
  - Name: runCommand
    Action: 'ACS::ECS::RunCommand'
    Description:
      en: Execute cloud assistant command
      zh-cn: Menjalankan perintah Cloud Assistant
    Properties:
      regionId: '{{ regionId }}'
      commandContent: '{{ commandContent }}'
      instanceId: '{{ ACS::TaskLoopItem }}'
      commandType: '{{ commandType }}'
      workingDir: '{{ workingDir }}'
      timeout: '{{ timeout }}'
    Loop:
      RateControl: '{{ rateControl }}'
      Items: '{{ getInstance.instanceIds }}'
      Outputs:
        commandOutputs:
          AggregateType: 'Fn::ListJoin'
          AggregateField: commandOutput
    Outputs:
      commandOutput:
        Type: String
        ValueSelector: invocationOutput
Outputs:
  commandOutputs:
    Type: List
    Value: '{{ runCommand.commandOutputs }}'
Metadata:
  ALIYUN::OOS::Interface:
    ParameterGroups:
      - Parameters:
          - timeZone
          - triggerCron
          - triggerEndDate
        Label:
          default:
            zh-cn: Pengaturan Jadwal
            en: Timer Trigger Configure
      - Parameters:
          - commandType
          - commandContent
          - workingDir
          - timeout
        Label:
          default:
            zh-cn: Opsi Eksekusi Perintah
            en: run command options
      - Parameters:
          - regionId
          - targets
        Label:
          default:
            zh-cn: Pilih Instans
            en: Select Ecs Instances
      - Parameters:
          - rateControl
          - OOSAssumeRole
        Label:
          default:
            zh-cn: Opsi Lanjutan
            en: Control Options