스택 간 리소스 이동 - AWS CloudFormation
AWS Management Console을 사용하여 스택 리팩터링AWS CLI을 사용하여 스택 리팩터링

스택 간 리소스 이동

resource import 기능을 사용하여 스택간에 리소스를 이동하거나 스택을 리팩터링할 수 있습니다. 소스 스택에서 제거한 후 대상 스택으로 가져오기를 할 때 리소스가 보존되도록 하려면 먼저 이동시키려는 리소스에 Retain 삭제 정책을 추가해야 합니다.

가져오기를 처음 사용하는 경우 먼저 리소스 가져오기를 사용하여 AWS 리소스를 CloudFormation 스택으로 가져오기 주제의 소개 정보를 검토하는 것이 좋습니다.

중요

모든 리소스가 가져오기 작업을 지원하는 것은 아닙니다. 스택에서 리소스를 제거하기 전에 가져오기 작업을 지원하는 리소스를 참조하세요. 스택에서 가져오기 작업을 지원하지 않는 리소스를 제거하면 리소스를 다른 스택으로 가져오거나 원본 스택으로 다시 가져올 수 없습니다.

AWS Management Console을 사용하여 스택 리팩터링

  1. 소스 템플릿에서 이동시킬 리소스에 대한 Retain DeletionPolicy를 지정합니다.

    다음 예제 소스 템플릿에서 Games은 이 리팩터의 대상입니다.

    예 JSON
    {
    "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
                }
            }
        }
    }
}

  2. CloudFormation 콘솔을 열어 스택 업데이트를 수행하여 삭제 정책을 적용합니다.

    1. 스택(Stacks) 페이지에서 스택을 선택하고 업데이트(Update)를 선택합니다.

    2. Prepare template(템플릿 준비)에서 Replace current template(현재 템플릿 바꾸기)을 선택합니다.

    3. Specify template(템플릿 지정)에서 GamesTable에 DeletionPolicy 속성이 설정된 업데이트된 소스 템플릿을 제공한 후, 다음을 선택합니다.

      • Amazon S3 URL을 선택한 다음 텍스트 상자에 업데이트된 소스 템플릿의 URL을 지정합니다.

      • 템플릿 파일 업로드를 선택한 다음 업데이트된 소스 템플릿 파일을 찾습니다.

    4. Specify stack details(스택 세부 정보 지정) 페이지에서 어떤 변경도 필요하지 않습니다. Next(다음)를 선택합니다.

    5. Configure stack options(스택 옵션 구성) 페이지에서 어떤 변경도 필요하지 않습니다. Next(다음)를 선택합니다.

    6. SourceStackName 검토 페이지에서 변경 사항을 검토합니다. 템플릿에 IAM 리소스가 포함되어 있는 경우 이 템플릿이 IAM 리소스를 생성할 수 있음을 확인합니다(I acknowledge that this template may create IAM resources)를 선택하여 템플릿에서 IAM 리소스를 사용하도록 지정합니다. 템플릿에서 IAM 리소스를 사용하는 방법에 대한 자세한 내용은 AWS Identity and Access Management를 사용하여 CloudFormation 액세스 제어 단원을 참조하십시오. 그런 다음 변경 세트를 생성하여 소스 스택을 업데이트하거나 소스 스택을 직접 업데이트하십시오.

  3. 소스 템플릿에서 리소스, 관련 파라미터 및 출력을 제거한 다음, 이들을 대상 템플릿에 추가합니다.

    이제 소스 템플릿이 다음과 같이 보입니다.

    예 JSON
    {
    "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
              }
           }
        }
    }
}

    현재 다음과 같은 예제 대상 템플릿에는 PlayersTable 리소스가 있으며 GamesTable도 포함되어 있습니다.

    예 JSON
    {
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "Import test",
    "Resources": {
        "PlayersTable": {
            "Type": "AWS::DynamoDB::Table",
            "Properties": {
                "TableName": "Players",
                "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
                }
            }
        }
    }
}

  4. 2~3단계를 반복하여 소스 스택을 다시 업데이트합니다. 이번에는 대상 리소스를 스택에서 삭제합니다.

  5. 가져오기 작업을 수행하여 대상 스택에 GamesTable을 추가합니다.

    1. 스택 페이지에서 상위 스택을 선택한 상태에서 Stack actions(스택 작업)를 선택한 다음 Import resources into stack(스택으로 리소스 가져오기)을 선택합니다.

      콘솔의 스택으로 리소스 가져오기 옵션.

    2. 이 작업 중에 제공해야 하는 항목 목록은 Import overview(가져오기 개요) 페이지를 참조하십시오. 그리고 다음을 선택합니다.

    3. Specify template(템플릿 지정) 페이지에서 다음 중 하나를 완료한 후 Next(다음)를 선택합니다.

      • Amazon S3 URL을 선택한 다음, 텍스트 상자에 URL을 지정합니다.

      • 템플릿 파일 업로드를 선택한 다음 업로드할 파일을 찾습니다.

    4. Identify resources(리소스 식별) 페이지에서 이동 중인 리소스를 식별합니다(이 예제에서는 GamesTable). 자세한 내용은 리소스 식별자 단원을 참조하십시오.

      1. Identifier property(식별자 속성)에서 리소스 식별자의 유형을 선택합니다. 예를 들어 AWS::DynamoDB::Table 리소스는 TableName 속성을 사용하여 식별할 수 있습니다.

      2. Identifier value(식별자 값)에서 실제 속성값을 입력합니다. 예: GamesTables.

      3. Next(다음)를 선택합니다.

    5. Specify stack details(스택 세부 정보 지정) 페이지에서 어떤 파라미터든 수정하고 다음을 선택합니다. 이렇게 하면 변경 세트가 자동으로 생성됩니다.

      중요

      생성, 업데이트 또는 삭제 작업을 시작하는 기존 파라미터를 수정하면 가져오기 작업이 실패합니다.

    6. TargetStackName 검토 페이지에서 올바른 리소스를 가져오고 있는지 확인한 다음 리소스 가져오기를 선택합니다. 그러면 마지막 단계에서 생성된 변경 세트가 자동으로 시작됩니다. 이때 어떤 스택 레벨 태그든 가져온 리소스에 적용됩니다.

    7. 상위 스택에 대한 Stack details(스택 세부 정보) 페이지의 Events(이벤트) 창이 표시됩니다.

      콘솔의 이벤트 탭.
      참고

      AWS::CloudFormation::Stack 리소스가 이미 CloudFormation에서 관리되기 때문에 이러한 가져오기 작업을 수행한 후에 상위 스택에서 드리프트 감지를 실행할 필요가 없습니다.

AWS CLI을 사용하여 스택 리팩터링

  1. 소스 템플릿에서 이동시킬 리소스에 대한 Retain DeletionPolicy를 지정합니다.

    다음 예제 소스 템플릿에서 GamesTable은 이 리팩터의 대상입니다.

    예 JSON
    {
    "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
                }
            }
        }
    }
}

  2. 소스 스택을 업데이트하여 삭제 정책을 리소스에 적용합니다.

    aws cloudformation update-stack --stack-name SourceStackName

  3. 소스 템플릿에서 리소스, 관련 파라미터 및 출력을 제거한 다음, 이들을 대상 템플릿에 추가합니다.

    이제 소스 템플릿이 다음과 같이 보입니다.

    예 JSON
    {
    "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
              }
           }
        }
    }
}

    현재 다음과 같은 예제 대상 템플릿에는 PlayersTable 리소스가 있으며 GamesTable도 포함되어 있습니다.

    예 JSON
    {
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "Import test",
    "Resources": {
        "PlayersTable": {
            "Type": "AWS::DynamoDB::Table",
            "Properties": {
                "TableName": "Players",
                "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
                }
            }
        }
    }
}

  4. 소스 스택을 업데이트하여 GamesTable 리소스 및 관련 파라미터와 출력을 스택에서 삭제합니다.

    aws cloudformation update-stack --stack-name SourceStackName

  5. 가져올 실제 리소스 목록과 고유 식별자를 다음 JSON 문자열 형식으로 작성합니다. 자세한 내용은 리소스 식별자 단원을 참조하십시오.

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

    또는 구성 파일에서 JSON 형식 파라미터를 지정할 수 있습니다.

    예를 들어 GamesTable을 가져오려면 다음 구성이 포함된 ResourcesToImport.txt 파일을 만들 수 있습니다.

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

  6. 변경 세트를 생성하려면 다음 create-change-set 명령을 사용하고 자리 표시자 텍스트를 변경합니다. --change-set-type 옵션의 경우, IMPORT의 값을 지정합니다. --resources-to-import 옵션의 경우 샘플 JSON 문자열을 방금 생성한 실제 JSON 문자열로 바꿉니다.

    aws cloudformation create-change-set \
    --stack-name TargetStackName --change-set-name ImportChangeSet \
    --change-set-type IMPORT \
    --template-body file://TemplateToImport.json \
    --resources-to-import "'[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}}]'"
    참고

    --resources-to-import에서는 인라인 YAML을 지원하지 않습니다. JSON 문자열의 인용 부호 요구 사항은 터미널에 따라 다릅니다. 자세한 내용은 AWS Command Line Interface 사용 설명서의 문자열 안에 따옴표 사용을 참조하세요.

    또는 다음 예제와 같이 --resources-to-import 옵션에 대한 입력으로 파일 URL을 사용할 수 있습니다.

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

  7. 변경 세트를 검토하여 올바른 리소스를 대상 스택에 가져오고 있는지 확인합니다.

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

  8. 변경 세트를 시작하고 리소스를 가져오려면 다음 execute-change-set 명령을 사용하고 자리 표시자 텍스트를 변경합니다. 이때 어떤 스택 레벨 태그든 가져온 리소스에 적용됩니다. 작업 (IMPORT_COMPLETE)가 성공적으로 완료되면 리소스가 성공적으로 가져오기 됩니다.

    aws cloudformation execute-change-set \
    --change-set-name ImportChangeSet --stack-name TargetStackName
    참고

    리소스가 이미 CloudFormation에서 관리되기 때문에 이러한 가져오기 작업을 수행한 후에 대상 스택에서 드리프트 감지를 실행할 필요가 없습니다.