cdk import - AWS Cloud Development Kit (AWS CDK) v2
使用方法引数オプション

これは AWS CDK v2 デベロッパーガイドです。古い v1 CDK は 2022 年 6 月 1 日にメンテナンスを開始し、2023 年 6 月 1 日にサポートを終了しました。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

cdk import

AWS CloudFormation リソースインポートを使用して、既存の AWS リソースをCDKスタックにインポートします。

このコマンドを使用すると、他のメソッドを使用して作成された既存のリソースを取得し、 を使用してそれらの管理を開始できます AWS CDK。

リソースCDKを管理に移行することを検討する場合、IAMロール、Lambda 関数、イベントルールなどを使用して新しいリソースを作成することが許容されることがあります。Amazon S3 バケットや DynamoDB テーブルなどのステートフルリソースなどの他のリソースでは、新しいリソースを作成すると、サービスに影響を与える可能性があります。を使用してcdk import、サービスの中断を最小限に抑えながら、既存のリソースをインポートできます。サポートされている AWS リソースのリストについては、「 ユーザーガイド」の「リソースタイプのサポート」を参照してください。 AWS CloudFormation

既存のリソースをCDKスタックにインポートするには

  1. を実行してcdk diff、CDKスタックに保留中の変更がないことを確認します。を実行する場合cdk import、インポートオペレーションで許可される変更は、インポートされる新しいリソースの追加のみです。

  2. スタックにインポートするリソースのコンストラクトを追加します。例えば、Amazon S3 バケットに以下を追加します。

    new s3.Bucket(this, 'ImportedS3Bucket', {});

    その他の変更は追加しないでください。また、リソースが現在持っている状態を正確にモデル化する必要があります。バケットの例では、 AWS KMS キー、ライフサイクルポリシー、およびバケットに関連するその他のものを必ず含めてください。それ以外の場合、後続の更新オペレーションは期待どおりに動作しない可能性があります。

  3. cdk import を実行します。CDK アプリケーションに複数のスタックがある場合は、特定のスタック名を引数として渡します。

  4. の CDK CLI は、インポートするリソースの実際の名前を渡すように求められます。この情報を入力すると、インポートが開始されます。

  5. cdk import が成功を報告すると、リソースは によって管理されますCDK。コンストラクト設定のその後の変更は、リソースに反映されます。

この機能には現在、以下の制限があります。

  • ネストされたスタックにリソースをインポートすることはできません。

  • 指定したプロパティが、インポートされたリソースに対して正しく完全かどうかは確認されません。インポート後にドリフト検出オペレーションを開始してみてください。

  • 他のリソースに依存するリソースはすべて、正しい順序でまとめて、または個別にインポートする必要があります。それ以外の場合、 CloudFormation デプロイは未解決のリファレンスで失敗します。

  • このコマンドは、暗号化されたステージングバケットを読み取るために必要なロールの認証情報をデプロイします。これには、デプロイロールに必要なIAMアクセス許可を含むブートストラップテンプレートのバージョン 12 が必要です。

使用方法

$ cdk import <arguments> <options>

引数

CDK スタック ID

リソースをインポートするアプリケーションからのCDKスタックのコンストラクト ID。この引数は、1 つのコマンドで複数回指定できます。

型: 文字列

必須: いいえ

オプション

すべての で動作するグローバルオプションのリスト CDK CLI コマンドについては、「」を参照してくださいグローバルオプション。

--change-set-name STRING

作成する CloudFormation 変更セットの名前。

--execute BOOLEAN

変更セットを実行するかどうかを指定します。

デフォルト値: true

--force, -f BOOLEAN

デフォルトでは、 CDKCLI テンプレート diff に更新または削除が含まれている場合、 はプロセスを終了させます。この動作trueを上書きし、常にインポートを続行するには、 を指定します。

--help, -h BOOLEAN

cdk import コマンドのコマンドリファレンス情報を表示します。

--record-resource-mapping, -r STRING

このオプションを使用して、既存の物理リソースとインポートされるCDKリソースのマッピングを生成します。マッピングは、指定したファイルパスに書き込まれます。実際のインポート操作は実行されません。

--resource-mapping, -m STRING

このオプションを使用して、リソースマッピングを定義するファイルを指定します。の CDK CLI は、このファイルを使用して、インタラクティブに質問するのではなく、インポートするリソースに物理リソースをマッピングします。

このオプションはスクリプトから実行できます。

--rollback BOOLEAN

障害発生時にスタックを安定状態にロールバックします。

を指定するにはfalse、 --no-rollbackまたは を使用できます-R。

を指定falseして、より迅速に反復します。リソース置換を含むデプロイは常に失敗します。

デフォルト値: true

--toolkit-stack-name STRING

作成する CDK Toolkit スタックの名前。

デフォルトでは、 は指定された AWS 環境に という名前のスタックCDKToolkitをcdk bootstrapデプロイします。ブートストラップスタックに別の名前を指定するには、このオプションを使用します。

の CDK CLI はこの値を使用してブートストラップスタックのバージョンを検証します。