範例範本使用將現有資源匯入堆疊 AWS 管理主控台使用將現有資源匯入堆疊 AWS CLI

將現有資源匯入堆疊

本主題說明如何透過在範本中描述現有資源，將現有 AWS 資源匯入現有堆疊。若要改為掃描現有資源並自動產生範本，以用於將現有資源匯入 CloudFormation 或在新帳戶中複製資源，請參閱使用 IaC 產生器從現有資源中產生範本。

先決條件

開始之前，您必須準備好以下項目：

描述整個堆疊的範本，包括已是堆疊一部分的資源，以及要匯入的資源。在本機或 Amazon S3 儲存貯體中儲存範本。

取得執行中堆疊範本的副本
1. 開啟位在 https://console.aws.amazon.com/cloudformation/ 的 CloudFormation 主控台。
2. 從堆疊清單中，選擇要從中擷取範本的堆疊。
3. 在堆疊詳細資訊窗格中，選擇範本索引標籤，再選擇複製到剪貼簿。
4. 將程式碼貼到文字編輯器中，以開始將其他資源新增至範本。
對於每個您要匯入的資源，需包含下列項目：
- 定義資源目前組態的屬性與屬性數值。
- 資源的唯一識別碼，如資源名稱。如需詳細資訊，請參閱資源識別碼。
- DeletionPolicy 屬性。

範例範本

在此逐步說明中，我們假設您使用下列名為 TemplateToImport.json 的範例範本，指定兩個 DynamoDB 資料表。GamesTable 目前是堆疊的一部分，而 ServiceTable 是您要匯入的資料表。

注意

此範本僅供範例參考。若要用於自身測試，請將範例資源替換為您帳戶中的資源。


{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "Import test",
    "Resources": {
        "ServiceTable": {
            "Type": "AWS::DynamoDB::Table",
            "Properties": {
                "TableName": "Service",
                "AttributeDefinitions": [
                    {
                        "AttributeName": "key",
                        "AttributeType": "S"
                    }
                ],
                "KeySchema": [
                    {
                        "AttributeName": "key",
                        "KeyType": "HASH"
                    }
                ],
                "ProvisionedThroughput": {
                    "ReadCapacityUnits": 5,
                    "WriteCapacityUnits": 1
                }
            }
        },
        "GamesTable": {
            "Type": "AWS::DynamoDB::Table",
            "DeletionPolicy": "Retain",
            "Properties": {
                "TableName": "Games",
                "AttributeDefinitions": [
                    {
                        "AttributeName": "key",
                        "AttributeType": "S"
                    }
                ],
                "KeySchema": [
                    {
                        "AttributeName": "key",
                        "KeyType": "HASH"
                    }
                ],
                "ProvisionedThroughput": {
                    "ReadCapacityUnits": 5,
                    "WriteCapacityUnits": 1
                }
            }
        }
    }
}

使用將現有資源匯入堆疊 AWS 管理主控台

注意

CloudFormation 主控台不支援在匯入資源時使用內建函數 Fn::Transform。您可以使用 AWS CLI 匯入使用 Fn::Transform函數的資源。

登入 AWS 管理主控台並在 https：//https://console.aws.amazon.com/cloudformation 開啟 CloudFormation 主控台。
在 Stacks (堆疊) 頁面上，選擇您要匯入資源的堆疊。
選擇 Stack actions (堆疊動作)，然後選擇 Import resources into stack (將資源匯入堆疊)。
檢閱 Import overview (匯入概觀) 頁面，然後選擇 Next (下一步)。
在 Specify template (指定範本) 頁面上，使用以下其中一種方法提供您更新後的範本，然後選擇 Next (下一步)。
- 選擇 Amazon S3 URL，然後在文字方塊中為您的範本指定 URL。
- 選擇 Upload a template file (上傳範本檔案)，然後瀏覽您的範本。
在 Identify resources (識別資源) 頁面上，識別每個目標資源。如需詳細資訊，請參閱資源識別碼。
1. 在 Identifer property (識別碼屬性) 下方，選擇資源識別碼類型。例如，AWS::DynamoDB::Table 資源可以使用 TableName 屬性進行識別。
2. 在 Identifer value (識別碼值) 下方，輸入實際的屬性值。例如，範例範本中 GamesTable 資源的 TableName 是 Games。
3. 選擇下一步。
在 Specify stack details (識別堆疊詳細資訊) 頁面上，更新任何參數，然後選擇 Next (下一步)。這會自動建立變更集合。

注意
如果您修改了啟動建立、更新或刪除操作的現有參數，匯入操作便會失敗。
在 Review stack-name (檢閱 stack-name) 頁面上，檢閱要匯入的資源，然後選擇 Import resources (匯入資源)。這會自動執行在最後一個步驟中建立的變更集合。此時會將任何堆疊層級標籤套用到匯入的資源。如需詳細資訊，請參閱設定堆疊選項。

隨即會顯示堆疊的 Events (事件) 頁面。
(選用) 在堆疊上執行漂移偵測，確認範本和匯入資源的實際組態相符。如需關於偵測漂移的詳細資訊，請參閱在整個 CloudFormation 堆疊上偵測偏離。
(選用) 如果您匯入的資源與其預期的範本組態不相符，請修正範本組態，或是直接更新資源。如需有關匯入漂移資源的詳細資訊，請參閱透過匯入作業解決漂移。

使用將現有資源匯入堆疊 AWS CLI

若要了解範本中哪些屬性用於識別每種資源類型，請執行 get-template-summary 命令，並指定範本的 S3 網址。例如，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"}}]

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

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


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

要建立變更集，請使用下列 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"}}]'
```
注意
--resources-to-import 不支援內嵌 YAML。JSON 字串中轉義引號的請求有所不同，這取決於您的終端。如需詳細資訊，請參閱《AWS Command Line Interface 使用者指南》中的在字串內使用引號。

或者，您可以如下列範例所示，使用檔案 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 堆疊上執行漂移偵測，確認範本和匯入資源的實際組態相符。如需關於偵測漂移的詳細資訊，請參閱在整個 CloudFormation 堆疊上偵測偏離。
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
```
(選用) 如果您匯入的資源與其預期的範本組態不相符，請修正範本組態，或是直接更新資源。如需有關匯入漂移資源的詳細資訊，請參閱透過匯入作業解決漂移。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

從現有資源建立堆疊

在堆疊之間移動資源

將現有資源匯入堆疊

主題

範例 範本

注意

使用 將現有資源匯入堆疊 AWS 管理主控台

注意

注意

使用 將現有資源匯入堆疊 AWS CLI

注意

範例範本

使用將現有資源匯入堆疊 AWS 管理主控台

使用將現有資源匯入堆疊 AWS CLI