嵌套堆栈导入验证使用 AWS Management Console嵌套现有的堆栈使用 AWS CLI嵌套现有的堆栈

嵌套现有的堆栈

可以使用 resource import 功能将现有堆栈嵌套在另一个现有堆栈中。嵌套堆栈是您从其他模板中声明和引用的通用组件。这样，您就可以避免将相同的配置复制并粘贴到您的模板中，并简化堆栈更新。如果您具有通用组件的模板，您可以使用 AWS::CloudFormation::Stack 资源从另一个模板中引用该模板。有关嵌套堆栈的更多信息，请参阅使用嵌套堆栈将堆栈嵌入其他堆栈。

在使用 resource import 时，AWS CloudFormation 仅支持一层嵌套。这意味着，您无法将堆栈导入到子堆栈中，也无法导入具有子堆栈的堆栈。

如果您不熟悉导入，建议您先查看使用资源导入将 AWS 资源导入 CloudFormation 堆栈主题中的介绍信息。

嵌套堆栈导入验证

在嵌套堆栈导入操作期间，AWS CloudFormation 执行以下验证。

父堆栈模板中的嵌套 AWS::CloudFormation::Stack 定义与实际嵌套堆栈的模板匹配。
父堆栈模板中的嵌套 AWS::CloudFormation::Stack 定义的标签与实际嵌套堆栈资源的标签匹配。

使用 AWS Management Console嵌套现有的堆栈

使用 Retain DeletionPolicy 将 AWS::CloudFormation::Stack 资源添加到父堆栈模板中。在以下示例父堆栈模板中，MyNestedStack 是导入目标。

JSON


{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Resources" : {
    "ServiceTable":{
           "Type":"AWS::DynamoDB::Table",
           "Properties":{
              "TableName":"Service",
              "AttributeDefinitions":[
                 {
                    "AttributeName":"key",
                    "AttributeType":"S"
                 }
              ],
              "KeySchema":[
                 {
                    "AttributeName":"key",
                    "KeyType":"HASH"
                 }
              ],
              "ProvisionedThroughput":{
                 "ReadCapacityUnits":5,
                 "WriteCapacityUnits":1
              }
           }
        },
    "MyNestedStack" : {
      "Type" : "AWS::CloudFormation::Stack",
      "DeletionPolicy": "Retain",
      "Properties" : {
      "TemplateURL" : "https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template",
        "Parameters" : {
          "InstanceType" : "t1.micro",
          "KeyName" : "mykey"
        }
      }
    }
  }
}

YAML


AWSTemplateFormatVersion: 2010-09-09
Resources:
  ServiceTable:
    Type: 'AWS::DynamoDB::Table'
    Properties:
      TableName: Service
      AttributeDefinitions:
        - AttributeName: key
          AttributeType: S
      KeySchema:
        - AttributeName: key
          KeyType: HASH
      ProvisionedThroughput:
        ReadCapacityUnits: 5
        WriteCapacityUnits: 1
  MyNestedStack:
    Type: 'AWS::CloudFormation::Stack'
    DeletionPolicy: Retain
    Properties:
      TemplateURL: >-
        https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template
      Parameters:
        InstanceType: t1.micro
        KeyName: mykey

打开 AWS CloudFormation 控制台。
在 Stacks (堆栈) 页面上，在选择了父堆栈的情况下，选择 Stack actions (堆栈操作)，然后选择 Import resources into stack (将资源导入到堆栈)。
访问 Import overview (导入概述) 页面，以查看在该操作期间需要提供的内容列表。然后选择下一步。
在 Specify template (指定模板) 页面上，使用以下方法之一提供更新的父模板，然后选择 Next (下一步)。
- 选择 Amazon S3 URL，然后在文本框中指定您的模板的 URL。
- 选择 Upload a template file (上传模板文件)，然后浏览您的模板。
在 Identify resources (标识资源) 页面上，标识 AWS::CloudFormation::Stack 资源。
1. 在 Identifier property (标识符属性) 下面，选择资源标识符的类型。例如，可以使用 StackId 属性标识 AWS::CloudFormation::Stack 资源。
2. 在标识符值下，键入要导入的堆栈的 ARN。例如，arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10。
3. 选择下一步。
在 Specify stack details (指定堆栈详细信息) 页面上，修改任何参数，然后选择 Next (下一步)。这会自动创建一个更改集。

重要
如果您修改的现有参数启动创建、更新或删除操作，导入操作将失败。
在查看 MyParentStack 页面上，确认正在导入正确的资源，然后选择导入资源。这会自动执行在上一步中创建的更改集。此时，任何堆栈级标签将应用于导入的资源。
将显示父堆栈的 Stack details（堆栈详细信息）页面的 Events（事件）窗格。

注意
在该导入操作完成后，无需对父堆栈运行偏差检测，因为 AWS::CloudFormation::Stack 资源已由 AWS CloudFormation 进行管理。

使用 AWS CLI嵌套现有的堆栈

使用 Retain DeletionPolicy 将 AWS::CloudFormation::Stack 资源添加到父堆栈模板中。在以下示例父模板中，MyNestedStack 是导入目标。

JSON


{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Resources" : {
    "ServiceTable":{
           "Type":"AWS::DynamoDB::Table",
           "Properties":{
              "TableName":"Service",
              "AttributeDefinitions":[
                 {
                    "AttributeName":"key",
                    "AttributeType":"S"
                 }
              ],
              "KeySchema":[
                 {
                    "AttributeName":"key",
                    "KeyType":"HASH"
                 }
              ],
              "ProvisionedThroughput":{
                 "ReadCapacityUnits":5,
                 "WriteCapacityUnits":1
              }
           }
        },
    "MyNestedStack" : {
      "Type" : "AWS::CloudFormation::Stack",
      "DeletionPolicy": "Retain",
      "Properties" : {
      "TemplateURL" : "https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template",
        "Parameters" : {
          "InstanceType" : "t1.micro",
          "KeyName" : "mykey"
        }
      }
    }
  }
}

YAML


AWSTemplateFormatVersion: 2010-09-09
Resources:
  ServiceTable:
    Type: 'AWS::DynamoDB::Table'
    Properties:
      TableName: Service
      AttributeDefinitions:
        - AttributeName: key
          AttributeType: S
      KeySchema:
        - AttributeName: key
          KeyType: HASH
      ProvisionedThroughput:
        ReadCapacityUnits: 5
        WriteCapacityUnits: 1
  MyNestedStack:
    Type: 'AWS::CloudFormation::Stack'
    DeletionPolicy: Retain
    Properties:
      TemplateURL: >-
        https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template
      Parameters:
        InstanceType: t1.micro
        KeyName: mykey

编写 JSON 字符串，如以下示例所示，并进行以下修改：

将 MyNestedStack 替换为模板中指定的目标资源的逻辑 ID。
将 arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10 替换为要导入的堆栈的 ARN。


[{"ResourceType":"AWS::CloudFormation::Stack","LogicalResourceId":"MyNestedStack","ResourceIdentifier":{"StackId":"arn:aws:cloudformation:us-east-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10"}}]

或者，您也可以在配置文件中指定参数。

例如，要导入 MyNestedStack，可以创建一个包含以下配置的 ResourcesToImport.txt 文件。

JSON


[
  {
      "ResourceType":"AWS::CloudFormation::Stack",
      "LogicalResourceId":"MyNestedStack",
      "ResourceIdentifier": {
        "StackId":"arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10"
      }
  }
]

YAML


ResourceType: 'AWS::CloudFormation::Stack'
  LogicalResourceId: MyNestedStack
  ResourceIdentifier:
    StackId: >-
      arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10

要创建更改集，请使用以下 create-change-set 命令并替换占位符文本。对于 --change-set-type 选项，请指定 IMPORT 的值。对于 --resources-to-import 选项，将示例 JSON 字符串替换为您刚刚创建的实际 JSON 字符串。


aws cloudformation create-change-set \
    --stack-name MyParentStack --change-set-name ImportChangeSet \
    --change-set-type IMPORT \
    --template-body file://TemplateToImport.json \
    --resources-to-import '[{"ResourceType":"AWS::CloudFormation::Stack","LogicalResourceId":"MyNestedStack","ResourceIdentifier":{"StackId":"arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10"}}]'

注意

--resources-to-import 不支持内联 YAML。JSON 字符串中对转义引号的要求因终端而异。有关更多信息，请参阅《AWS Command Line Interface User Guide》中的 Using quotation marks inside strings。

或者，您可以使用文件 URL 作为 --resources-to-import 选项的输入内容，如以下示例所示。


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

如果成功，此命令将返回以下示例输出：


{
    "Id": "arn:aws:cloudformation:us-west-2:12345678910:changeSet/ImportChangeSet/8ad75b3f-665f-46f6-a200-0b4727a9442e",
    "StackId": "arn:aws:cloudformation:us-west-2:12345678910:stack/MyParentStack/4e345b70-1281-11ef-b027-027366d8e82b"
}

查看更改集，以确保导入正确的堆栈。


aws cloudformation describe-change-set --change-set-name ImportChangeSet

要启动更改集并将堆栈导入父源堆栈，请使用以下 execute-change-set 命令并替换占位符文本。此时，任何堆栈级标签将应用于导入的资源。在成功完成导入操作后 (IMPORT_COMPLETE)，将成功嵌套堆栈。
```
aws cloudformation execute-change-set --change-set-name ImportChangeSet
```
注意
在该导入操作完成后，无需对父堆栈运行偏差检测，因为 AWS::CloudFormation::Stack 资源已由 AWS CloudFormation 进行管理。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

在堆栈之间移动资源

恢复导入操作

嵌套现有的堆栈

嵌套堆栈导入验证

使用 AWS Management Console嵌套现有的堆栈

重要

注意

使用 AWS CLI嵌套现有的堆栈

注意

注意