野良リソースを「支配」せよ：CloudFormationスタックインポートで実現する、至高のインフラ管理術
こんにちは。インフラの世界へようこそ。
現場で長く戦っていると、必ずと言っていいほど直面するのが「IaC化されていない、誰が作ったかも分からない野良リソース」の存在です。これらは時として爆弾のように私たちの管理を脅かします。
今回は、AWS CloudFormationの奥義「スタックインポート（ImportExistingResources）」を使い、それらの野良リソースを「安全かつ確実に」IaCの管理下に引きずり込む、実戦的な技術を伝授します。
—
1. なぜ「インポート」が必要なのか？
通常、CloudFormationは「何もないところからリソースを作る」ためのものです。しかし、現実の現場では「既に動いているリソース」をIaC化しなければならない場面が多々あります。
手動で構築されたリソースを放置すると、ドリフト（構成の乖離）が発生し、いずれ障害の温床になります。スタックインポートをマスターすれば、既存の環境を破壊することなく、CloudFormationの管理下に組み込み、構成管理を「正」の状態へ導くことができるようになります。
—
2. 準備：インポートの「鉄の掟」
インポート作業は慎重に行う必要があります。まずは以下の3点を徹底してください。
1. 特定: 既存リソースの識別子（IDやARN）を正確に突き止める。
2. 整合: テンプレートに記述するプロパティ値が、現在のリソース設定と完全に一致していること（これを確認せずにインポートすると、スタック作成時に「設定の修正」が走り、本番環境が意図せず再構築される危険があります）。
3. タグの統一: 既存のタグとテンプレート上のタグを一致させる。
—
3. 実践：HelloWorld的なインポート手順
ここでは、既存のS3バケットをCloudFormationで管理する例を見てみましょう。
手順①：リソースの識別子を特定する
まず、マネジメントコンソールやAWS CLIで、インポートしたいリソースの物理ID（バケット名など）を正確にメモします。
手順②：最小構成のテンプレートを作成する
いきなり全てを書こうとせず、まずは最小限のプロパティでテンプレートを作成します。
template.yaml
AWSTemplateFormatVersion: ‘2010-09-09’
Description: “既存S3バケットを管理下に置くためのテンプレート”
Resources:
MyImportedBucket: # 論理ID：これはテンプレート内での名前です
Type: ‘AWS::S3::Bucket’
Properties:
BucketName: ‘my-production-bucket-name’ # ここが重要：既存の物理リソース名と一致させる
# 他にも設定がある場合は、現在の設定と完全に合わせる必要があります
手順③：スタックのインポートを実行する
1. CloudFormationコンソールを開く。
2. 「スタックの作成」ではなく「既存のリソースをインポート」を選択。
3. 作成したテンプレートをアップロード。
4. 識別子の指定: 「リソースの識別子」を入力する画面が出ます。ここで手順①で確認したバケット名を指定してください。
—
4. 現場で震えるほど役立つ「ハマりポイント」回避策
初心者が必ずと言っていいほど躓くポイントを、先輩として先回りして伝授します。
論理IDの割り当てミス
テンプレート内の「論理ID（`MyImportedBucket`のような名前）」は、一度確定すると後から変更できません。将来的な拡張を考え、命名規則（例：`ProjectNameEnvironmentResourceName`）をチームで決めてから着手してください。
属性の不一致による「置換」の恐怖
インポート中、CloudFormationは「テンプレートの設定」と「実物」を照合します。ここで値が異なると、CloudFormationは「ああ、設定変更が必要なんだな」と解釈し、リソースの削除と再作成を試みる場合があります。
- 対策: テンプレートを書く前に、`aws s3api get-bucket-tagging` や `get-bucket-policy` 等のコマンドを駆使し、実物の設定をテンプレートに「完全にトレース」してください。
—
5. まとめ：これがインフラエンジニアの「支配力」
インポート操作は、単なるツールの機能ではありません。「混沌とした手動環境から、秩序ある自動化環境へ移行する」ための重要な儀式です。
1. まずは既存設定を徹底的に調査する
2. 最小限の定義からインポートを試みる
3. インポート成功後、必要な変更を段階的に加えていく
このステップを繰り返せば、あなたの管理するインフラは必ず鉄壁のものになります。まずは、検証環境にある小さなリソースから、この「支配の感覚」を体験してみてください。
インフラ管理が「苦行」から「設計を楽しむ作業」に変わる瞬間、きっとあなたもエンジニアとして一つ上のステージに登っているはずです。応援していますよ！