執行雲助手公用命令 - Elastic Compute Service

公用命令是由阿里雲提供給所有使用者使用的雲助手命令，適用於軟體的安裝或卸載、執行個體狀態診斷、密鑰輪轉等情境。本文為您介紹如何查看和執行雲助手公用命令。

背景資訊

公用命令是阿里雲建立的雲助手命令，對所有阿里雲使用者可見。通常包含一些比較複雜的伺服器配置、健康或安全檢測、應用安裝、檔案處理、系統補丁安裝、更改系統配置、服務或應用管理的指令碼，以及雲助手外掛程式（包含指令碼或可執行程式）。

相比較普通命令，公用命令的內容、發布以及升級會由阿里雲統一負責維護。公用命令發布後，您可以直接查看命令的詳細內容，並可以在ECS執行個體上執行命令及查看執行進度和結果，例如，一鍵升級Linux執行個體中的雲助手Agent、一鍵安裝Java、一鍵診斷Linux執行個體是否需要進行磁碟擴容操作等。使用公用命令，可以快速地完成某些複雜配置，很大程度提升您的操作和營運效率。

操作步驟

您可以根據需要選擇以下任意方式查看和執行公用命令。

ECS管理主控台方式

登入ECS管理主控台。
在左側導覽列，選擇營運與監控 > 雲助手。
在頁面左側頂部，選擇目標資源所在的資源群組和地區。
在ECS雲助手頁面，單擊公用命令頁簽。
在該頁簽下，您可以使用當前阿里雲官方提供的公用命令。
找到待執行的公用命令，單擊執行。
說明
公用命令首頁僅展示最新版本的公用命令，若需要查看或執行歷史版本的公用命令，請找到對應的公用命令並單擊命令ID進入命令詳情頁操作。

在執行命令面板中，配置相關參數並單擊執行。

主要配置參數如下所示：

說明

執行公用命令所需配置參數的更多資訊，請參見通過控制台執行命令。

地區	參數名稱	描述
命令信息	命令內容	單擊查看命令內容確認命令內容。
	執行計畫	選擇公用命令的執行計畫，選擇項如下所示：立即執行系統下一次啟動後系統每次啟動後定時執行關於執行計畫的更多資訊，請參見執行計畫詳細資料。
	執行使用者	在ECS執行個體中執行命令的使用者名稱稱，例如root。預設情況下，在Linux執行個體中以root使用者執行命令，在Windows執行個體中以System使用者執行命令。
	逾時時間	請輸入正整數，可設定逾時範圍為10～86400秒（24小時），逾時後，會強制終止發送進程（預設為命令本身的逾時時間）。
	命令參數	如果頁面出現命令參數項，請您在對應文字框中輸入自訂參數值，具體以實際面板顯示為準。說明若公用命令提供方提供了參數描述、預設值或可選值，請按照提示填寫。若參數為必填項，您需要輸入具體參數值才可以執行。
選擇實例	-	選擇一台或多台需要執行命令的執行個體，該執行個體需處於運行中狀態且已安裝雲助手的用戶端。
選擇受管理的執行個體	-	選擇要執行命令的受管理的執行個體，受管理的執行個體需處於串連狀態且已安裝雲助手的用戶端。說明受管理的執行個體是雲助手託管的非阿里雲伺服器，更多資訊，請參見阿里雲受管理的執行個體。

在命令執行結果頁簽下，找到已執行成功的公用命令，單擊對應操作列下的查看。
在執行詳情頁面，執行個體的執行狀態為執行成功時，可查看公用命令的執行輸出結果。
說明
如果公用命令執行失敗，請查看錯誤資訊並根據診斷資訊修複問題，更多資訊，請參見執行失敗常見錯誤及修複建議。

OpenAPI方式

查看公用命令。
您可以通過調用DescribeCommands介面查看公用命令，還可以直接使用公用命令名稱進行查詢。
查看公用命令時，請注意以下參數：
- Name：命令的名稱。以查看杭州地區的公用命令ACS-ECS-DiskResize-Diagnostic-for-linux.sh為例，命令名稱為ACS-ECS-DiskResize-Diagnostic-for-linux.sh。
- Provider：公用命令提供者。當該參數取值為AlibabaCloud時，表示查詢由阿里雲提供的所有公用命令。
執行公用命令。
根據上述步驟1返回的CommandId參數值，您可以通過調用InvokeCommand執行雲助手公用命令，還可以直接使用命令名稱執行公用命令，公用命令的名稱在不同地區是相同的。
執行公用命令時，請注意以下參數：
CommandId：命令ID。對於公用命令，CommandId可以填入公用命令名稱執行。在本例中，取值為ACS-ECS-DiskResize-Diagnostic-for-linux.sh。
調用成功後，會擷取一個返回參數InvokeId（例如t-hz02kwqc9pg****），即公用命令的執行ID。您可以調用DescribeInvocations或DescribeInvocationResults介面查詢雲助手命令執行結果。
您也可以在公用命令執行詳情頁的輸出結果中，查看本樣本中Linux執行個體是否需要進行磁碟擴容操作的詳細說明。

CLI方式

通過CLI查看公用命令。
您可以通過DescribeCommands介面查看公用命令。
- 當Provider參數為AlibabaCloud時，表示查詢由阿里雲提供的所有公用命令。
- 當該參數的取值為具體的公用命令提供者時，查詢該提供者提供的所有公用命令。
  以杭州地區為例，查詢阿里雲提供的所有公用命令樣本如下所示：
```
aliyun ecs DescribeCommands \
--region 'cn-hangzhou' \
--RegionId 'cn-hangzhou' \
--Provider 'AlibabaCloud'
```
  以查詢杭州地區的公用命令ACS-ECS-DiskResize-Diagnostic-for-linux.sh為例，該公用命令用來診斷Linux執行個體是否需要進行磁碟擴容操作。樣本如下所示：
```
aliyun ecs DescribeCommands \
--region 'cn-hangzhou' \
--RegionId 'cn-hangzhou' \
--CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh'
```
通過CLI執行公用命令。
調用InvokeCommand介面為一台或多台ECS執行個體執行雲助手公用命令。
以公用命令ACS-ECS-DiskResize-Diagnostic-for-linux.sh為例，該公用命令用來診斷Linux執行個體是否需要進行磁碟擴容操作。樣本如下所示：
```
aliyun ecs InvokeCommand --RegionId 'cn-hangzhou' \
--InstanceId.1 'i-bp1f4f6o8lv0wqof****' \
--InstanceId.2 'i-bp137qu6142s3mhm****' \
--CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh' \
--Timed 'false'
```
調用成功後，會擷取一個返回參數InvokeId（例如t-hz03rj5u0jx****），即公用命令的執行ID。您可以調用DescribeInvocations或DescribeInvocationResults介面查詢雲助手命令執行結果。樣本如下所示：
```
aliyun ecs DescribeInvocations --RegionId 'cn-hangzhou' \
--InvokeId 't-hz03rj5u0jx****'
```
您也可以在公用命令執行詳情頁的輸出結果中，查看本樣本中Linux執行個體是否需要進行磁碟擴容操作的詳細說明。