AWS CDK のローカル開発環境を作ろう！

brew install awscli
brew install node@20

# node@20 インストール後のメッセージに従い、PATH設定を追加します。 
# 設定の追記先は、みなさんの環境に合わせて変更してください。
# 再ログインなどで反映する必要があります。
echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zshrc

$ aws --version
aws-cli/2.17.61 Python/3.12.6 Darwin/23.6.0 source/arm64

$ node -v
v20.17.0

$ npx cdk --version
2.160.0 (build 7a8ae02)

aws --version
node -v
npx cdk --version

aws configure sso

$ aws configure sso
SSO session name (Recommended): my-sso
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]: us-east-1
SSO registration scopes [None]: sso:account:access

注: 設定値はすべてサンプルの値です

pwd
mkdir hello-cdk && cd hello-cdk
pwd

$ pwd
/<任意の作業ディレクトリ>

$ mkdir hello-cdk && cd hello-cdk

$ pwd
/<任意の作業ディレクトリ>/hello-cdk

npx cdk bootstrap

npx cdk list

$ npx cdk list
HelloCdkStack

import * as cdk from 'aws-cdk-lib';
import { Construct } from 'constructs';
// Import the Lambda module
import * as lambda from 'aws-cdk-lib/aws-lambda';

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

    // Define the Lambda function resource
    const myFunction = new lambda.Function(this, "HelloWorldFunction", {
      runtime: lambda.Runtime.NODEJS_20_X, // Provide any supported Node.js runtime
      handler: "index.handler",
      code: lambda.Code.fromInline(`
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello World!'),
          };
        };
      `),
    });

    // 追記 ここから
    // Define the Lambda function URL resource
    const myFunctionUrl = myFunction.addFunctionUrl({
      authType: lambda.FunctionUrlAuthType.NONE,
    });

    // Define a CloudFormation output for your URL
    new cdk.CfnOutput(this, "myFunctionUrlOutput", {
      value: myFunctionUrl.url,
    })
    // 追記 ここまで
  }
}

npx cdk synth

npx cdk deploy

$ npx cdk deploy

✨  Synthesis time: 2.8s

HelloCdkStack:  start: Building e0feffbc0459e446d7e99aff15115db658baa95db82957e475bfd28e84508237:current_account-current_region
HelloCdkStack:  success: Built e0feffbc0459e446d7e99aff15115db658baa95db82957e475bfd28e84508237:current_account-current_region
HelloCdkStack:  start: Publishing e0feffbc0459e446d7e99aff15115db658baa95db82957e475bfd28e84508237:current_account-current_region
HelloCdkStack:  success: Published e0feffbc0459e446d7e99aff15115db658baa95db82957e475bfd28e84508237:current_account-current_region
This deployment will make potentially sensitive changes according to your current security approval level (--require-approval broadening).
Please confirm you intend to make the following modifications:

IAM Statement Changes
┌───┬───────────────────────────────┬────────┬───────────────────────────────┬────────────────────────────────┬───────────┐
│   │ Resource                      │ Effect │ Action                        │ Principal                      │ Condition │
├───┼───────────────────────────────┼────────┼───────────────────────────────┼────────────────────────────────┼───────────┤
│ + │ ${HelloWorldFunction.Arn}     │ Allow  │ lambda:InvokeFunctionUrl      │ *                              │           │
├───┼───────────────────────────────┼────────┼───────────────────────────────┼────────────────────────────────┼───────────┤
│ + │ ${HelloWorldFunction/ServiceR │ Allow  │ sts:AssumeRole                │ Service:lambda.amazonaws.com   │           │
│   │ ole.Arn}                      │        │                               │                                │           │
└───┴───────────────────────────────┴────────┴───────────────────────────────┴────────────────────────────────┴───────────┘
IAM Policy Changes
┌───┬───────────────────────────────────┬────────────────────────────────────────────────────────────────────────────────┐
│   │ Resource                          │ Managed Policy ARN                                                             │
├───┼───────────────────────────────────┼────────────────────────────────────────────────────────────────────────────────┤
│ + │ ${HelloWorldFunction/ServiceRole} │ arn:${AWS::Partition}:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole │
└───┴───────────────────────────────────┴────────────────────────────────────────────────────────────────────────────────┘
(NOTE: There may be security-related changes not in this list. See https://github.com/aws/aws-cdk/issues/1299)

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

 ✅  HelloCdkStack

✨  Deployment time: 40.91s

Outputs:
HelloCdkStack.myFunctionUrlOutput = https://<url-id>.lambda-url.<region>.on.aws/
Stack ARN:
arn:aws:cloudformation:us-east-1:xxxxxxxxxxxx:stack/HelloCdkStack/75e39360-7dc6-11ef-b1a8-0affd4860f5b

✨  Total time: 43.71s

curl https://<url-id>.lambda-url.<region>.on.aws/

// ...

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

    // Modify the Lambda function resource
    const myFunction = new lambda.Function(this, "HelloWorldFunction", {
      runtime: lambda.Runtime.NODEJS_20_X, // Provide any supported Node.js runtime
      handler: "index.handler",
      code: lambda.Code.fromInline(`
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello CDK!'),
          };
        };
      `),
    });

    // ...

npx cdk diff

$ npx cdk diff  
Stack HelloCdkStack
Hold on while we create a read-only change set to get a diff with accurate replacement information (use --no-change-set to use a less accurate but faster template-only diff)
Resources
[~] AWS::Lambda::Function HelloWorldFunction HelloWorldFunctionB2AB6E79 
 └─ [~] Code
     └─ [~] .ZipFile:
         ├─ [-] 
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello World!'),
          };
        };
      
         └─ [+] 
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello CDK!'),
          };
        };
      


✨  Number of stacks with differences: 1

$ npx cdk deploy

✨  Synthesis time: 2.84s

HelloCdkStack: deploying... [1/1]
HelloCdkStack: creating CloudFormation changeset...

 ✅  HelloCdkStack

✨  Deployment time: 29.92s

Outputs:
HelloCdkStack.myFunctionUrlOutput = https://<url-id>.lambda-url.<region>.on.aws/
Stack ARN:
arn:aws:cloudformation:us-east-1:xxxxxxxxxxxx:stack/HelloCdkStack/75e39360-7dc6-11ef-b1a8-0affd4860f5b

✨  Total time: 32.76s

curl https://<url-id>.lambda-url.<region>.on.aws/

$ curl https://<url-id>.lambda-url.<region>.on.aws/
"Hello CDK!"%

npx cdk deploy --hotswap

// ...

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

    // Modify the Lambda function resource
    const myFunction = new lambda.Function(this, "HelloWorldFunction", {
      runtime: lambda.Runtime.NODEJS_20_X, // Provide any supported Node.js runtime
      handler: "index.handler",
      code: lambda.Code.fromInline(`
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello CDK! by hotswap deploy'),
          };
        };
      `),
    });

    // ...

$ npx cdk deploy --hotswap

✨  Synthesis time: 2.82s

⚠️ The --hotswap and --hotswap-fallback flags deliberately introduce CloudFormation drift to speed up deployments
⚠️ They should only be used for development - never use them for your production Stacks!

HelloCdkStack:  start: Building a598b1780057683646f0fdba1fa3f8b8d37f902efda96800d83569be5b6d4da3:current_account-current_region
HelloCdkStack:  success: Built a598b1780057683646f0fdba1fa3f8b8d37f902efda96800d83569be5b6d4da3:current_account-current_region
HelloCdkStack:  start: Publishing a598b1780057683646f0fdba1fa3f8b8d37f902efda96800d83569be5b6d4da3:current_account-current_region
HelloCdkStack:  success: Published a598b1780057683646f0fdba1fa3f8b8d37f902efda96800d83569be5b6d4da3:current_account-current_region
HelloCdkStack: deploying... [1/1]

✨ hotswapping resources:
   ✨ Lambda Function 'HelloCdkStack-HelloWorldFunctionB2AB6E79-iC3U1SSNflnY'
✨ Lambda Function 'HelloCdkStack-HelloWorldFunctionB2AB6E79-iC3U1SSNflnY' hotswapped!

 ✅  HelloCdkStack

✨  Deployment time: 8.56s

Outputs:
HelloCdkStack.myFunctionUrlOutput = https://<url-id>.lambda-url.<region>.on.aws/
Stack ARN:
arn:aws:cloudformation:us-east-1:xxxxxxxxxxxx:stack/HelloCdkStack/75e39360-7dc6-11ef-b1a8-0affd4860f5b

✨  Total time: 11.38s

$ curl https://<url-id>.lambda-url.<region>.on.aws/
"Hello CDK! by hotswap deploy"%

npx cdk watch

npx cdk destroy