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

mwunderl · mwunderl · commit c02fd96dfe56 · 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/116-aws-xray-gs/REVISION-HISTORY.md b/tuts/116-aws-xray-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 116-aws-xray-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/116-aws-xray-gs/aws-xray-gs.sh b/tuts/116-aws-xray-gs/aws-xray-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)
 GROUP_NAME="tut-group-${RANDOM_ID}"
 
 handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }
@@ -34,15 +34,15 @@ TRACE_ID=$(python3 -c "import time,random;print(f'1-{int(time.time()):08x}-{rand
 NOW=$(python3 -c "import time;print(time.time())")
 END=$(python3 -c "import time;print(time.time()+0.5)")
 
-SEGMENT="{\"trace_id\":\"$TRACE_ID\",\"id\":\"$(openssl rand -hex 8)\",\"name\":\"tutorial-service\",\"start_time\":$NOW,\"end_time\":$END,\"http\":{\"request\":{\"method\":\"GET\",\"url\":\"https://example.com/api/items\"},\"response\":{\"status\":200}}}"
+SEGMENT="{\"trace_id\":\"$TRACE_ID\",\"id\":\"$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)\",\"name\":\"tutorial-service\",\"start_time\":$NOW,\"end_time\":$END,\"http\":{\"request\":{\"method\":\"GET\",\"url\":\"https://example.com/api/items\"},\"response\":{\"status\":200}}}"
 
 aws xray put-trace-segments --trace-segment-documents "$SEGMENT" \
     --query 'UnprocessedTraceSegments' --output text
 echo "  Trace ID: $TRACE_ID"
 
 # Send a subsegment
 PARENT_ID=$(echo "$SEGMENT" | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
-SUBSEG="{\"trace_id\":\"$TRACE_ID\",\"id\":\"$(openssl rand -hex 8)\",\"name\":\"database-query\",\"start_time\":$NOW,\"end_time\":$END,\"parent_id\":\"$PARENT_ID\"}"
+SUBSEG="{\"trace_id\":\"$TRACE_ID\",\"id\":\"$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)\",\"name\":\"database-query\",\"start_time\":$NOW,\"end_time\":$END,\"parent_id\":\"$PARENT_ID\"}"
 aws xray put-trace-segments --trace-segment-documents "$SUBSEG" > /dev/null 2>&1
 echo "  Sent parent segment + subsegment"
 
diff --git a/tuts/119-aws-glue-gs/REVISION-HISTORY.md b/tuts/119-aws-glue-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 119-aws-glue-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/119-aws-glue-gs/aws-glue-gs.sh b/tuts/119-aws-glue-gs/aws-glue-gs.sh
@@ -15,7 +15,7 @@ export AWS_DEFAULT_REGION="$REGION"
 ACCOUNT_ID=$(aws sts get-caller-identity --query 'Account' --output text)
 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)
 DB_NAME="tut_db_${RANDOM_ID}"
 TABLE_NAME="tut_events"
 BUCKET_NAME="glue-tut-${RANDOM_ID}-${ACCOUNT_ID}"
diff --git a/tuts/126-amazon-firehose-gs/REVISION-HISTORY.md b/tuts/126-amazon-firehose-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 126-amazon-firehose-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/126-amazon-firehose-gs/amazon-firehose-gs.sh b/tuts/126-amazon-firehose-gs/amazon-firehose-gs.sh
@@ -1,12 +1,12 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d)
 exec > >(tee -a "$WORK_DIR/firehose-$(date +%Y%m%d-%H%M%S).log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}
 [ -z "$REGION" ] && echo "ERROR: No region" && exit 1
 export AWS_DEFAULT_REGION="$REGION"
 ACCOUNT=$(aws sts get-caller-identity --query 'Account' --output text)
 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="tut-firehose-${RANDOM_ID}"
 BUCKET="firehose-tut-${RANDOM_ID}-${ACCOUNT}"
 ROLE_NAME="firehose-tut-role-${RANDOM_ID}"
diff --git a/tuts/132-amazon-ivs-gs/REVISION-HISTORY.md b/tuts/132-amazon-ivs-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 132-amazon-ivs-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/132-amazon-ivs-gs/amazon-ivs-gs.sh b/tuts/132-amazon-ivs-gs/amazon-ivs-gs.sh
@@ -1,8 +1,8 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d)
 exec > >(tee -a "$WORK_DIR/ivs-$(date +%Y%m%d-%H%M%S).log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
-RANDOM_ID=$(openssl rand -hex 4)
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1)
 CHANNEL_NAME="tut-channel-${RANDOM_ID}"
 handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }; trap 'handle_error $LINENO' ERR
 cleanup() { echo ""; echo "Cleaning up..."; [ -n "$CHANNEL_ARN" ] && aws ivs delete-channel --arn "$CHANNEL_ARN" 2>/dev/null && echo "  Deleted channel"; rm -rf "$WORK_DIR"; echo "Done."; }
diff --git a/tuts/137-amazon-location-gs/REVISION-HISTORY.md b/tuts/137-amazon-location-gs/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 137-amazon-location-gs
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/137-amazon-location-gs/amazon-location-gs.sh b/tuts/137-amazon-location-gs/amazon-location-gs.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/location.log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
-RANDOM_ID=$(openssl rand -hex 4); MAP_NAME="tut-map-${RANDOM_ID}"; INDEX_NAME="tut-index-${RANDOM_ID}"
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1); MAP_NAME="tut-map-${RANDOM_ID}"; INDEX_NAME="tut-index-${RANDOM_ID}"
 handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }; trap 'handle_error $LINENO' ERR
 cleanup() { echo ""; echo "Cleaning up..."; aws location delete-map --map-name "$MAP_NAME" 2>/dev/null && echo "  Deleted map"; aws location delete-place-index --index-name "$INDEX_NAME" 2>/dev/null && echo "  Deleted place index"; rm -rf "$WORK_DIR"; echo "Done."; }
 echo "Step 1: Creating map: $MAP_NAME"
