既存のリソースからのスタックの作成

AWS Management Console にサインインし、AWS CloudFormation コンソール (https://console.aws.amazon.com/cloudformation) を開きます。

[スタック] ページで、[スタックを作成] を選択し、[With existing resources (import resources) (既存のリソースを使用（リソースのインポート）)] を選択します。

[Import overview (インポートの概要)] ページを参照して、このオペレーション中に指定する必要がある項目の一覧を確認してください。[次へ] を選択します。

[Specify template (テンプレートを指定)] ページで、以下のいずれかの方法を使用してテンプレートを指定し、[次へ] を選択します。

[Identify resources (リソースの識別)] ページで、各ターゲットリソースを識別します。詳細については、「リソース識別子」を参照してください。

1. [Identifier property (識別子のプロパティ)] で、リソース識別子のタイプを選択します。たとえば、AWS::DynamoDB::Table リソースは TableName プロパティを使用して識別できます。

2. [Identifier value (識別子の値)] に、実際のプロパティ値を入力します。たとえば、サンプルテンプレートの GamesTable リソースの TableName は Games です。

3. [次へ] を選択します。

[Specify stack details (スタック詳細の指定)] ページで、任意のパラメータを変更し、[次へ] を選択します。これにより、変更セットが自動的に作成されます。

[Review stack_name (stack_name の確認)] ページで、インポートしようとしているリソースが正しいことを確認し、[Import resources (リソースのインポート)] を選択します。これにより、最後のステップで作成した変更セットが自動的に実行されます。

新しいスタックの [Stack details] (スタックの詳細) ページの [Events] (イベント) ペインが表示されます。

（オプション） スタックでドリフト検出を実行し、インポートされたリソースのテンプレートと実際の構成が一致していることを確認します。ドリフト検出の詳細については、「CloudFormation スタック全体のドリフトを検出する」を参照してください。

（オプション）インポートしたリソースが予想されるテンプレート構成と一致しない場合は、テンプレート構成を修正するか、リソースを直接更新します。このチュートリアルでは、テンプレートの構成を実際の構成に合わせて修正します。

1. 影響を受けるリソースのインポートオペレーションを元に戻します。

2. インポートターゲットをテンプレートに再度追加して、テンプレートの構成が実際の構成と一致していることを確認します。

3. 変更したテンプレートを使用してステップ 2～8 を繰り返し、リソースを再度インポートします。

テンプレート内の各リソースタイプを識別するプロパティを知るには、テンプレートの S3 URL を指定して get-template-summary コマンドを実行します。たとえば、AWS::DynamoDB::Table リソースは TableName プロパティを使用して識別できます。サンプルテンプレートの GamesTable リソースの場合、TableName の値は Games です。この情報は、次のステップで必要になります。

aws cloudformation get-template-summary \
    --template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json

詳細については、「リソース識別子」を参照してください。

テンプレートから実際のリソースとそれらの一意の識別子のリストを次の JSON 文字列形式で作成します。

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

または、設定ファイルで JSON 形式のパラメータを指定することもできます。

例えば、ServiceTable と GamesTable をインポートするには、次の設定を含む ResourcesToImport.txt ファイルを作成することが考えられます。

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

変更セットを作成するには、次の create-change-set コマンドを使用してプレースホルダーテキストを置き換えます。--change-set-type オプションの場合、IMPORT の値を指定します。--resources-to-import オプションでは、サンプルの JSON 文字列を、作成した実際の JSON 文字列に置き換えます。

aws cloudformation create-change-set \
    --stack-name TargetStack --change-set-name ImportChangeSet \
    --change-set-type IMPORT \
    --template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json \
    --resources-to-import '[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]'

または、次の例に示すように、ファイル URL を --resources-to-importオプションの入力として使用できます。

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

変更セットを確認し、正しいリソースがインポートされることを確認します。

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

変更セットを開始してリソースをインポートするには、次の execute-change-set コマンドを使用してプレースホルダーテキストを置き換えます。オペレーション (IMPORT_COMPLETE) が正常に完了すると、リソースは正常にインポートされています。

aws cloudformation execute-change-set \
    --change-set-name ImportChangeSet --stack-name TargetStack

（オプション）IMPORT_COMPLETE スタックでドリフト検出を実行し、インポートされたリソースのテンプレートと実際の構成が一致していることを確認します。ドリフト検出に関する詳細は、「個々のスタックリソースのドリフトを検出」を参照してください。

1. 指定されたスタックでドリフト検出を実行します。

   aws cloudformation detect-stack-drift --stack-name TargetStack

   正常に完了した場合、このコマンドは次のサンプル出力を返します。

   { "Stack-Drift-Detection-Id" : "624af370-311a-11e8-b6b7-500cexample" }

2. 指定されたスタックドリフト検出 ID のドリフト検出オペレーションの進行状況を表示します。

   aws cloudformation describe-stack-drift-detection-status \
       --stack-drift-detection-id 624af370-311a-11e8-b6b7-500cexample

3. 指定されたスタック内でドリフトが確認されたリソースのドリフト情報を表示します。

   aws cloudformation describe-stack-resource-drifts --stack-name TargetStack

（オプション）インポートしたリソースが予想されるテンプレート構成と一致しない場合は、テンプレート構成を修正するか、リソースを直接更新します。このチュートリアルでは、テンプレートの構成を実際の構成に合わせて修正します。

1. 影響を受けるリソースのインポートオペレーションを元に戻します。

2. インポートターゲットをテンプレートに再度追加して、テンプレートの構成が実際の構成と一致していることを確認します。

3. 変更したテンプレートを使用してステップ 3～6 を繰り返し、リソースを再度インポートします。