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

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

# AWS CDK の開始方法
<a name="getting-started"></a>

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

## 前提条件
<a name="getting-started-prerequisites"></a>

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

 AWS CDK の概要を理解しておくことをお勧めします。詳細については、[AWS 「CDK とは」を参照してください。](home.md) および [AWS CDK の主要な概念](core-concepts.md)について説明します。

## AWS CDK CLI のインストール
<a name="getting-started-install"></a>

Node Package Manager を使用して CKD CLI をインストールします。次のコマンドを使用してグローバルにインストールすることをお勧めします。

```
$ npm install -g aws-cdk
```

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

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

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

 **CDK CLI のインストールのトラブルシューティング**   
アクセス許可エラーが発生し、システムで管理者アクセス権がある場合、次の内容を実行します。  

```
$ sudo npm install -g aws-cdk
```
エラーメッセージが表示された場合、次の内容を実行して CDK CLI をアンインストールしてみてください。  

```
$ npm uninstall -g aws-cdk
```
次に、ステップを繰り返して CDK CLI を再インストールします。

## CDK CLI の正常なインストールの確認
<a name="getting-started-install-verify"></a>

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

```
$ cdk --version
```

## AWS CDK CLI を設定する
<a name="getting-started-configure"></a>

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

ローカルマシンでセキュリティ認証情報を設定するには、 CLI AWS を使用します。セキュリティ認証情報の設定方法は、ユーザーの管理方法によって異なります。手順については、* AWS 「 コマンドラインインターフェイスユーザーガイド*」の[「認証とアクセスの認証情報](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html)」を参照してください。

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

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

## (オプション) 追加の AWS CDK ツールをインストールする
<a name="getting-started-tools"></a>

[AWS Toolkit for Visual Studio Code](https://aws.amazon.com/visualstudiocode/) は、 AWSでのアプリケーションの作成、デバッグ、デプロイに役立つ Visual Studio Code のオープンソースプラグインです。ツールキットは、 AWS CDK アプリケーションを開発するための統合されたエクスペリエンスを提供します。これには、 AWS CDK プロジェクトを一覧表示し、 AWS CDK アプリケーションのさまざまなコンポーネントを参照する CDK Explorer 機能が含まれています。手順については、以下を参照してください。
+  [AWS Toolkit for Visual Studio Code のインストール](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html)。
+  [AWS CDK for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/cdk-explorer.html)。

## 最初の CDK アプリの作成
<a name="getting-started-app"></a>

これで、最初の AWS CDK アプリを作成して CDK の使用を開始する準備ができました。手順については、[「チュートリアル: 最初の AWS CDK アプリを作成する](hello-world.md)」を参照してください。