[初心者向け]AWS CDK触ってみた！環境構築編

こんにちは！前越です。

今回は、 AWS CDK（Cloud Development Kit）の環境構築 について初心者向けに解説していきます！

AWS CDK を使えば、TypeScript や Python などのプログラミング言語を使ってAWSリソースを定義できます。コンソール操作に比べて再現性が高く、バージョン管理もできるので、とても便利です。

AWS CDK を使うための環境構築を一から丁寧に説明していきます。

AWS CDKとは？

AWS CDKは「Cloud Development Kit」の略で、プログラミング言語を使ってAWSリソースを定義・プロビジョニングできるフレームワークです。

CDKの主なメリット

• Infrastructure as Code (IaC) の開発と管理: インフラをコードとして扱い、プログラム的、宣言的な方法でインフラを作成・管理できる
• 汎用プログラミング言語を使用してクラウドインフラを定義: TypeScript、JavaScript、Python、Java、C#/.Net、Goなどから選択可能
• AWS CloudFormationによるインフラのデプロイ: 信頼性の高いデプロイとロールバック機能を活用
• コンストラクトを使用した迅速な開発: 再利用可能なコンポーネントで開発を加速

https://docs.aws.amazon.com/ja_jp/cdk/v2/guide/home.html#home-benefits

やってみる

事前準備

AWS CDKを使うには以下のツールが必要です：

• Node.js（npm含む）
• AWS CLI
• AWS認証情報（アクセスキーなど）

Node.jsのインストール

AWS CDKはNode.js上で動作するため、まずはNode.jsをインストールします。

下記のNode.js公式サイトにアクセス
https://nodejs.org/ja

最新版であるLTS版をダウンロードするのが望ましいでしょう。

インストール確認

インストールが完了したら、ターミナルまたはコマンドプロンプトで以下のコマンドを実行して確認しましょう。

node -v && npm -v

ちゃんとインストール出来ていれば下記のようにnodeとnpmのバージョンが表示されると思います！

AWS CLIのインストール

次に、AWS CLIをインストールします。これはAWSリソースをコマンドラインから操作するためのツールです。

下記 AWS 公式サイトからインストーラーをダウンロード

各OSごとにインストーラーがあるためお使いのOSに合わせてインストーラーをダウンロードして実行してください。

https://docs.aws.amazon.com/ja_jp/cli/latest/userguide/getting-started-install.html

インストール確認

インストールが完了したら、以下のコマンドでバージョンを確認します。

aws --version

下記のようにバージョン情報が表示されればインストール成功です！

AWS認証情報の設定

AWS CDKを使うには、AWSアカウントの認証情報が必要です。

IAMユーザーの作成とアクセスキーの設定

1. AWSマネジメントコンソールにログイン

2. IAMサービスにアクセス
   

3. 「ユーザー」→「ユーザーを追加」をクリック
   

4. ユーザー名を入力し、「次へ」をクリック
   

5. 「既存のポリシーを直接アタッチ」を選択し、「AdministratorAccess」を検索してチェックし「次へ」をクリック
   

6. 「ユーザーの作成」をクリック

7. 作成したユーザーを選択して、「セキュリティ認証情報」タブの「アクセスキーの作成」をクリック
   

8. ユースケースのCLIを選択して、下記の確認マーク✅して「次へ」をクリック
   

9. 「アクセスキーを作成」をクリック

10. アクセスキーID と シークレットアクセスキー を安全な場所に保存

AWS CLIの設定

ターミナルで以下のコマンドを実行し、認証情報を設定します

aws configure

• Access Key と Secret Access Key
  先ほどメモ📝したキーを設定

• Default region name
  デフォルトでリクエストを送信するサーバのAWSリージョンを設定します。東京(ap-northeast-1)に設定しました。

• Default output format
  出力結果の形式を選択します。何も設定しなければデフォルトは"json"です。
  json,yaml,yaml-stream,text,tableの中から選びます。

再設定する場合、もう一度"aws configure"と打てば再設定できます。

AWS CDKのインストール

いよいよAWS CDK本体をインストールします！npmを使って簡単にインストールできます。

npm install -g aws-cdk

インストールが完了したら、バージョンを確認しましょう

cdk --version

バージョン番号が表示されればインストール成功です！

CDK環境の初期化（ブートストラップ）

AWS CDKを使用する前に、環境をブートストラップする必要があります。これは、CDKがデプロイに必要なリソース（S3バケットやIAMロールなど）を作成するプロセスです。

以下のコマンドを実行します：

cdk bootstrap aws://ACCOUNT-NUMBER/REGION

ACCOUNT-NUMBER と REGION は、自分のAWSアカウント番号とリージョンに置き換えてください。例えば：

cdk bootstrap aws://123456789012/ap-northeast-1

アカウント番号がわからない場合は、以下のコマンドで確認できます：

aws sts get-caller-identity

エラーが出なければ 環境構築 完了です！

CDKブートストラップで作成されるリソースを確認する

CDKブートストラップを実行すると、AWS環境にいくつかのリソースが作成されます。これらのリソースはCDKのデプロイ基盤として機能します。リソースを確認してみましょう。

CloudFormationスタックの確認
まず、AWSマネジメントコンソールからCloudFormationサービスにアクセスします。「CDKToolkit」という名前のスタックが作成されているはずです。

S3バケットの確認
このバケットは、CDKがデプロイ時に使用するLambda関数のコードやCloudFormationテンプレートなどを保存するために使用されます。

以下のようなバケットが作成されています

cdk-hnb659fds-assets-${ACCOUNT_ID}-${REGION}

IAMロールの確認
ブートストラップではいくつかのIAMロールも作成されます。これらのロールは、CDKがリソースをデプロイする際に必要な権限を提供します。

まとめ

今回は、AWS CDKの環境構築手順について解説しました。
意外と簡単に環境構築できましたね！
AWS CLIの設定辺りでつまづきやすいポイントもありますが、手順通りに進めれば問題なく設定できるはずです。
次回は、この環境を使って実際に動かしたブログを公開する予定です。
ぜひ、お楽しみに！

https://dev.classmethod.jp/articles/aws-cdk-s3-for-beginners/

参考

https://dev.classmethod.jp/articles/created_cdk_environment_on_my_local_windows/
https://qiita.com/KoutaKawaguchi1101/items/ff88e9824c82d74df424

アノテーション株式会社について

アノテーション株式会社はクラスメソッドグループのオペレーション専門特化企業です。サポート・運用・開発保守・情シス・バックオフィスの専門チームが、最新ITテクノロジー、高い技術力、蓄積されたノウハウをフル活用し、お客様の課題解決を行っています。当社は様々な職種でメンバーを募集しています。「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、アノテーション株式会社 採用サイトをぜひご覧ください。