主機(jī)資源

Linux操作系統(tǒng)

Windows操作系統(tǒng)

CPU

平均CPU使用率不到1%

物理內(nèi)存

約17 MB

約10 MB

磁盤I/O

平穩(wěn)運(yùn)行時幾乎沒有I/O，僅在下載升級安裝包和保存命令腳本等場景下產(chǎn)生磁盤I/O

網(wǎng)絡(luò)I/O

平穩(wěn)運(yùn)行時僅有心跳上報等數(shù)據(jù)產(chǎn)生的少量I/O

常見名詞

說明

云助手

云助手官方名稱，可以幫您在ECS實(shí)例以及彈性裸金屬服務(wù)器實(shí)例上自動以及批量執(zhí)行日常維護(hù)任務(wù)。所有阿里云地域均支持云助手服務(wù)。

云助手Agent

安裝在ECS實(shí)例中的輕量級插件，所有在實(shí)例中完成的命令都會通過云助手Agent完成。

• Windows操作系統(tǒng)中任務(wù)進(jìn)程名稱為aliyun_assist_service。

• Linux操作系統(tǒng)中任務(wù)進(jìn)程名稱為aliyun-service。

云助手守護(hù)進(jìn)程

用于監(jiān)控云助手Agent的資源消耗情況，上報云助手Agent的運(yùn)行狀態(tài)，以及當(dāng)云助手Agent崩潰時重啟云助手Agent。

• 服務(wù)名稱：AssistDaemon

• 路徑：/usr/local/share/assist-daemon/assist_daemon

任務(wù)執(zhí)行路徑

命令

需要在實(shí)例中執(zhí)行的具體命令操作，如一份Shell腳本或者PowerShell腳本。

自定義參數(shù)

您在命令中設(shè)置的變量值，以{{key}}的形式表示，可以在執(zhí)行命令時以{{"key":"value"}}的形式設(shè)置自定義參數(shù)的值。由于您在一個地域下能保有的云助手命令有配額限制，建議您通過設(shè)置自定義參數(shù)提高命令的靈活性以及多場景適用性。您也可以指定內(nèi)置環(huán)境參數(shù)作為自定義參數(shù)，執(zhí)行命令時無需手動對參數(shù)賦值，云助手將為您自動替換為環(huán)境中對應(yīng)的值。

單次執(zhí)行

在一臺或者多臺實(shí)例中執(zhí)行某個命令，即為一次執(zhí)行（Invocation）。

定時執(zhí)行

在一臺或者多臺實(shí)例中執(zhí)行某個命令時，您可以指定執(zhí)行時序或周期，定時執(zhí)行命令進(jìn)程。

API狀態(tài)

狀態(tài)顯示

描述

Pending

系統(tǒng)正在校驗(yàn)或發(fā)送命令

存在至少一臺實(shí)例的命令執(zhí)行狀態(tài)為Pending，則總執(zhí)行狀態(tài)為Pending。

Scheduled

定時執(zhí)行的命令已發(fā)送，等待運(yùn)行

存在至少一臺實(shí)例的命令執(zhí)行狀態(tài)為Scheduled，則總執(zhí)行狀態(tài)為Scheduled。

Running

命令正在實(shí)例上運(yùn)行

存在至少一臺實(shí)例的命令執(zhí)行狀態(tài)為Running，則總執(zhí)行狀態(tài)為Running。

Success

命令執(zhí)行成功

各個實(shí)例上的命令執(zhí)行狀態(tài)均為Stopped或Success，且至少一個實(shí)例的命令執(zhí)行狀態(tài)是Success，則總執(zhí)行狀態(tài)為Success。

• 立即運(yùn)行的任務(wù)：命令執(zhí)行完成，且退出碼為0。

• 定時運(yùn)行的任務(wù)：最近一次執(zhí)行成功且退出碼為0，且指定的時間已全部完成。

Failed

命令執(zhí)行失敗

各個實(shí)例上的命令執(zhí)行狀態(tài)均為Stopped或Failed，則總執(zhí)行狀態(tài)為Failed。實(shí)例上的命令執(zhí)行狀態(tài)一項(xiàng)或多項(xiàng)為以下狀態(tài)時，返回值均為Failed狀態(tài)：

• 命令校驗(yàn)失敗（Invalid）。

• 命令發(fā)送失敗（Aborted）。

• 命令執(zhí)行完成但退出碼非0（Failed）。

• 命令執(zhí)行超時（Timeout）。

• 命令執(zhí)行異常（Error）。

Stopping

正在停止任務(wù)

存在至少一臺實(shí)例的命令執(zhí)行狀態(tài)為Stopping，則總執(zhí)行狀態(tài)為Stopping。

Stopped

任務(wù)已停止

所有實(shí)例的命令執(zhí)行狀態(tài)是Stopped，則總執(zhí)行狀態(tài)為Stopped。實(shí)例上的命令執(zhí)行狀態(tài)為以下狀態(tài)時，返回值均為Stopped狀態(tài)：

• 任務(wù)已取消（Cancelled）。

• 任務(wù)已終止（Terminated）。

PartialFailed

部分實(shí)例執(zhí)行成功且部分實(shí)例執(zhí)行失敗

各個實(shí)例的命令執(zhí)行狀態(tài)均為Success、Failed或Stopped，則總執(zhí)行狀態(tài)為PartialFailed。

業(yè)務(wù)場景

參考文檔

相關(guān)API

ECS實(shí)例中需要安裝云助手Agent后才能使用云助手，2017年12月01日之后使用公共鏡像創(chuàng)建的ECS實(shí)例，默認(rèn)預(yù)裝云助手Agent。因此，部分ECS實(shí)例需要您自行安裝云助手Agent。

安裝云助手Agent

• InstallCloudAssistant

• DescribeCloudAssistantStatus

首次接觸云助手，并習(xí)慣使用API調(diào)用工具。

• Java程序免登錄管理ECS實(shí)例

• Python程序免登錄管理ECS實(shí)例

不涉及

新建一份云助手命令。

創(chuàng)建命令

• RunCommand

• CreateCommand

對目標(biāo)ECS實(shí)例執(zhí)行已創(chuàng)建的命令。

執(zhí)行命令

• RunCommand

• InvokeCommand

查看命令的執(zhí)行狀態(tài)，查看命令的執(zhí)行結(jié)果，即在指定ECS實(shí)例中的實(shí)際輸出信息。

查看執(zhí)行結(jié)果及修復(fù)常見問題

• DescribeInvocations

• DescribeInvocationResults

修改已創(chuàng)建的命令，支持修改命令名稱和描述。

修改命令

不涉及

為一份云助手命令新增版本。或者您希望修改命令的名稱、描述、類型、內(nèi)容、執(zhí)行路徑或者超時時間等更多屬性。

克隆命令

不涉及

停止正在進(jìn)行的命令進(jìn)程。

停止命令

StopInvocation

刪除不再需要的云助手命令，避免命令達(dá)到配額上限時影響新建命令。

刪除命令

DeleteCommand