{
  "slug": "cdk-hotswap-deploys-bedrock-agentcore-runtime-changes-e2509f14691d",
  "title": "cdk hotswap deploys Bedrock AgentCore Runtime changes",
  "tools": [
    "cdk"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-01-22T12:31:53.000Z",
  "announced_at": "2026-01-22T12:31:53.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When an AWS::BedrockAgentCore::Runtime change is supported, run `cdk deploy <stack-id> --hotswap`; the CLI attempts a direct hotswap, and unsupported changes are ignored. For S3 code changes, use `Asset` from `aws-cdk-lib/aws-s3-assets` so the object key changes with the content hash.",
    "examples": [
      "cdk deploy <stack-id> --hotswap",
      "const asset = new aws_s3_assets.Asset(this, 'CodeAsset', { path: path.join(__dirname, 'agent-code') });\nconst agentRuntimeArtifact = AgentRuntimeArtifact.fromS3({ bucketName: asset.s3BucketName, objectKey: asset.s3ObjectKey }, AgentCoreRuntime.PYTHON_3_13, ['app.py']);\nnew Runtime(this, 'Runtime', { runtimeName: 'runtime', agentRuntimeArtifact });"
    ],
    "gotchas": [
      "Version: v2.1102.0",
      "<stack-id>: CDK stack construct ID to deploy.",
      "--hotswap <BOOLEAN>: Attempt a hotswap deployment; default is false. Unsupported changes are ignored with a message. Uses current AWS credentials and does not assume bootstrap roles.",
      "Asset.path (required): Path to the asset directory in the release-note S3 example.",
      "AgentRuntimeArtifact.fromS3 bucketName (required): S3 bucket name supplied to the artifact in the release-note example.",
      "AgentRuntimeArtifact.fromS3 objectKey (required): S3 object key; example uses `asset.s3ObjectKey`, described as a content hash that changes when code changes.",
      "AgentRuntimeArtifact.fromS3 runtime (required): Runtime identifier; example uses `AgentCoreRuntime.PYTHON_3_13`.",
      "AgentRuntimeArtifact.fromS3 entry points (required): Example passes `['app.py']`.",
      "Prerequisite: Use AWS credentials for the same account as the stacks and with IAM permissions to update the resources directly.",
      "Prerequisite: Hotswap is intended for development; it deliberately introduces CloudFormation drift and is not recommended for production.",
      "S3 code changes are detected when using `Asset` from `aws-cdk-lib/aws-s3-assets`.",
      "Do not use `Source.asset()` with `BucketDeployment` for S3 code changes: the generated object key is a token resolved at deployment time and does not change in the CloudFormation template, so hotswap will not work.",
      "Docs conflict: Current AWS CDK CLI reference lists Bedrock AgentCore Runtime support as configuration changes; it does not enumerate the release-note's code files, container image, environment variable, or description change categories. The reference page may describe a newer CLI version than v2.1102.0. No conflicting details used."
    ]
  },
  "why_it_matters": "When updating an AWS::BedrockAgentCore::Runtime in a CDK app, deploy supported runtime changes with hotswap.",
  "sources": [
    "https://github.com/aws/aws-cdk-cli/releases/tag/aws-cdk%40v2.1102.0",
    "https://github.com/aws/aws-cdk-cli/pull/991",
    "https://docs.aws.amazon.com/cdk/v2/guide/ref-cli-cmd-deploy.html"
  ],
  "rank": 0.94015,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-624427f3bf2922a1-0:gate",
    "evidence_hash": "3a71a5a5b3efc34f5565011e3d3e910128a41d4d8b7f49144beae566bb289bdc"
  },
  "review": {
    "draft_hash": "86a58bda9381f8fe148c61671ce35589353eb2192413af971a4374ef16ac88b3",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.94 >= 0.9; 2 needed) and Jev gave 0.62 (>= 0.6 needed)."
  }
}