v0.19.0 release prep

Author: lbjay

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## [0.19.0] - 2026-03-17
+
+DocumentDB major version update functionality. This version introduces some changes that allow for a manual blue/green migration of docdb versions. See [[README_docdb_upgrade.md]].
+
 ### Added
 
 - library update from 17 vulnerabilities (2 low, 7 moderate, 7 high, 1 critical) to 5 vulnerabilities (2 low, 3 high)

README_docdb_upgrade.md

@@ -16,6 +16,8 @@ Keep the app pointed at the current (blue) DocumentDB endpoint while you deploy
 
 The examples below use `caccl-deploy stack ... changeset` instead of `deploy` to prepare a change set for inspection in the CloudFormation console. This is a safer workflow than relying on `cdk diff` alone.
 
+If you prefer, you can use `./bin/docdb-config-for-upgrade.sh` for the update steps instead of running each `caccl-deploy update ...` command manually.
+
 ## Migration Steps
 
 ### 1. Preparation
@@ -49,6 +51,7 @@ caccl-deploy stack --app <app> changeset
 caccl-deploy update --app <app> dbOptions/engineVersion 5.0.0
 caccl-deploy update --app <app> dbOptions/parameterGroupFamily docdb5.0
 caccl-deploy update --app <app> dbOptions/docdbUseVersionSuffix true
+ caccl-deploy update --app <app> lbOptions/targetDeregistrationDelay 5
 ```
 
 2. Inspect the diff; you should see the blue resources marked as `orphan` and new green resources added.
@@ -120,7 +123,12 @@ This will update the task definition and roll the ECS service to the green clust
 
 1. QA/test the redeployed app.
 2. Stop and delete the DMS task and endpoints.
-3. Delete the old blue cluster when you are comfortable to do so (after a final snapshot if desired).
+3. Reset the load balancer deregistration delay:
+
+```bash
+caccl-deploy update --app <app> -D lbOptions/targetDeregistrationDelay
+```
+4. Delete the old blue cluster when you are comfortable to do so (after a final snapshot if desired).
 
 ### Final state
 

bin/docdb-config-for-upgrade.sh

@@ -25,7 +25,7 @@ case "$UPGRADE_STEP" in
     caccl-deploy update --app "$APP_NAME" dbOptions/docdbUseVersionSuffix true
     caccl-deploy update --app "$APP_NAME" dbOptions/engineVersion 5.0.0
     caccl-deploy update --app "$APP_NAME" dbOptions/parameterGroupFamily docdb5.0
-    caccl-deploy update --app "$APP_NAME" lbOptions/targetDeregistrationDelay 0
+    caccl-deploy update --app "$APP_NAME" lbOptions/targetDeregistrationDelay 5
     ;;
   post)
     caccl-deploy update --app "$APP_NAME" -D dbOptions/clusterEndpointOverride

npm-shrinkwrap.json

@@ -1,6 +1,6 @@
 {
   "name": "caccl-deploy",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "A cli tool for managing ECS/Fargate app deployments",
   "main": "index.js",
   "bin": {