インストール確認：

※ CloudShellを使う場合は毎セッション実行が必要です

cdk init でプロジェクト雛形が生成されます。
bin/ と lib/ が自動作成されます。

CDKデプロイに必要なS3バケット (cdk-xxxxxxx-assets-*) と IAMロールがアカウントに作成されます。同一アカウント・リージョンでは初回のみ必要です。

import * as cdk from 'aws-cdk-lib';
import * as ec2 from 'aws-cdk-lib/aws-ec2';
import * as iam from 'aws-cdk-lib/aws-iam';
import { Construct } from 'constructs';

export class HandsonCdkStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    const environmentName = new cdk.CfnParameter(this, 'EnvironmentName', {
      type: 'String',
      default: 'handson',
    });

    // VPC
    const vpc = new ec2.Vpc(this, 'Vpc', {
      vpcName: `${environmentName.valueAsString}-vpc`,
      ipAddresses: ec2.IpAddresses.cidr('10.0.0.0/16'),
      maxAzs: 2,
      natGateways: 0,
      subnetConfiguration: [{
        cidrMask: 24,
        name: 'Public',
        subnetType: ec2.SubnetType.PUBLIC,
      }],
    });

    // Security Group
    const webSg = new ec2.SecurityGroup(this, 'WebSg', {
      vpc,
      securityGroupName: `${environmentName.valueAsString}-sg-web`,
      description: 'Web server security group',
      allowAllOutbound: true,
    });
    webSg.addIngressRule(ec2.Peer.anyIpv4(), ec2.Port.tcp(80), 'HTTP from internet');

    // IAM Role
    const ec2Role = new iam.Role(this, 'Ec2SsmRole', {
      roleName: `${environmentName.valueAsString}-ec2-ssm-role`,
      assumedBy: new iam.ServicePrincipal('ec2.amazonaws.com'),
      managedPolicies: [
        iam.ManagedPolicy.fromAwsManagedPolicyName('AmazonSSMManagedInstanceCore'),
      ],
    });

    const ami = ec2.MachineImage.latestAmazonLinux2023({
      cpuType: ec2.AmazonLinuxCpuType.X86_64,
    });

    // EC2 WebServer 1 (1a)
    const web1 = new ec2.Instance(this, 'WebServer1', {
      instanceName: `${environmentName.valueAsString}-web-1a`,
      vpc,
      vpcSubnets: { availabilityZones: [`${cdk.Stack.of(this).region}a`], subnetType: ec2.SubnetType.PUBLIC },
      instanceType: ec2.InstanceType.of(ec2.InstanceClass.T2, ec2.InstanceSize.MICRO),
      machineImage: ami,
      securityGroup: webSg,
      role: ec2Role,
      userData: (() => {
        const ud = ec2.UserData.forLinux();
        ud.addCommands(
          'dnf update -y', 'dnf install -y nginx',
          'systemctl enable nginx', 'systemctl start nginx',
          `echo "
handson - WebServer 1 (1a) - v1
" > /usr/share/nginx/html/index.html`
        );
        return ud;
      })(),
    });
    cdk.Tags.of(web1).add('Version', 'v1');

    // EC2 WebServer 2 (1c)
    const web2 = new ec2.Instance(this, 'WebServer2', {
      instanceName: `${environmentName.valueAsString}-web-1c`,
      vpc,
      vpcSubnets: { availabilityZones: [`${cdk.Stack.of(this).region}c`], subnetType: ec2.SubnetType.PUBLIC },
      instanceType: ec2.InstanceType.of(ec2.InstanceClass.T2, ec2.InstanceSize.MICRO),
      machineImage: ami,
      securityGroup: webSg,
      role: ec2Role,
      userData: (() => {
        const ud = ec2.UserData.forLinux();
        ud.addCommands(
          'dnf update -y', 'dnf install -y nginx',
          'systemctl enable nginx', 'systemctl start nginx',
          `echo "
handson - WebServer 2 (1c) - v1
" > /usr/share/nginx/html/index.html`
        );
        return ud;
      })(),
    });
    cdk.Tags.of(web2).add('Version', 'v1');

    // Outputs
    new cdk.CfnOutput(this, 'VpcId', { description: 'VPC ID', value: vpc.vpcId });
    new cdk.CfnOutput(this, 'WebServer1Ip', { value: web1.instancePublicIp });
    new cdk.CfnOutput(this, 'WebServer2Ip', { value: web2.instancePublicIp });
    new cdk.CfnOutput(this, 'WebServer1Url', { value: `http://${web1.instancePublicIp}` });
    new cdk.CfnOutput(this, 'WebServer2Url', { value: `http://${web2.instancePublicIp}` });
  }
}

以下のディレクトリ構成が生成されます：

handson-cdk/
├── bin/handson-cdk.ts      ← Appエントリーポイント
├── lib/handson-cdk-stack.ts ← Stackの定義
├── cdk.json
├── package.json
└── tsconfig.json

AWSコンソール → CloudFormation で CDKToolkit スタックが作成されています。

エディタ（CloudShell内なら vi lib/handson-cdk-stack.ts）で編集してください。

bin/handson-cdk.ts はデフォルトのままで問題ありません。

長いYAMLが出力されます。cdk.out/HandsonCdkStack.template.json にも保存されます。

初回は全リソースが + 追加 として表示されます。

Stack HandsonCdkStack
Resources
[+] AWS::EC2::VPC Vpc VpcXXXXXX
[+] AWS::EC2::Subnet Vpc/PublicSubnet1/Subnet VpcPublicSubnet1SubnetXXXXXX
[+] AWS::EC2::InternetGateway Vpc/IGW VpcIGWXXXXXX
[+] AWS::EC2::SecurityGroup WebSg WebSgXXXXXX
[+] AWS::IAM::Role Ec2SsmRole Ec2SsmRoleXXXXXX
[+] AWS::EC2::Instance WebServer1 WebServer1XXXXXX
[+] AWS::EC2::Instance WebServer2 WebServer2XXXXXX
...

セキュリティ関連の変更確認が表示された場合は y で承認します。

Do you wish to deploy these changes (y/n)? y
HandsonCdkStack: deploying... [1/1]
HandsonCdkStack: creating CloudFormation changeset...

 ✅  HandsonCdkStack

✨  Deployment time: 120.3s

Outputs:
HandsonCdkStack.WebServer1Url = http://xxx.xxx.xxx.xxx
HandsonCdkStack.WebServer2Url = http://xxx.xxx.xxx.xxx

Stack ARN:
arn:aws:cloudformation:ap-northeast-1:xxxxxxxxxxxx:stack/HandsonCdkStack/xxxxxxxx

1. AWSコンソール → CloudFormation → 「HandsonCdkStack」をクリック
2. 「リソース」タブ → 作成されたリソース一覧を確認
3. 「出力」タブ → WebServer1Url, WebServer2Url を確認
4. 「イベント」タブ → 作成順序を確認

変更箇所1: Security Groupにルール追加

// 追加: HTTPS
webSg.addIngressRule(ec2.Peer.anyIpv4(), ec2.Port.tcp(443), 'HTTPS from internet');

変更箇所2: Versionタグを v2 に変更 (web1, web2 両方)

// 変更前
cdk.Tags.of(web1).add('Version', 'v1');
cdk.Tags.of(web2).add('Version', 'v1');

// 変更後
cdk.Tags.of(web1).add('Version', 'v2');
cdk.Tags.of(web2).add('Version', 'v2');

Stack HandsonCdkStack
Security Group Changes
┌───┬────────────────────┬─────┬────────────┬──────────────────────┐
│   │ Group              │ Dir │ Protocol   │ Peer                 │
├───┼────────────────────┼─────┼────────────┼──────────────────────┤
│ + │ ${WebSg.GroupId}   │ In  │ TCP 443    │ Everyone (IPv4)      │
└───┴────────────────────┴─────┴────────────┴──────────────────────┘

IAM Statement Changes (none)

Resources
[~] AWS::EC2::SecurityGroup WebSg WebSgXXXXXX
 └─ [+] SecurityGroupIngress/1
     ├─ IpProtocol: tcp
     ├─ FromPort: 443
     ├─ ToPort: 443
     └─ CidrIp: 0.0.0.0/0
[~] AWS::EC2::Instance WebServer1 WebServer1XXXXXX
 └─ [~] Tags
     └─ [~] .../Version: "v1" → "v2"
[~] AWS::EC2::Instance WebServer2 WebServer2XXXXXX
 └─ [~] Tags
     └─ [~] .../Version: "v1" → "v2"

完了後、CloudFormationコンソールの「リソース」タブで Security Group を確認し、443ポートが追加されていることを確認してください。

CDKが書いたTypeScriptが、どのようなCFn JSONに変換されているかを確認できます。

確認プロンプトが表示されます：

Are you sure you want to delete: HandsonCdkStack (y/n)? y
HandsonCdkStack: destroying... [1/1]
✅  HandsonCdkStack: destroyed

1. AWSコンソール → CloudFormation
2. 「HandsonCdkStack」が表示されないこと（または DELETE_COMPLETE ステータス）を確認
3. EC2コンソール → インスタンス → terminated 状態になっていることを確認
4. VPCコンソール → 作成したVPCが削除されていることを確認

削除する場合はCloudFormationコンソールから CDKToolkit スタックを手動削除してください。

（S3バケットが空でないと削除できない場合があります。バケット内のオブジェクトを先に空にしてください。）