Apply technical requirements (R1, R2, R9, R10, R13)

mwunderl · mwunderl · commit c3ed52c5c032 · 2026-04-21T05:17:16.000Z
- R1: Add AWS_REGION to region fallback chain
- R2: Replace openssl rand with /dev/urandom
- R9: Remove Appendix/Generation details from READMEs
- R10: Remove internal references
- R13: Add REVISION-HISTORY.md
diff --git a/tuts/026-kinesis-data-streams/README.md b/tuts/026-kinesis-data-streams/README.md
@@ -59,15 +59,3 @@ Kinesis: $0.015/shard-hour. DynamoDB: on-demand pricing. Both are negligible for
 - [Tutorial: Process real-time stock data using KPL and KCL](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl2.html)
 - [Using Lambda with Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html)
 - [Amazon Kinesis Data Streams terminology](https://docs.aws.amazon.com/streams/latest/dev/key-concepts.html)
-
----
-
-## Appendix: Generation details
-
-| Field | Value |
-|-------|-------|
-| Generation date | 2026-04-14 |
-| Source script | Full rewrite from internal 026-kinesis-ds-gs/2-cli-script-v3.sh |
-| Script test result | EXIT 0, 185s, 8 steps, clean teardown |
-| Issues encountered | Original had hardcoded resource names (fixed with random IDs); python3.9 runtime (upgraded to 3.12); stream name embedded in Lambda code via bash interpolation (fixed with env vars); DynamoDB verification timing — Kinesis event source mapping first poll can take 60s after Enabled state |
-| Iterations | v1 (internal, hardcoded), v2 (partial fixes), v3 (internal, still hardcoded), v4 (clean rewrite for publish) |
diff --git a/tuts/026-kinesis-data-streams/REVISION-HISTORY.md b/tuts/026-kinesis-data-streams/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 026-kinesis-data-streams
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/026-kinesis-data-streams/kinesis-data-streams.sh b/tuts/026-kinesis-data-streams/kinesis-data-streams.sh
@@ -14,7 +14,7 @@ fi
 export AWS_DEFAULT_REGION="$REGION"
 echo "Region: $REGION"
 
-RANDOM_ID=$(openssl rand -hex 4)
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)
 STREAM_NAME="stock-stream-${RANDOM_ID}"
 ROLE_NAME="kinesis-tut-role-${RANDOM_ID}"
 PRODUCER_NAME="stock-producer-${RANDOM_ID}"
diff --git a/tuts/095-aws-acm-gs/README.md b/tuts/095-aws-acm-gs/README.md
@@ -48,15 +48,3 @@ Free. There is no charge for ACM-issued public SSL/TLS certificates.
 - [DNS validation](https://docs.aws.amazon.com/acm/latest/userguide/dns-validation.html)
 - [Tagging ACM certificates](https://docs.aws.amazon.com/acm/latest/userguide/tags.html)
 - [Deleting certificates](https://docs.aws.amazon.com/acm/latest/userguide/gs-acm-delete.html)
-
----
-
-## Appendix: Generation details
-
-| Field | Value |
-|-------|-------|
-| Generation date | 2026-04-14 |
-| Source script | New, 76 lines |
-| Script test result | EXIT 0, 7s, 5 steps, no issues |
-| Issues encountered | DNS validation record sometimes empty on first describe (cosmetic) |
-| Iterations | v1 (direct to publish) |
diff --git a/tuts/095-aws-acm-gs/REVISION-HISTORY.md b/tuts/095-aws-acm-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 095-aws-acm-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/095-aws-acm-gs/aws-acm-gs.sh b/tuts/095-aws-acm-gs/aws-acm-gs.sh
@@ -14,7 +14,7 @@ fi
 export AWS_DEFAULT_REGION="$REGION"
 echo "Region: $REGION"
 
-RANDOM_ID=$(openssl rand -hex 4)
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)
 DOMAIN="tutorial-${RANDOM_ID}.example.com"
 
 handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }
diff --git a/tuts/100-aws-secrets-manager-gs/REVISION-HISTORY.md b/tuts/100-aws-secrets-manager-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 100-aws-secrets-manager-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/100-aws-secrets-manager-gs/aws-secrets-manager-gs.sh b/tuts/100-aws-secrets-manager-gs/aws-secrets-manager-gs.sh
@@ -14,7 +14,7 @@ fi
 export AWS_DEFAULT_REGION="$REGION"
 echo "Region: $REGION"
 
-RANDOM_ID=$(openssl rand -hex 4)
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)
 SECRET_NAME="tutorial/db-creds-${RANDOM_ID}"
 
 handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }
diff --git a/tuts/101-aws-step-functions-gs/REVISION-HISTORY.md b/tuts/101-aws-step-functions-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 101-aws-step-functions-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/101-aws-step-functions-gs/aws-step-functions-gs.sh b/tuts/101-aws-step-functions-gs/aws-step-functions-gs.sh
@@ -14,7 +14,7 @@ fi
 export AWS_DEFAULT_REGION="$REGION"
 echo "Region: $REGION"
 
-RANDOM_ID=$(openssl rand -hex 4)
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)
 SM_NAME="tut-state-machine-${RANDOM_ID}"
 ROLE_NAME="sfn-tut-role-${RANDOM_ID}"
 
diff --git a/tuts/112-amazon-cognito-gs/REVISION-HISTORY.md b/tuts/112-amazon-cognito-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 112-amazon-cognito-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/112-amazon-cognito-gs/amazon-cognito-gs.sh b/tuts/112-amazon-cognito-gs/amazon-cognito-gs.sh
@@ -14,7 +14,7 @@ fi
 export AWS_DEFAULT_REGION="$REGION"
 echo "Region: $REGION"
 
-RANDOM_ID=$(openssl rand -hex 4)
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)
 POOL_NAME="tut-pool-${RANDOM_ID}"
 
 handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }
