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

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

# AWS CDK CLI コマンドリファレンス
<a name="ref-cli-cmd"></a>

このセクションには、 AWS クラウド開発キット (AWS CDK) コマンドラインインターフェイス (CLI) のコマンドリファレンス情報が含まれています。CDK CLI は CDK Toolkit とも呼ばれます。

## 使用方法
<a name="ref-cli-cmd-usage"></a>

```
$ cdk <command> <arguments> <options>
```

## コマンド
<a name="ref-cli-cmd-commands"></a><a name="ref-cli-cmd-commands-acknowledge"></a>

 ` acknowledge ack `   
発行番号で通知を確認し、再度表示しないようにします。<a name="ref-cli-cmd-commands-bootstrap"></a>

 ` bootstrap `   
という名前の CDK ブートストラップスタックを AWS 環境にデプロイして`CDKToolkit`、CDK デプロイ用の AWS 環境を準備します。<a name="ref-cli-cmd-commands-context"></a>

 ` context `   
 CDK アプリケーションのキャッシュされたコンテキスト値を管理します。<a name="ref-cli-cmd-commands-deploy"></a>

 ` deploy `   
 AWS 環境に 1 つ以上の CDK スタックをデプロイします。<a name="ref-cli-cmd-commands-destroy"></a>

 ` destroy `   
 AWS 環境から 1 つ以上の CDK スタックを削除します。<a name="ref-cli-cmd-commands-diff"></a>

 ` diff `   
差分を実行し、CDK スタック間のインフラストラクチャの変更を確認します。<a name="ref-cli-cmd-commands-docs"></a>

 ` docs doc `   
ブラウザで CDK ドキュメントを開きます。<a name="ref-cli-cmd-commands-doctor"></a>

 ` doctor `   
ローカル CDK プロジェクトおよび開発環境に関する便利な情報の検査および表示します。<a name="ref-cli-cmd-commands-drift"></a>

 ` drift `   
CDK を使用して定義、管理、およびデプロイするリソースの設定ドリフトを検出します。<a name="ref-cli-cmd-commands-flags"></a>

 ` flags `   
CDK CLI の機能フラグ設定を表示および変更します。<a name="ref-cli-cmd-commands-import"></a>

 ` import `   
 AWS CloudFormation リソースのインポートを使用して、既存の AWS リソースを CDK スタックにインポートします。<a name="ref-cli-cmd-commands-init"></a>

 ` init `   
テンプレートから新しい CDK プロジェクトを作成します。<a name="ref-cli-cmd-commands-list"></a>

 ` list, ls `   
CDK アプリからのすべての CDK スタックおよびその依存関係を一覧表示します。<a name="ref-cli-cmd-commands-metadata"></a>

 ` metadata `   
CDK スタックに関連付けられたメタデータを表示します。<a name="ref-cli-cmd-commands-migrate"></a>

 ` migrate `   
 AWS リソース、 AWS CloudFormation スタック、 AWS CloudFormation テンプレートを新しい CDK プロジェクトに移行します。<a name="ref-cli-cmd-commands-notices"></a>

 ` notices `   
CDK アプリケーションの通知を表示します。<a name="ref-cli-cmd-commands-publish-assets"></a>

 ` publish-assets `   
デプロイを実行せずに、指定された CDK スタックのアセットをそれぞれの宛先に発行します。<a name="ref-cli-cmd-commands-refactor"></a>

 ` refactor `   
CDK アプリケーションでコードをリファクタリングするときに、デプロイされたリソースを保持します。<a name="ref-cli-cmd-commands-synthesize"></a>

 ` synthesize, synth `   
CDK アプリケーションを合成して、各スタックの AWS CloudFormation テンプレートを含むクラウドアセンブリを作成します。<a name="ref-cli-cmd-commands-watch"></a>

 ` watch `   
ローカル CDK プロジェクトの変更を継続的に監視し、デプロイおよびホットスワップを実行します。

## グローバルオプション
<a name="ref-cli-cmd-options"></a>

次のオプションは、すべての CDK CLI コマンドと互換性があります。<a name="ref-cli-cmd-options-app"></a>

 `--app, -a <STRING>`   
アプリまたはクラウドアセンブリのディレクトリを実行するコマンドを指定します。  
 *必須:* はい<a name="ref-cli-cmd-options-asset-metadata"></a>

 `--asset-metadata <BOOLEAN>`   
アセットを使用するリソースの `aws:asset:*` AWS CloudFormation メタデータを含めます。  
 *必須:* いいえ  
 *デフォルト値*: `true` <a name="ref-cli-cmd-options-build"></a>

 `--build <STRING>`   
事前合成ビルドを実行するコマンド。  
 *必須:* いいえ<a name="ref-cli-cmd-options-ca-bundle-path"></a>

 `--ca-bundle-path <STRING>`   
HTTPS 要求の検証に使用する CA 証明書へのパス。  
このオプションが指定されない場合、CDK CLI は `AWS_CA_BUNDLE` 環境変数から読み取ります。  
 *必須:* はい<a name="ref-cli-cmd-options-ci"></a>

 `--ci <BOOLEAN>`   
CDK CLI コマンドが継続的インテグレーション (CI) 環境で実行されていることを示します。  
このオプションは、CI パイプラインで一般的な自動オペレーションにより適するように CDK CLI の動作を変更します。  
このオプションを指定するとき、ログは `stderr` ではなく、`stdout` に送信されます。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-context"></a>

 `--context, -c <ARRAY>`   
コンテキスト文字列パラメータをキーと値のペアとして追加します。<a name="ref-cli-cmd-options-debug"></a>

 `--debug <BOOLEAN>`   
詳細なデバッグ情報を有効にします。このオプションでは、CDK CLI がバックグラウンドで行っている動作に関する詳細を含む冗長出力が生成されます。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-ec2creds"></a>

 `--ec2creds, -i <BOOLEAN>`   
CDK CLI が Amazon EC2 インスタンス認証情報の取得を試行するように強制します。  
デフォルトでは、CDK CLI は Amazon EC2 インスタンスのステータスを推測します。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-help"></a>

 `--help, -h <BOOLEAN>`   
CDK CLI のコマンドのリファレンス情報を表示します。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-ignore-errors"></a>

 `--ignore-errors <BOOLEAN>`   
合成エラーは有効でない出力を生成する可能性があるため、無視してください。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-json"></a>

 `--json, -j <BOOLEAN>`   
標準出力 () に出力される YAML for AWS CloudFormation テンプレートの代わりに JSON を使用します`stdout`。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-lookups"></a>

 `--lookups <BOOLEAN>`   
コンテキストルックアップを実行します。  
この値が `false` であり、コンテキスト検索を実行する必要がある場合、合成は失敗します。  
 *必須:* いいえ  
 *デフォルト値*: `true` <a name="ref-cli-cmd-options-no-color"></a>

 `--no-color <BOOLEAN>`   
コンソール出力から色やその他のスタイルを削除します。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-notices"></a>

 `--notices <BOOLEAN>`   
関連する通知を表示します。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-output"></a>

 `--output, -o <STRING>`   
合成されたクラウドアセンブリを出力するディレクトリを指定します。  
 *必須:* はい  
 *デフォルト値*: `cdk.out` <a name="ref-cli-cmd-options-path-metadata"></a>

 `--path-metadata <BOOLEAN>`   
各リソースに `aws::cdk::path` AWS CloudFormation メタデータを含めます。  
 *必須:* いいえ  
 *デフォルト値*: `true` <a name="ref-cli-cmd-options-plugin"></a>

 `--plugin, -p <ARRAY>`   
CDK 機能を拡張するノードパッケージの名前またはパス。このオプションは、1 つのコマンドで複数回指定できます。  
このオプションは、プロジェクトの `cdk.json` ファイルまたはローカル開発マシンの `~/.cdk.json`で設定できます。  

```
{
   // ...
   "plugin": [
      "module_1",
      "module_2"
   ],
   // ...
}
```
 *必須:* いいえ<a name="ref-cli-cmd-options-profile"></a>

 `--profile <STRING>`   
CDK CLI で使用する AWS 環境情報を含む AWS プロファイルの名前を指定します。  
 *必須:* はい<a name="ref-cli-cmd-options-proxy"></a>

 `--proxy <STRING>`   
指定されたプロキシを使用します。  
このオプションが指定されない場合、CDK CLI は `HTTPS_PROXY` 環境変数から読み取ります。  
 *必須:* はい  
 *デフォルト値*: `HTTPS_PROXY` 環境変数から読み取ります。<a name="ref-cli-cmd-options-role-arn"></a>

 `--role-arn, -r <STRING>`   
 AWS CloudFormation を操作するときに CDK CLI が引き受ける IAM ロールの ARN。  
 *必須:* いいえ<a name="ref-cli-cmd-options-staging"></a>

 `--staging <BOOLEAN>`   
アセットを出力ディレクトリにコピーします。  
アセットが出力ディレクトリにコピーされないように、`false` を指定します。これにより、SAM AWS CLI はローカルデバッグの実行時に元のソースファイルを参照できます。  
 *必須:* いいえ  
 *デフォルト値*: `true` <a name="ref-cli-cmd-options-strict"></a>

 `--strict <BOOLEAN>`   
警告を含むスタックを構築しないでください。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-trace"></a>

 `--trace <BOOLEAN>`   
スタック警告のトレースを出力します。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-verbose"></a>

 `--verbose, -v <COUNT>`   
デバッグログを表示します。このオプションは複数回指定し、冗長性を増加することができます。  
 *必須:* いいえ<a name="ref-cli-cmd-options-version"></a>

 `--version <BOOLEAN>`   
CDK CLI バージョン番号を表示します。  
 *必須:* いいえ  
 *デフォルト値*: `false` <a name="ref-cli-cmd-options-version-reporting"></a>

 `--version-reporting <BOOLEAN>`   
合成された AWS CloudFormation テンプレートに ` AWS::CDK::Metadata`リソースを含めます。  
 *必須:* いいえ  
 *デフォルト値*: `true` 

## オプションの提供と設定
<a name="ref-cli-cmd-configure"></a>

コマンドライン引数を使用してオプションを渡すことができます。ほとんどのオプションは、`cdk.json` 設定ファイルで設定できます。複数の設定ソースを使用するとき、CDK CLI は次の優先順位に従います。

1.  **コマンドライン値** – コマンドラインで提供されるオプションは、`cdk.json` ファイルで設定されたオプションを上書きします。

1.  **プロジェクト設定ファイル** – CDK プロジェクトのディレクトリ内の `cdk.json` ファイル。

1.  **ユーザー設定ファイル** – ローカルマシンの `~/.cdk.json` にある `cdk.json` ファイル。

## コマンドラインでオプションを渡す
<a name="ref-cli-cmd-pass"></a><a name="ref-cli-cmd-pass-bool"></a>

 **ブール値を渡す**   
ブール値を受け入れるオプションは、次の方法で指定できます。  
+ `true` および `false` 値の使用 — コマンドでブール値を指定します。以下に例を示します。

  ```
  $ cdk deploy --watch=true
  $ cdk deploy --watch=false
  ```
+ オプションの対照物の指定 — `no` を追加してオプション名を変更し、`false` 値を指定します。以下に例を示します。

  ```
  $ cdk deploy --watch
  $ cdk deploy --no-watch
  ```
+ デフォルトが `true` または `false` のオプションの場合、デフォルトから変更しない限り、オプションを指定する必要はありません。