Features

Quick Start

# handler.shmain () {local event="$1"echo'{"message": "Hello from Bash Lambda!", "input":'"$event"'}'}

FROM ghcr.io/ql4b/lambda-shell-runtime:tinyCOPY handler.sh .

Runtime Variants

Available Images

# From GitHub Container Registryghcr.io/ql4b/lambda-shell-runtime:tinyghcr.io/ql4b/lambda-shell-runtime:micro  ghcr.io/ql4b/lambda-shell-runtime:full# From AWS Public ECRpublic.ecr.aws/j5r7n1v7/lambda-shell-runtime:tinypublic.ecr.aws/j5r7n1v7/lambda-shell-runtime:micropublic.ecr.aws/j5r7n1v7/lambda-shell-runtime:full

Examples

HTTP API with JSON Processing

# handler.shapi_handler() {local event="$1"local name=$(echo"$event"| jq -r'.queryStringParameters.name // "World"')echo'{        "statusCode": 200,        "headers": {"Content-Type": "application/json"},        "body":'{"greeting":"Hello, '"$name"'!"}'    }'}

AWS API Integration

# handler.sh (using micro variant)list_buckets() {local buckets=$(awscurl --service s3 https://s3.amazonaws.com/| jq'.ListAllMyBucketsResult.Buckets')echo'{"buckets":'"$buckets"'}'}

File Processing with AWS CLI

# handler.sh (using full variant)process_s3_file() {local event="$1"local bucket=$(echo"$event"| jq -r'.Records[0].s3.bucket.name')local key=$(echo"$event"| jq -r'.Records[0].s3.object.key')        aws s3 cp"s3://$bucket/$key" /tmp/input.jsonlocal result=$(jq'.data | length' /tmp/input.json)echo'{"processed": true, "count":'"$result"'}'}

Function Handler Format

# handler.shmy_function() {local event="$1"# Lambda event JSONlocal context="$2"# Lambda context (optional)# Process the eventlocal result=$(echo"$event"| jq'.key')# Return JSON responseecho'{"result":'"$result"'}'}

Deployment

Using AWS CLI

# Build and push your imagedocker build -t my-lambda.docker tag my-lambda:latest 123456789012.dkr.ecr.region.amazonaws.com/my-lambda:latestdocker push 123456789012.dkr.ecr.region.amazonaws.com/my-lambda:latest# Create/update Lambda functionaws lambda create-function \  --function-name my-bash-function \  --code ImageUri=123456789012.dkr.ecr.region.amazonaws.com/my-lambda:latest \  --role arn:aws:iam::123456789012:role/lambda-execution-role \  --package-type Image \  --architectures arm64 \  --timeout 30

Using Terraform

resource"aws_lambda_function""bash_function" {function_name="my-bash-function"role=aws_iam_role.lambda_role.arnpackage_type="Image"image_uri="123456789012.dkr.ecr.region.amazonaws.com/my-lambda:latest"timeout=30}

Local Testing

Using Lambda Runtime Interface Emulator

# Run your function locallydocker run --rm -p 9000:8080 \  --env _HANDLER="handler.hello" \  --entrypoint /aws-lambda/aws-lambda-rie \  my-lambda:latest /var/runtime/bootstrap# Test your functioncurl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" \  -d '{"name": "World"}'

Building from Source

# Clone the repositorygit clone https://github.com/ql4b/lambda-shell-runtime.gitcd lambda-shell-runtime# Build specific variant./build --platform linux/arm64 --tag my-runtime --load tiny# Build and push to registry./build --platform linux/arm64 --tag my-registry/lambda-shell --push micro

Build Options

Performance & Limitations

Size Comparison with Official AWS Lambda Runtimes

Troubleshooting

Common Issues

# Ensure your function is defined and you override# the CMD hander.my_function

# Ensure Lambda execution role has required permissions# For AWS API calls, add appropriate IAM policies

# Increase Lambda timeout setting# Optimize shell script performance

Updating http-cli Version

Contributing

Development Setup

git clone https://github.com/ql4b/lambda-shell-runtime.gitcd lambda-shell-runtime./build --load tiny# Build and test locally

Project Structure

lambda-shell-runtime/├── runtime/          # Custom bootstrap and runtime logic├── task/            # Helper functions and example handlers  ├── test/            # Test functions and runners├── scripts/         # Build and publishing utilities├── Dockerfile       # Multi-stage build definitions└── build           # Build script for all variants

License