Template name
ACS-ECS-ConfigureCloudMonitorAgent
Template description
Installs the CloudMonitor agent on multiple Elastic Compute Service (ECS) instances at a time.
Template type
Automated
Owner
Alibaba Cloud
Input parameters
Parameter | Description | Type | Required | Default value | Limit |
action | The operation that you want to perform. | String | Yes | ||
targets | The ECS instances on which you want to Install the CloudMonitor agent. | Json | Yes | ||
regionId | The region ID. | String | No | {{ ACS::RegionId }} | |
rateControl | The rate control settings. | Json | No | {'Mode': 'Concurrency', 'MaxErrors': '0', 'Concurrency': 10} | |
OOSAssumeRole | The Resource Access Management (RAM) role that is assumed by CloudOps Orchestration Service (OOS). | String | No | "" |
Output parameters
Parameter | Description | Type |
commandOutput | String |
Permission policy that is required to execute the template
{
"Version": "1",
"Statement": [
{
"Action": [
"ecs:DescribeInstances",
"ecs:DescribeInvocationResults",
"ecs:DescribeInvocations",
"ecs:RunCommand"
],
"Resource": "*",
"Effect": "Allow"
}
]
}
References
For more information, see ACS-ECS-ConfigureCloudMonitorAgent.yml at GitHub.
Template content
FormatVersion: OOS-2019-06-01
Description:
en: Use this template to install cloud monitor agent on ecs
zh-cn: the description in Chinese
name-en: ACS-ECS-ConfigureCloudMonitorAgent
name-zh-cn: the description in Chinese
categories:
- run_command
Parameters:
regionId:
Type: String
Label:
en: RegionId
zh-cn: the description in Chinese
AssociationProperty: RegionId
Default: '{{ ACS::RegionId }}'
action:
Type: String
Label:
en: Action
zh-cn: the description in Chinese
AllowedValues:
- install
- uninstall
targets:
Type: Json
Label:
en: TargetInstance
zh-cn: the description in Chinese
AssociationProperty: Targets
AssociationPropertyMetadata:
ResourceType: 'ALIYUN::ECS::Instance'
RegionId: regionId
rateControl:
Label:
en: RateControl
zh-cn: the description in Chinese
Type: Json
AssociationProperty: RateControl
Default:
Mode: Concurrency
MaxErrors: 0
Concurrency: 10
OOSAssumeRole:
Label:
en: OOSAssumeRole
zh-cn: the description in Chinese
Type: String
Default: ''
RamRole: '{{ OOSAssumeRole }}'
Tasks:
- Name: getInstance
Description:
en: Views the ECS instances
zh-cn: the description in Chinese
Action: 'ACS::SelectTargets'
Properties:
ResourceType: 'ALIYUN::ECS::Instance'
RegionId: '{{ regionId }}'
Filters:
- '{{ targets }}'
Outputs:
instanceIds:
Type: List
ValueSelector: 'Instances.Instance[].InstanceId'
instanceInfos:
Type: List
ValueSelector: '.Instances.Instance[] | {"osType":.OSType, "instanceId":.InstanceId}'
- Name: runCommand
Action: 'ACS::ECS::RunCommand'
Properties:
commandContent:
'Fn::If':
- 'Fn::Equals':
- 'Fn::Jq':
- First
- '.|map(select(.instanceId == "{{ ACS::TaskLoopItem }}").osType)[]'
- '{{ getInstance.instanceInfos }}'
- linux
- |-
#!/bin/bash
if [ "{{action}}" = "install" ]; then
VERSION=2.1.56 /bin/bash -c "$(curl -s https://cms-agent-{{ACS::RegionId}}.oss-{{ACS::RegionId}}-internal.aliyuncs.com/cms-go-agent/cms_go_agent_install-1.4.sh)"
elif [ "{{action}}" = "uninstall" ]; then
if [ `uname -m` = "x86_64" ]; then
ARCH="amd64"
else
ARCH="386"
fi
/usr/local/cloudmonitor/CmsGoAgent.linux-${ARCH} uninstall && rm -rf /usr/local/cloudmonitor && echo "cloud monitor uninstall success." >& 2
else
echo "command must be install or uninstall" >& 2
exit 1;
fi
- |-
$uname=Get-WmiObject Win32_OperatingSystem |Select-Object -ExpandProperty OSArchitecture
if ($uname.contains("64"))
{
$ARCH="amd64"
} else
{
$ARCH="386"
}
$pathExistOrNot = Test-Path -Path "C:\Program Files\Alibaba\cloudmonitor\CmsGoAgent.windows-$ARCH.exe"
$dictoryExisOrNot = Test-Path -Path "C:\Program Files\Alibaba\cloudmonitor"
if ($dictoryExisOrNot)
{
echo ""
} else
{
mkdir "C:\Program Files\Alibaba\cloudmonitor"
echo 'create dictory'
}
if ($pathExistOrNot)
{
cd "C:\Program Files\Alibaba\cloudmonitor"
} else
{
cd "C:\Program Files\Alibaba\cloudmonitor"
$client = new-object System.Net.WebClient
$client.DownloadFile("http://cms-agent-{{ACS::RegionId}}.oss-{{ACS::RegionId}}-internal.aliyuncs.com/cms-go-agent/2.1.56/CmsGoAgent.windows-$ARCH.exe", "C:\Program Files\Alibaba\cloudmonitor\CmsGoAgent.windows-$ARCH.exe")
}
$action="{{ action }}"
switch($action)
{
"install" {
if ($ARCH -eq "amd64")
{
.\CmsGoAgent.windows-amd64.exe install
.\CmsGoAgent.windows-amd64.exe start
} else
{
.\CmsGoAgent.windows-386.exe install
.\CmsGoAgent.windows-386.exe start
}
echo "install complete"
}
"uninstall" {
if ($ARCH -eq "amd64")
{
.\CmsGoAgent.windows-amd64.exe stop
.\CmsGoAgent.windows-amd64.exe uninstall
} else
{
.\CmsGoAgent.windows-386.exe stop
.\CmsGoAgent.windows-386.exe uninstall
}
echo "uninstall complete"
}
}
instanceId: '{{ ACS::TaskLoopItem }}'
regionId: '{{ regionId }}'
commandType:
'Fn::If':
- 'Fn::Equals':
- 'Fn::Jq':
- First
- '.|map(select(.instanceId == "{{ ACS::TaskLoopItem }}").osType)[]'
- '{{ getInstance.instanceInfos }}'
- linux
- RunShellScript
- RunPowerShellScript
Loop:
Items: '{{ getInstance.instanceIds }}'
RateControl: '{{ rateControl }}'
Outputs:
commandOutputs:
AggregateType: 'Fn::ListJoin'
AggregateField: commandOutput
Outputs:
commandOutput:
Type: String
ValueSelector: invocationOutput
Outputs:
commandOutput:
Type: String
Value: '{{ runCommand.commandOutputs }}'
Metadata:
ALIYUN::OOS::Interface:
ParameterGroups:
- Parameters:
- action
Label:
default:
zh-cn: the description in Chinese
en: Configure Parameters
- Parameters:
- regionId
- targets
Label:
default:
zh-cn: the description in Chinese
en: Select Ecs Instances
- Parameters:
- rateControl
- OOSAssumeRole
Label:
default:
zh-cn: the description in Chinese
en: Control Options