2025年2月6日に AWS CloudFormation の新機能「Stack Refactoring（スタックリファクタリング）」がリリースされた👏

運用中の AWS CloudFormation スタックでリソースの論理 ID を変更したり，リソースを別の AWS CloudFormation スタックに移動できる．ある程度の規模になると AWS CloudFormation スタックのリソースを見直したいな〜という場面もあって，今までだと「諦める」or「DeletionPolicy: Retainで紐付きを解除してからインポートする」という選択肢があったりした．

aws.amazon.com

今回はまず「同じ AWS CloudFormation スタックでリソースの論理 ID を変更する」を試す ＼( 'ω')／

準備

👾 template.yaml

まずは Amazon CloudWatch Logs ロググループを定義する．このとき論理 ID は Logsにしておく👌

AWSTemplateFormatVersion: 2010-09-09

Resources:Logs:Type: AWS::Logs::LogGroup
    Properties:LogGroupName: cfn-stack-refactoring-logical-id

そして aws cloudformation deployコマンドを使って AWS CloudFormation スタックをデプロイする．

$ aws cloudformation deploy \--stack-name cfn-stack-refactoring-logical-id \--template-file ./template.yaml

リファクタリング

👾 template.yaml

スタックリファクタリングではリファクタリング後の AWS CloudFormation テンプレートも必要になる．以下のように論理 ID を AwesomeLogsに変更した．今までだと，論理 ID を変更するとリソースの置換になってしまっていた🔥

AWSTemplateFormatVersion: 2010-09-09

Resources:AwesomeLogs:Type: AWS::Logs::LogGroup
    Properties:LogGroupName: cfn-stack-refactoring-logical-id

👾 refactor.json

次にリファクタリングの対象を指定する refactor.jsonを作る．今回は同じ AWS CloudFormation スタックになるため StackNameは cfn-stack-refactoring-logical-idで，LogicalResourceIdを Source（リファクタリング前）と Destination（リファクタリング後）で変更している👌

[{"Source": {"StackName": "cfn-stack-refactoring-logical-id",
      "LogicalResourceId": "Logs"
    },
    "Destination": {"StackName": "cfn-stack-refactoring-logical-id",
      "LogicalResourceId": "AwesomeLogs"
    }}]

実行する

スタックリファクタリングを実行する前に，まず aws cloudformation create-stack-refactorコマンドを使ってスタックリファクタリング ID を採番する．オプションとしては大きく3つ指定した👌

• --stack-definitions: スタック名と AWS CloudFormation テンプレート名（修正後）を指定する
• --no-enable-stack-creation: 新しく AWS CloudFormation スタックは作らない
• --resource-mappings: 作成した refactor.jsonを指定する

$ aws cloudformation create-stack-refactor \--stack-definitionsStackName=cfn-stack-refactoring-logical-id,TemplateBody@=file://template.yaml \--no-enable-stack-creation\--resource-mappings file://refactor.json
{"StackRefactorId": "1da7a9b6-bf69-4f7e-9e16-cb52eca39250"}

awscli.amazonaws.com

次は aws cloudformation describe-stack-refactorコマンドを使ってステータスを確認する．問題なければ以下のようになる．AWS CloudFormation テンプレートや refactor.jsonに誤りがあると ExecutionStatus: UNAVAILABLE / Status: CREATE_FAILEDと表示される💨 エラー原因は StatusReasonを参考に直していく．

$ aws cloudformation describe-stack-refactor \--stack-refactor-id 1da7a9b6-bf69-4f7e-9e16-cb52eca39250
{"StackRefactorId": "1da7a9b6-bf69-4f7e-9e16-cb52eca39250",
    "StackIds": ["arn:aws:cloudformation:ap-northeast-1:000000000000:stack/cfn-stack-refactoring-logical-id/7a806480-e6f7-11ef-86d1-0e4a804155dd"],
    "ExecutionStatus": "AVAILABLE",
    "Status": "CREATE_COMPLETE"}

awscli.amazonaws.com

最後は aws cloudformation execute-stack-refactorコマンドを使ってスタックリファクタリングを実行すれば完了👌

$ aws cloudformation execute-stack-refactor \--stack-refactor-id 1da7a9b6-bf69-4f7e-9e16-cb52eca39250

awscli.amazonaws.com

実行結果を確認する

おおお〜 ＼( 'ω')／

参考: AWS SAM x スタックリファクタリング

AWS CloudFormation でスタックリファクタリングを試した後に AWS SAM でも試してみたところ Resource ${LogicalId} in stack ${ARN} does not match the destination resource's properties.というエラーが出てしまった．sam packageコマンドで生成された .aws-sam/build/template.yamlには自動的に SamResourceIdというメタデータが付くため，差分をなくすために削除もしてみたけどエラーは解消できなかった．あと AWS::Serverless::Functionで自動生成する IAM Role のようなリソースがある場合も問題がありそうだった．今度再挑戦しよう〜💪

関連記事

aws.amazon.com