Skip to content

lambda.md

Latest commit

 

History

History
88 lines (72 loc) · 3.66 KB

lambda.md

File metadata and controls

88 lines (72 loc) · 3.66 KB
Raw

Lambda

Gopherstack supports AWS Lambda with Docker image-based functions only.

Important: Only PackageType: Image is supported. Zip deployments, S3-based code delivery, and inline code are not supported. Functions must be packaged as Docker images.

For full Lambda documentation including the runtime architecture, container pool management, and Podman support, see docs/architecture/lambda.md.

Supported Operations

Operation Description
CreateFunction Create a new image-based Lambda function
GetFunction Get function configuration and code location
ListFunctions List all functions
DeleteFunction Delete a function and its warm containers
UpdateFunctionCode Update the Docker image URI
UpdateFunctionConfiguration Update memory, timeout, environment variables, etc.
InvokeFunction Invoke a function synchronously or asynchronously
CreateEventSourceMapping Create an SQS trigger for a function
GetEventSourceMapping Get a specific event source mapping
ListEventSourceMappings List event source mappings
DeleteEventSourceMapping Remove an event source mapping
CreateFunctionURLConfig Create a function URL
GetFunctionURLConfig Get the function URL configuration
DeleteFunctionURLConfig Delete a function URL
PublishVersion Publish the current function code as an immutable version
ListVersionsByFunction List published versions
CreateAlias Create a function alias pointing to a version
GetAlias Get an alias configuration
ListAliases List all aliases for a function

AWS CLI Examples

# Create an image-based function
aws --endpoint-url http://localhost:8000 lambda create-function \
    --function-name my-function \
    --package-type Image \
    --code ImageUri=public.ecr.aws/lambda/python:3.12 \
    --role arn:aws:iam::000000000000:role/my-role

# Invoke synchronously
aws --endpoint-url http://localhost:8000 lambda invoke \
    --function-name my-function \
    --payload '{"key":"value"}' \
    response.json

# Invoke asynchronously (fire-and-forget)
aws --endpoint-url http://localhost:8000 lambda invoke \
    --function-name my-function \
    --invocation-type Event \
    --payload '{"key":"value"}' \
    /dev/null

# Update the image
aws --endpoint-url http://localhost:8000 lambda update-function-code \
    --function-name my-function \
    --image-uri myrepo/myimage:v2

# Create an SQS trigger
aws --endpoint-url http://localhost:8000 lambda create-event-source-mapping \
    --function-name my-function \
    --event-source-arn arn:aws:sqs:us-east-1:000000000000:my-queue \
    --batch-size 10

# Create a function URL
aws --endpoint-url http://localhost:8000 lambda create-function-url-config \
    --function-name my-function \
    --auth-type NONE

Known Limitations

  • Only PackageType: Image is supported. Zip/S3 deployments are not implemented.
  • Docker must be running on the host machine.
  • Lambda Layers are not supported.
  • VPC configuration is accepted but not applied.
  • Reserved concurrency and provisioned concurrency are accepted but not enforced.

Configuration

Flag Env Var Default Description
--lambda-docker-host LAMBDA_DOCKER_HOST 172.17.0.1 Host Lambda containers use to reach Gopherstack
--lambda-pool-size LAMBDA_POOL_SIZE 3 Warm container pool size per function
--lambda-idle-timeout LAMBDA_IDLE_TIMEOUT 10m Idle container lifetime before reaping
--container-runtime CONTAINER_RUNTIME docker docker, podman, or auto