の開始方法 AWS CDK - AWS Cloud Development Kit (AWS CDK) v2

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

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

の開始方法 AWS CDK

AWS CDK コマンドラインインターフェイス () をインストールして設定 AWS Cloud Development Kit (AWS CDK) して、 の使用を開始しますAWS CDK CLI。次に、 を使用して最初のCDKアプリケーションCDKCLIを作成し、 AWS 環境をブートストラップして、アプリケーションをデプロイします。

前提条件

の使用を開始する前に AWS CDK、すべての前提条件を完了してください。これらの前提条件は、プログラミングを初めて AWS 使用する場合や、プログラミングを初めて使用する場合に必要です。手順については、AWS CDK 前提条件 を参照してください。

とは何かを基本的に理解しておくことをお勧めします AWS CDK 。詳細については、「とは AWS CDK」および「AWS CDK 主要概念を学ぶ」を参照してください。

AWS CDK CLI のインストール

Node パッケージマネージャーを使用して CDK をインストールしますCLI。次のコマンドを使用してグローバルにインストールすることをお勧めします。

$ npm install -g aws-cdk

の特定のバージョンをインストールするにはCDKCLI、次のコマンド構造を使用します。

$ npm install -g aws-cdk@X.YY.Z

の複数のバージョンを使用する場合は AWS CDK、CDKCLI個々のCDKプロジェクトに の一致するバージョンをインストールすることを検討してください。これを行うには、 npm install コマンドから -gオプションを削除します。次に、 を使用して CDK をnpx aws-cdk呼び出しますCLI。これにより、ローカルバージョンが存在する場合に実行されます。それ以外の場合は、グローバルにインストールされたバージョンが使用されます。

CDKCLI インストールのトラブルシューティング

アクセス許可エラーが発生し、システムで管理者アクセス権がある場合は、以下を実行します。

$ sudo npm install -g aws-cdk

エラーメッセージが表示された場合は、以下を実行して CDKCLIをアンインストールしてみてください。

$ npm uninstall -g aws-cdk

次に、手順を繰り返して CDK を再インストールしますCLI。

正常にCDKCLIインストールされたことを確認する

次のコマンドを実行して、正常にインストールされたことを確認します。はバージョン番号を出力 AWS CDK CLIする必要があります。

$ cdk --version

を設定する AWS CDKCLI

をインストールしたらCDKCLI、ローカルマシンでアプリケーションの開発にその の使用を開始できます。アプリケーションのデプロイなど AWS、 を操作するには、ローカルマシンで、開始するアクションを実行するアクセス許可を持つセキュリティ認証情報を設定する必要があります。

ローカルマシンでセキュリティ認証情報を設定するには、 を使用します AWS CLI。セキュリティ認証情報の設定方法は、ユーザーの管理方法によって異なります。手順については、「 ユーザーガイド」の「認証とアクセス認証情報AWS Command Line Interface 」を参照してください。

CDK CLI は、 で設定したセキュリティ認証情報を自動的に使用します AWS CLI。例えば、IAMIdentity Center ユーザーの場合は、 aws configure sso コマンドを使用してセキュリティ認証情報を設定できます。IAM ユーザーの場合は、 aws configure コマンドを使用できます。 AWS CLI は、ローカルマシンでセキュリティ認証情報を設定し、必要な情報を configおよび credentials ファイルに保存する手順を説明します。次に、 CDK を使用してアプリケーションをデプロイするなどCLI、 を使用するとcdk deploy、 CDKCLIは設定したセキュリティ認証情報を使用します。

と同様に AWS CLI、 CDKCLIはデフォルトでdefaultプロファイルを使用します。CDK CLI --profile オプションを使用してプロファイルを指定できます。でセキュリティ認証情報を使用する方法の詳細については、CDKCLI「」を参照してくださいのセキュリティ認証情報を設定する AWS CDKCLI

(オプション) 追加の AWS CDK ツールをインストールする

AWS Toolkit for Visual Studio Code は Visual Studio Code 用のオープンソースプラグインで、 でのアプリケーションの作成、デバッグ、デプロイに役立ちます AWS。ツールキットは、 AWS CDK アプリケーションを開発するための統合エクスペリエンスを提供します。これには、 AWS CDK プロジェクトを一覧表示し、CDKアプリケーションのさまざまなコンポーネントを参照する AWS CDK Explorer 機能が含まれています。手順については、以下を参照してください。

最初のCDKアプリケーションを作成する

これで、最初のCDKアプリケーションを作成して、 の使用を開始する準備 AWS CDK が整いました。手順については、チュートリアル: 最初の AWS CDK アプリケーションを作成する を参照してください。