AWS リソースを CloudFormation スタックに自動でインポートする
CloudFormation スタックを作成または更新するときに、名前付きリソースを自動的にインポートできるようになりました。名前付きリソースとはカスタム名を持つリソースのことです。詳細については、「CloudFormation テンプレートリファレンス」の「Name タイプ」を参照してください。
自動インポートを開始すると、CloudFormation がテンプレートに一致する既存のリソースをチェックし、それらをデプロイ中にインポートします。ネストされたスタックの場合は、ルートスタックから変更セットを作成します。
インポートが完了した後、後続のスタックオペレーションを実行する前に、インポートされたリソースでドリフト検出を実行することをお勧めします。ドリフト検出により、テンプレート構成が実際の構成と一致することが保証されます。詳細については、「CloudFormation スタック全体のドリフトを検出する」を参照してください。
リソースをインポートするときは、次の要件を満たす必要があります。
-
リソースに、テンプレートで定義した静的カスタム名が付いていること。動的な名前 (!Ref または他の 関数を使用) は現在サポートされていません。
-
リソースに
RetainまたはRetainExceptOnCreateのDeletionPolicyがあること。 -
リソースが 別の CloudFormation スタックに属していないこと。
-
リソースタイプが CloudFormation のインポートオペレーションをサポートしていること。詳細については、「リソースタイプのサポート」を参照してください。
-
リソースタイプのプライマリ ID または追加の識別子はテンプレートにある必要があります。読み取り専用プロパティを持つプライマリ ID と追加の識別子はサポートされていません。タイプに対するプライマリ ID または追加の識別子を確認するには、リソーススキーマで
primaryIdentifierプロパティまたはadditionalIdentifiersプロパティを探します。詳細については、リソースタイプ定義スキーマを参照してください。
例自動インポートの例
次の例では、変更セット CreateChangeSet を使用して、テンプレートファイル template.yaml に基づいて my-stack という名前のスタックを作成し、一致するリソースを自動的にインポートします。
aws cloudformation create-change-set \ --stack-namemy-stack\ --change-set-nameCreateChangeSet\ --change-set-type CREATE \ --template-bodyfile://template.yaml\ --import-existing-resources
トラブルシューティング
自動インポートが失敗した場合は、以下を実行してトラブルシューティングを行います。
テンプレートのリソース名がリソースの名前と正確に一致していることを確認する。
リソースがまだ別のスタックで管理されていないことを確認する。
リソースタイプが自動インポートをサポートしていることを確認する。
リソースタイプに必要なすべてのプロパティがテンプレートに含まれていることを確認する。
サポートされているリソースタイプ
次の表に、自動インポートを現在サポートしている AWS リソースタイプを示します。
