AWS CDK Python セットアップ手順

このスキルは、Python を使用した AWS CDK (Cloud Development Kit) プロジェクトの作業ガイダンスを提供します。

---

前提条件

開始する前に、以下のツールがインストールされていることを確認してください:

• Node.js ≥ 14.15.0 — AWS CDK CLI に必須
• Python ≥ 3.7 — CDK コードの作成に使用
• AWS CLI — 認証情報とリソースを管理
• Git — バージョン管理とプロジェクト管理

---

インストール手順

1. AWS CDK CLI のインストール

npm install -g aws-cdk
cdk --version

2. AWS 認証情報の設定

# AWS CLI をインストール (未インストールの場合)
brew install awscli

# 認証情報を設定
aws configure

プロンプトで AWS アクセスキー、シークレットアクセスキー、デフォルトリージョン、出力フォーマットを入力します。

3. 新しい CDK プロジェクトを作成

mkdir my-cdk-project
cd my-cdk-project
cdk init app --language python

プロジェクトには以下が含まれます:

• app.py — メインアプリケーションのエントリーポイント
• my_cdk_project/ — CDK スタック定義
• requirements.txt — Python 依存関係
• cdk.json — 設定ファイル

4. Python 仮想環境をセットアップ

# macOS/Linux
source .venv/bin/activate

# Windows
.venv\Scripts\activate

5. Python 依存関係をインストール

pip install -r requirements.txt

主な依存関係:

• aws-cdk-lib — コア CDK コンストラクト
• constructs — ベースコンストラクトライブラリ

---

開発ワークフロー

CloudFormation テンプレートを合成

cdk synth

CloudFormation テンプレートを含む cdk.out/ を生成します。

スタックを AWS にデプロイ

cdk deploy

設定された AWS アカウントへのデプロイをレビューして確認します。

ブートストラップ (初回デプロイのみ)

cdk bootstrap

アセットストレージ用の S3 バケットなどの環境リソースを準備します。

---

ベストプラクティス

• 作業前に必ず仮想環境をアクティベートする。
• デプロイ前に cdk diff を実行して変更をプレビューする。
• テストには開発用アカウントを使用する。
• Python の命名規則とディレクトリ構造に従う。
• 一貫したビルドのため requirements.txt をピン留めする。

---

トラブルシューティングのヒント

問題が発生した場合は、以下を確認してください:

• AWS 認証情報が正しく設定されている。
• デフォルトリージョンが正しく設定されている。
• Node.js と Python のバージョンが最小要件を満たしている。
• cdk doctor を実行して環境の問題を診断する。