feat: add new real life example and refactor repository layout

Author: skunxicat

Dockerfile

@@ -32,10 +32,6 @@ RUN dnf install -y jq python3 python3-libs  && \
 COPY --from=builder /aws-cli-bin/aws /usr/local/bin/aws
 COPY --from=builder /aws-cli /usr/local/aws-cli
 
-# Fix Python shared library path for AWS CLI v2
-RUN find /usr -name "libpython3*.so*" -exec cp {} /usr/local/bin/ \; 2>/dev/null || true
-
-
 # Copy http-cli
 COPY --from=builder /http-cli-bin/http-cli /var/task/bin/http-cli
 
@@ -46,4 +42,4 @@ RUN chmod +x /var/runtime/bootstrap
 
 WORKDIR /var/task
 
-COPY functions/handler.sh handler.sh
+COPY task/handler.sh handler.sh

README.md

@@ -6,27 +6,58 @@ Implement AWS Lambda functions in Bash, packaged as OCI-compliant container imag
 
 Inspired by: https://docs.aws.amazon.com/lambda/latest/dg/runtimes-walkthrough.html
 
-## Runtime Variants
 
-Each runtime variant has its own Dockerfile:
+This custom Lambda runtime enables Bash-based execution with minimal dependencies. We provide three image variants tailored to different needs:
 
-- `tiny`: [`jq`](https://stedolan.github.io/jq/) + [`http-cli`](https://github.com/ql4b/http-cli)
-- `slim`: same as `tiny` + AWS CLI v1
-- `full`: same as `slim` + AWS CLI v2
+## Runtime Image Variants
 
-### Build locally
+### 1. `tiny`
+- Includes: `jq`, `curl`
+- Use case: Lightweight data parsing and HTTP requests.
 
-```bash
-# Build tiny
-docker build -f tiny.Dockerfile -t lambda-shell-runtime:tiny .
+### 2. `micro`
+- Based on: `tiny`
+- Adds: `awscurl`
+- Use case: AWS API calls using IAM credentials without full AWS CLI.
+
+### 3. `full`
+- Based on: `tiny`
+- Adds: **full AWS CLI** (official install)
+- Use case: Complete access to AWS CLI features.
+- Note: Previously experimented with intermediate setups (e.g., stripped-down AWS CLI), but they proved unstable. This variant now uses the official, standard installation of the AWS CLI.
 
-# Build slim
-docker build -f slim.Dockerfile -t lambda-shell-runtime:slim .
+---
 
-# Build full
-docker build -f Dockerfile -t lambda-shell-runtime:full .
+Each image is built from the same base but optimized for different tasks. You can choose the right variant for your Lambda depending on the environment and tools required.
+
+Each runtime variant has its own Dockerfile:
+
+## Local build process
+
+To run the script locally:
+
+```
+./build --platform linux/arm64 --tag your-repo/lambda-shell --load micro
 ```
 
+```
+./build --platform linux/arm64 --tag your-repo/lambda-shell --push micro
+```
+
+Key Features:
+
+* Platform targeting: Defaults to linux/arm64, which is suitable for AWS Lambda ARM-based functions.
+* Variants: You can build one or more of the supported variants: tiny, micro, or full.
+* Secrets: Supports injecting a GitHub token via --secret id=github_token,env=GITHUB_TOKEN for private dependency access during build.
+
+Modes:
+* `--load` (default): Loads the image into the local Docker engine.
+* `--push`: Pushes the image to a remote registry.
+
+## GitHub Actions Build
+
+In a GitHub Actions environment, the build script is typically used in combination with Docker Buildx and secrets configured in the CI pipeline.
+
 ## Usage
 
 To use this runtime in your own Lambda container image:

build

@@ -10,7 +10,6 @@ TAG="lambda-shell-runtime"
 # VARIANTS="tiny slim full"
 VARIANTS="tiny micro"
 
-
 # Parse arguments
 while [ $# -gt 0 ]; do
   case "$1" in

examples/Dockerfile

@@ -1,7 +1,13 @@
 # FROM ghcr.io/ql4b/lambda-shell-runtime:0.1.0-develop.10-full
 FROM lambda-shell-runtime:micro
 # FROM ghcr.io/ql4b/lambda-shell-runtime:0.1.0-develop.10-slim
+FROM ghcr.io/ql4b/lambda-shell-runtime:0.1.0-develop.11-tiny
 
 WORKDIR /var/task
 
-COPY service.sh handler.sh
+RUN dnf install -y util-linux && \
+    cp /usr/bin/uuidgen /var/task/bin/ && \
+    dnf remove -y util-linux && \
+    dnf clean all
+
+COPY ./rrelay.sh handler.sh

examples/README.md

@@ -3,13 +3,15 @@
 ## buld 
 
 ```bash
-CONTAINER="shell-booking"
+# CONTAINER="shell-booking"
 # TAG="shell-booking:dev"
-TAG="703177223665.dkr.ecr.eu-central-1.amazonaws.com/ql4b-farecrumbs:booking"
+# TAG="703177223665.dkr.ecr.eu-central-1.amazonaws.com/ql4b-farecrumbs:booking"
+CONTAINER="rrlelay"
+TAG="rrlelay:dev"
+
 
 b () {
     docker build \
-    --no-cache \
     --platform linux/arm64  \
     -t "$TAG"  \
     --secret id=github_token,env=GITHUB_TOKEN \
@@ -23,6 +25,7 @@ r () {
         --platform linux/arm64 \
         -v ~/.aws:/root/.aws:ro \
         --volume ~/.aws-lambda-rie:/aws-lambda \
+        --volume ./rrelay.sh:/var/task/hander.sh:rw \
         --entrypoint /aws-lambda/aws-lambda-rie \
         --env HANDLER="handler.booking" \
         "$TAG" \

examples/rrelay.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+
+source $(realpath $(dirname $0))/rrelay.sh
+
+request='{"adults":1,"children":1,"infants":1,"teens":0,"origin":"NAP","destination":"BCN","dateOut":"2025-07-13"}'
+echo $request >&2
+correlation_id=$(uuidgen | tr '[:upper:]' '[:lower:]')
+# export USER_AGENT=$(randua)
+
+
+departureDate=$(echo "$request" | jq -r '.dateOut +"T00:00:00.000"')
+# echo "$departureDate" >&2
+
+flight=$(availability "$request" \
+    | jq --arg dateOut "$departureDate" '.trips[].dates[]|select(.dateOut == $dateOut).flights|first|del(.segments)'
+)
+# {"faresLeft":4,"flightKey":"FR~  59~ ~~NAP~07/10/2025 15:40~BCN~07/10/2025 17:40~~","infantsLeft":16,"regularFare":{"fareKey":"VES4L3AY6V7QCEKP25YZQOZOZFWRY6UDQRC75USHLWWP46O6ECSN3JO4DDEUY7PI6ZAYZLISSNP4PT65R2P2ARTBKRII4CWGMYQKF4XU5WT37LIAC6LWDC332SPT64QR3GVVX53FTHOJNJMUUVQHXIUMHUVE6N3XE3O7NOLV4B4LZPUNAUC6U7O3ZSFR246HBE4CAXKCCXWOHC45UGVSGFR4WCXUGBKVKW54IAFFT6EXQYIWSKSFUHLX2ESS3AYRWPRKDLH22KKRDX7HDT4XRZEEJZMLX5BS2WQ6M5ORROOZJ3FMAWVPPDOP3GY742C2OZDU5IEDFB3YAFOJPHSTPDAIG3IW6YDTHMNCHGI","fares":[{"type":"ADT","amount":197.99,"count":1,"hasDiscount":false,"publishedFare":197.99,"discountInPercent":0,"hasPromoDiscount":false,"discountAmount":0.0,"hasBogof":false,"isPrime":false}]},"operatedBy":"","isSSIMLoad":false,"flightNumber":"FR 59","time":["2025-07-10T15:40:00.000","2025-07-10T17:40:00.000"],"timeUTC":["2025-07-10T13:40:00.000Z","2025-07-10T15:40:00.000Z"],"duration":"02:00"}
+echo "$flight" | jq -c >&2
+
+basketID=$(create_basket | jq -r '.data.createBasket.id')
+# echo "basketId:$basketID" >&2
+culture=$(dashed_market "$market")
+# echo "$culture" >&2
+variables=$(booking_variables "$basketID" "$request" "$flight")
+# echo "$variables" | jq >&2
+export JWT_HANDLER=$(mktemp)
+create_booking "$variables" 
+echo "$JWT" >&2
+booking=$(commit_booking "$basketID" | jq  .data.commitBooking)
+echo "$booking" | jq >&2
+data=$(catalog_products "$basketID" "$JWT")
+echo "$data" | jq >&2

examples/run

@@ -19,14 +19,11 @@ do
   REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
 
   # Run the handler function from the script
-  # set -x
   RESPONSE=$($(echo "$HANDLER" | cut -d. -f2) "$EVENT_DATA")
-  # set +x
+
 
   echo "$RESPONSE" | curl -sS -X POST \
     "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/${REQUEST_ID}/response" \
     -H "Content-Type: application/json" \
     -d @-
-
-# --data-binary "$RESPONSE"
 done