やあ。インフラの深淵を覗き込み、IaCという名のコードでクラウドを操る君へ。
今日は、AWS CloudFormationの「最終兵器」とも言えるCloudFormation Macroについて語ろうと思う。
多くのエンジニアは、CloudFormationのテンプレートが長大になり、YAMLの海で溺れそうになった経験があるはずだ。そんなとき、君ならどうする？ Ansibleで無理やり補完する？ CDKTFに逃げる？ いや、CloudFormationの流儀の中で解決しよう。それが「Macro」だ。
—
1. Macroとは何か？：テンプレートの「プリプロセッサ」
CloudFormation Macroは、一言で言えば「テンプレートをデプロイする直前に、Lambdaでコードを書き換える機能」だ。
例えば、独自の構文（`!MyCustomResource`のようなもの）をテンプレートに埋め込み、デプロイ時にそれをAWS標準のリソース定義に変換する。つまり、君が「自分だけのCloudFormation DSL（ドメイン固有言語）」を作れるということだ。
これができるようになると、冗長なIAMポリシーの記述や、複雑なリソースのタグ付けを一瞬で抽象化できる。まさに、インフラ管理の次元が変わる瞬間だ。
—
2. Transform関数の仕組みとLambda実装
Macroの心臓部はLambda関数だ。AWSはテンプレート全体をJSON形式でLambdaに投げ込む。LambdaはそのJSONをパースし、君が望む形に加工して、再びJSONとして返す。
手順の基本構成
1. Lambdaの作成: テンプレートを加工するロジックを記述。
2. 変換関数の登録: `AWS::CloudFormation::Macro` リソースを作成し、Lambdaを登録。
3. 呼び出し: テンプレートの冒頭に `Transform: [MacroName]` を書く。
—
3. ハンズオン：冗長なタグ付けを自動化する「AutoTagMacro」
「全ての開発環境リソースに、自動で `Env: Dev` と `Owner: TeamA` を付与したい」――現場でよくある悩みだ。これをマクロで解決しよう。
ステップ1：Lambda関数の作成 (Python)
import json
def handler(event, context):
# テンプレート全体が event[‘fragment’] に入っている
fragment = event[‘fragment’]
# テンプレート内の全リソースを走査する
resources = fragment.get(‘Resources’, {})
for res_name, res_body in resources.items():
# Tagsがない場合は初期化
if ‘Properties’ in res_body and ‘Tags’ not in res_body[‘Properties’]:
res_body[‘Properties’][‘Tags’] = []
# 自動的にタグを追加
res_body[‘Properties’][‘Tags’].append({‘Key’: ‘Env’, ‘Value’: ‘Dev’})
res_body[‘Properties’][‘Tags’].append({‘Key’: ‘Owner’, ‘Value’: ‘TeamA’})
return {
‘requestId’: event[‘requestId’],
‘status’: ‘success’,
‘fragment’: fragment # 加工済みのテンプレートを返す
}
ステップ2：Macroの登録 (別のテンプレートでデプロイ)
Resources:
AutoTagMacro:
Type: AWS::CloudFormation::Macro
Properties:
Name: AutoTagMacro # この名前で呼び出す
FunctionName: !GetAtt MyLambdaFunction.Arn
ステップ3：利用するテンプレート
Transform: AutoTagMacro # ここで魔法がかかる
Resources:
MyS3Bucket:
Type: AWS::S3::Bucket
Properties:
BucketName: my-super-cool-bucket
たったこれだけで、デプロイ時には `MyS3Bucket` に自動でタグが付与される。テンプレートをコピペする必要はもうない。
—
4. 運用上の注意点とトラブルシューティング
この強力な力には、当然「責任」が伴う。現場でハマらないための知見を授けよう。
- 冪等性の担保: マクロ内での処理は必ず「既にタグがある場合は無視する」といった冪等性を意識すること。二重にタグを付与しようとすると失敗するぞ。
- デバッグの難しさ: マクロが失敗すると、CloudFormationは「テンプレートが不正」としか言わない。CloudWatch Logsを確認するのは大前提だ。開発中は、`event`の中身をJSONログに出力する癖をつけろ。
- 循環参照の回避: マクロ自体を管理するスタックと、マクロを利用するスタックは分けること。マクロが自分自身を変換しようとすると……地獄を見るぞ。
- 可読性の低下: あまりに複雑なマクロを作ると、誰にも中身がわからなくなる。マクロは「あくまで単純な置換」に留めるのが、長続きするインフラの秘訣だ。
—
最後に：君のインフラを「コード」以上にしよう
CloudFormation Macroを使いこなすということは、君が単なる「設定ファイルの記述者」から、「インフラプラットフォームの設計者」へ進化することを意味する。
「面倒だな」と思った瞬間が、マクロを書くチャンスだ。
この技術をマスターして、毎日の作業を楽にするだけでなく、チームのIaCレベルを一段引き上げてやってくれ。
何か困ったことがあれば、いつでもまた聞きに来るといい。君の挑戦を応援しているぞ。