從現有資源建立堆疊

登入 AWS Management Console ，並在 https：//https://console.aws.amazon.com/cloudformation 開啟 AWS CloudFormation 主控台。

在 Stacks (堆疊) 頁面上，選擇 Create stack (建立堆疊)，然後選擇 With existing resources (import resources) (使用現有資源 (匯入資源))。

請閱讀 Import overview (匯入概觀) 頁面，以取得您在此操作期間必須提供的項目清單。然後選擇下一步。

在 Specify template (指定範本) 頁面上，使用以下其中一種方法提供您的範本，然後選擇 Next (下一步)。

在 Identify resources (識別資源) 頁面上，識別每個目標資源。如需詳細資訊，請參閱資源識別符。

1. 在 Identifer property (識別碼屬性) 下方，選擇資源識別碼類型。例如，AWS::DynamoDB::Table 資源可以使用 TableName 屬性進行識別。

2. 在 Identifer value (識別碼值) 下方，輸入實際的屬性值。例如，範例範本中 GamesTable 資源的 TableName 是 Games。

3. 選擇 Next (下一步)。

在 Specify stack details (識別堆疊詳細資訊) 頁面上，修改任何參數，然後選擇 Next (下一步)。這會自動建立變更集合。

在 Review stack-name (檢閱 stack-name) 頁面上，確認您正在匯入正確的資源，然後選擇 Import resources (匯入資源)。這會自動執行在最後一個步驟中建立的變更集合。

隨即會顯示新堆疊 Stack details (堆疊詳細資訊) 頁面的 Events (事件) 窗格。

(選用) 在 堆疊上執行漂移偵測，確認範本和匯入資源的實際組態相符。如需偵測偏離的詳細資訊，請參閱在整個 CloudFormation 堆疊上偵測偏離。

(選用) 如果您匯入的資源與其預期的範本組態不相符，請修正範本組態，或是直接更新資源。在本演練中，我們會修正範本組態，使其與資源的實際組態相符。

1. 針對受影響的資源還原匯入操作。

2. 再次將匯入目標新增至您的範本，確認範本組態與實際組態相符。

3. 使用修改後的範本重複步驟 2 到 8，再次匯入資源。

若要了解哪些屬性可識別範本中的每個資源類型，請執行 get-template-summary命令，指定範本的 S3 URL。例如，AWS::DynamoDB::Table 資源可以使用 TableName 屬性進行識別。針對範例範本中的 GamesTable 資源，TableName 的值是 Games。在下一個步驟中，您將需要此資訊。

aws cloudformation get-template-summary \
    --template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json

如需詳細資訊，請參閱資源識別符。

使用下列 JSON 字串格式，編寫來自範本的實際資源清單及其唯一識別符。

[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]

您也可以在組態檔案中指定 JSON 格式參數。

例如，若要匯入 ServiceTable和 GamesTable，您可以建立包含下列組態的 ResourcesToImport.txt 檔案。

[
   {
      "ResourceType":"AWS::DynamoDB::Table",
      "LogicalResourceId":"GamesTable",
      "ResourceIdentifier":{
         "TableName":"Games"
      }
   },
   {
      "ResourceType":"AWS::DynamoDB::Table",
      "LogicalResourceId":"ServiceTable",
      "ResourceIdentifier":{
         "TableName":"Service"
      }
   }
]

若要建立變更集，請使用下列create-change-set命令並取代預留位置文字。對於 --change-set-type 選項，請指定值為 IMPORT。針對 --resources-to-import選項，將範例 JSON 字串取代為您剛建立的實際 JSON 字串。

aws cloudformation create-change-set \
    --stack-name TargetStack --change-set-name ImportChangeSet \
    --change-set-type IMPORT \
    --template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json \
    --resources-to-import '[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]'

或者，您可以使用檔案 URL 做為 --resources-to-import選項的輸入，如下列範例所示。

--resources-to-import file://ResourcesToImport.txt

檢閱變更集合，確認您將匯入正確的資源。

aws cloudformation describe-change-set \
    --change-set-name ImportChangeSet --stack-name TargetStack

若要啟動變更集並匯入資源，請使用下列execute-change-set命令並取代預留位置文字。成功完成操作 (IMPORT_COMPLETE) 後，資源便已順利匯入。

aws cloudformation execute-change-set \
    --change-set-name ImportChangeSet --stack-name TargetStack

(選用) 在 IMPORT_COMPLETE 堆疊上執行漂移偵測，確認範本和匯入資源的實際組態相符。如需偵測偏離的詳細資訊，請參閱在個別堆疊資源上偵測偏離。

1. 在指定的堆疊上執行偏離偵測。

   aws cloudformation detect-stack-drift --stack-name TargetStack

   如果成功，此命令會傳回下列範例輸出。

   { "Stack-Drift-Detection-Id" : "624af370-311a-11e8-b6b7-500cexample" }

2. 檢視指定堆疊偏離偵測 ID 的偏離偵測操作進度。

   aws cloudformation describe-stack-drift-detection-status \
       --stack-drift-detection-id 624af370-311a-11e8-b6b7-500cexample

3. 檢視已檢查指定堆疊中漂移之資源的漂移資訊。

   aws cloudformation describe-stack-resource-drifts --stack-name TargetStack

(選用) 如果您匯入的資源與其預期的範本組態不相符，請修正範本組態，或是直接更新資源。在本演練中，我們會修正範本組態，使其與資源的實際組態相符。

1. 針對受影響的資源還原匯入操作。

2. 再次將匯入目標新增至您的範本，確認範本組態與實際組態相符。

3. 使用修改後的範本重複步驟 3 – 6，以再次匯入資源。