從部署 CloudFormation的堆疊取得匯出的輸出 - AWS CloudFormation

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

從部署 CloudFormation的堆疊取得匯出的輸出

當您在相同 AWS 帳戶 和 區域中有多個堆疊時,您可能想要在它們之間共用資訊。當一個堆疊需要使用另一個堆疊建立的資源時,這很有用。

例如,您可能有一個堆疊,可為您的 Web 伺服器建立網路資源,例如子網路和安全群組。然後,建立實際 Web 伺服器的其他堆疊可以使用第一個堆疊建立的網路資源。您不需要在堆疊的範本IDs中硬式程式碼資源,也不需要以輸入參數IDs的形式傳遞。

若要在堆疊之間共用資訊,您可以從一個堆疊匯出輸出值,並將其匯入另一個堆疊。以下是其運作方式:

  1. 在第一個堆疊的範本 (例如,聯網堆疊) 中,您可以使用 Outputs區段中的 Export 欄位定義要匯出的特定值。如需詳細資訊,請參閱Outputs CloudFormation 範本的 區段語法參考

  2. 當您建立或更新該堆疊時, 會 CloudFormation 匯出輸出值,使其可供相同 AWS 帳戶 和 區域中的其他堆疊使用。

  3. 在另一個堆疊的範本中,您可以使用 Fn::ImportValue 函數,以從第一個堆疊匯入匯出的值。

  4. 當您建立或更新第二個堆疊 (例如 Web 伺服器堆疊) 時, CloudFormation 會自動從第一個堆疊擷取匯出的值並使用它們。

如需演練和範例範本,請參閱參考另一個 CloudFormation堆棧中的資源輸出

匯出堆疊輸出值與使用巢狀堆疊的比較

巢狀堆疊是指藉由使用 AWS::CloudFormation::Stack 資源在另一個堆疊中建立的堆疊。使用巢狀堆疊時,您可以透過單一堆疊來部署和管理所有資源。您可以將巢狀堆疊群組中某個堆疊的輸出,作為群組中其他堆疊的輸入。這與匯出值的情況不同。

如果您想要將資訊的共享隔離在巢狀堆疊群組內,則建議您使用巢狀堆疊。若要與其他堆疊 (而不只是在巢狀堆疊的群組內) 共享資訊,則匯出值。例如,您可以建立含子網路的單一堆疊,然後匯出其 ID。其他堆疊可以透過匯入其 ID 來使用該子網路。每個堆疊不需要建立自己的子網路。只要有堆疊匯入子網路 ID,您就無法變更或刪除該 ID。

如需巢狀堆疊的詳細資訊,請參閱 使用巢狀堆疊在其他堆疊中嵌入堆疊

考量事項

下列限制適用於跨堆疊參考:

  • 對於每個 AWS 帳戶,Export名稱在區域中必須是唯一的。

  • 您無法跨區域建立跨堆疊參考。您可以使用內部函數 Fn::ImportValue,僅匯入已在同一區域內匯出的值。

  • 對於輸出,ExportName 屬性值無法使用依賴某個資源的 Ref 或者 GetAtt 函數。

    同樣,ImportValue 函數不能包含依賴某個資源的 RefGetAtt 函數。

  • 當其他堆疊匯入輸出值之後,您就無法刪除匯出輸出值的堆疊,也無法修改匯出的輸出值。您必須先移除所有匯入,之後才可以刪除匯出堆疊或修改輸出值。

列出已匯出的輸出值

如果您需要檢視從堆疊匯出的輸出值,請使用下列其中一種方法:

列出已匯出的輸出值 (主控台)
  1. https://console.aws.amazon.com/cloudformation 開啟 AWS CloudFormation 主控台。

  2. 在畫面頂端的導覽列上,選擇您的 AWS 區域。

  3. 從左側導覽窗格中,選擇匯出

列出已匯出的輸出值 (AWS CLI)

使用下列 list-exports 命令。Replace (取代) us-east-1 您的 AWS 區域。

aws cloudformation list-exports --region us-east-1

下列為範例輸出。

{ "Exports": [ { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-subnet-a", "Value": "subnet-07b410xmplddcfa03" }, { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-subnet-b", "Value": "subnet-075ed3xmplebd2fb1" }, { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-vpcid", "Value": "vpc-011d7xmpl100e9841" } ] }

CloudFormation 顯示目前區域匯出輸出的名稱和值,以及匯出輸出的堆疊。若要在另一個堆疊的範本中使用匯出的輸出值,您可以使用匯出名稱和 Fn::ImportValue 函數。

列出匯入匯出的輸出值的堆疊

若要刪除或變更匯出的輸出值,您必須先找出哪些堆疊正在匯入它們。

若要檢視匯入匯出輸出值的堆疊,請使用下列其中一種方法:

列出匯入匯出的輸出值的堆疊 (主控台)
  1. https://console.aws.amazon.com/cloudformation 開啟 AWS CloudFormation 主控台。

  2. 從左側導覽窗格中,選擇匯出

  3. 若要查看哪些堆疊匯入指定的匯出值,請選擇該匯出值的匯出名稱。 CloudFormation 會顯示匯出詳細資訊頁面,其中會列出匯入該值的所有堆疊。

列出匯入匯出的輸出值的堆疊 (AWS CLI)

使用 list-imports 命令。Replace (取代) us-east-1 使用 AWS 區域 和 private-vpc-vpcid搭配匯出輸出值的名稱。

aws cloudformation list-imports --region us-east-1 \ --export-name private-vpc-vpcid

CloudFormation 會傳回匯入值的堆疊清單。

{ "Imports": [ "my-app-stack" ] }

知道哪些堆疊正在匯入特定匯出值後,您需要修改這些堆疊,以移除參考輸出值的Fn::ImportValue函數。您必須移除所有參考匯出的輸出值的匯入,才能刪除或修改匯出的輸出值。