使用 AWS OpsWorks 堆疊 CLI

重要

該 AWS OpsWorks Stacks 服務於 2024 年 5 月 26 日終止使用壽命，並已針對新客戶和現有客戶停用。我們強烈建議客戶盡快將其工作負載移轉至其他解決方案。如果您對移轉有任何疑問，請透過 AWS Re: post 或透過進AWS 階 Support 與 AWS Support 團隊聯絡。

AWS OpsWorks 堆疊命令列介面 (CLI) 提供與主控台相同的功能，可用於各種工作。 AWS OpsWorks 堆疊 CLI 是的一部分 AWS CLI。如需詳細資訊，包括如何安裝和設定 AWS CLI，請移至什麼是 AWS 命令列界面？ 。如需每個命令的完整說明，請前往 AWS OpsWorks Stacks 參考。

注意

如果您使用的是以 Windows 為基礎的工作站，您也可以執行 Windows AWS 工具，以 PowerShell 便從命令列執行 AWS OpsWorks 堆疊作業。如需詳細資訊，請參閱適用於 Windows 的 AWS 工具 PowerShell。

AWS OpsWorks 堆疊指令的一般格式如下：

aws opsworks --region us-west-1 opsworks command-name [--argument1 value] [...]

若引數值為 JSON 物件，您應逸出 " 字元，否則命令會傳回錯誤，顯示 JSON 無效。例如，若 JSON 物件為 "{"somekey":"somevalue"}"，您應將其格式化為 "{\"somekey\":\"somevalue\"}"。另一種方法為將 JSON 物件放置在檔案中，然後在命令列中使用 file:// 以包含它。以下範例會使用存放在 appsource.json 中的應用程式來源物件建立應用程式。

aws opsworks --region us-west-1 create-app --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 --name SimpleJSP --type java --app-source file://appsource.json 

大多數命令會傳回一或多個值，並封裝為 JSON 物件。以下章節包含一些範例。如需每個命令傳回值的詳細說明，請前往 AWS OpsWorks Stacks 參考。

注意

AWS CLI 指令必須指定一個區域，如範例所示。--region 參數的有效值如下表所示。若要簡化 AWS OpsWorks Stacks 命令字串，請將 CLI 設定為指定預設區域，以便省略--region參數。如果您通常在多個地區端點中工作，請勿將配置 AWS CLI 為使用預設地區端點。加拿大（中部）區域端點 AWS CLI 僅在 API 中提供；它不適用於您在中建立的堆疊 AWS Management Console。如需詳細資訊，請參閱設定 AWS 區域。

區域名稱	命令程式碼
美國東部 (俄亥俄) 區域	us-east-2
美國東部 (維吉尼亞北部) 區域	us-east-1
美國西部 (加利佛尼亞北部) 區域	us-west-1
美國西部 (奧勒岡) 區域	us-west-2
加拿大 (中部) 區域	ca-central-1
歐洲 (愛爾蘭) 區域	eu-west-1
歐洲 (倫敦) 區域	eu-west-2
歐洲 (巴黎) 區域	eu-west-3
歐洲 (法蘭克福) 區域	eu-central-1
亞太 (東京) 區域	ap-northeast-1
亞太 (首爾) 區域	ap-northeast-2
亞太區域 (孟買) 區域	ap-south-1
亞太區域 (新加坡) 區域	ap-southeast-1
亞太 (雪梨) 區域	ap-southeast-2
南美洲 (聖保羅) 區域	sa-east-1

若要使用 CLI 命令，您必須擁有適當的許可。如需 AWS OpsWorks Stacks 許可的詳細資訊，請參閱管理使用者許可。若要判斷特定命令需要的許可，請參閱 AWS OpsWorks Stacks 參考中該命令的參考頁面。

下列各節說明如何使用 AWS OpsWorks 堆疊 CLI 來執行各種常見工作。