@ossy/deployment-tools 1.21.2 → 1.21.3

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 1.21.3 (2026-05-26)
+
+**Note:** Version bump only for package @ossy/deployment-tools
+
+
+
+
+
 ## 1.21.2 (2026-05-26)
 
 **Note:** Version bump only for package @ossy/deployment-tools

package/README.md

@@ -133,6 +133,38 @@ Each platform is a CDK `Stage` containing five stacks:
 
 The Elastic IP ensures the EC2 instance can be replaced (instance type changes, user data updates) without breaking DNS or CloudFormation cross-stack exports.
 
+## Destroy + redeploy
+
+`<platformName>` is the `platformName` field in `packages/infrastructure/platforms.json` (CDK stage id). `<aws-profile>` is your AWS CLI profile for that account. List stacks: `npx cdk list --profile <aws-profile>`.
+
+Full platform teardown:
+
+```bash
+cd packages/deployment-tools
+npx cdk destroy '<platformName>/**' --profile <aws-profile>
+```
+
+Recreate (CDK applies stacks in dependency order):
+
+```bash
+npx cdk deploy '<platformName>/**' --profile <aws-profile>
+```
+
+Recycle **only the EC2 host** (keep S3, CDN, and backups):
+
+```bash
+npx cdk destroy '<platformName>/dns' --profile <aws-profile>
+npx cdk destroy '<platformName>/deployment-target' --profile <aws-profile>
+npx cdk deploy '<platformName>/deployment-target' --profile <aws-profile>
+npx cdk deploy '<platformName>/dns' --profile <aws-profile>
+```
+
+Do not destroy `storage-static` unless you intend to drop media storage (bucket is `RETAIN` and may remain in the account anyway).
+
+The S3 bucket and **AWS Backup vault** use `RETAIN` so media and recovery points survive a stack delete. CloudFront and the backup *plan* are removed with the stack.
+
+If deploy fails with **BackupVault already exists** after a full destroy, a retained vault is still in the account (`<platformName>-static-media-backup`). Delete it in AWS Backup (empty recovery points first), or import it into the new stack.
+
 ## Bootstrapping a new platform
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossy/deployment-tools",
-  "version": "1.21.2",
+  "version": "1.21.3",
   "description": "Collection of scripts and tools to aid deployment of containers and static files to Amazon Web Services through GitHub Actions",
   "source": "./src/index.js",
   "main": "./src/index.js",
@@ -22,5 +22,5 @@
   "devDependencies": {
     "jest": "^27.5.1"
   },
-  "gitHead": "5747c957d77061c1172a0ac7a6a54d1644986927"
+  "gitHead": "909e3d78752d07afceb60af78784987f6fcea8b7"
 }

package/src/infrastructure/storage-static-stack.js

@@ -39,6 +39,7 @@ class StorageStaticStack extends Stack {
     })
 
     const backupVault = new BackupVault(this, 'StaticMediaBackupVault', {
+      backupVaultName: `${props.config.platformName}-static-media-backup`,
       removalPolicy: RemovalPolicy.RETAIN
     })