mirror of
https://github.com/floci-io/floci.git
synced 2026-11-21 02:56:30 +08:00
131 lines
3.7 KiB
Markdown
131 lines
3.7 KiB
Markdown
# Lambda
|
|
|
|
**Protocol:** REST JSON
|
|
**Endpoint:** `http://localhost:4566/2015-03-31/functions/...`
|
|
|
|
Lambda runs your function code inside real Docker containers — the same way real AWS Lambda does.
|
|
|
|
## Supported Operations
|
|
|
|
| Operation | Description |
|
|
|---|---|
|
|
| `CreateFunction` | Deploy a Lambda function |
|
|
| `GetFunction` | Get function details and download URL |
|
|
| `GetFunctionConfiguration` | Get runtime configuration |
|
|
| `ListFunctions` | List all functions |
|
|
| `UpdateFunctionCode` | Upload new code |
|
|
| `DeleteFunction` | Remove a function |
|
|
| `Invoke` | Invoke a function synchronously or asynchronously |
|
|
| `CreateEventSourceMapping` | Connect SQS / Kinesis / DynamoDB Streams to a function |
|
|
| `GetEventSourceMapping` | Get event source mapping details |
|
|
| `ListEventSourceMappings` | List all event source mappings |
|
|
| `UpdateEventSourceMapping` | Update a mapping |
|
|
| `DeleteEventSourceMapping` | Remove a mapping |
|
|
| `PublishVersion` | Publish an immutable version |
|
|
| `CreateAlias` | Create a named alias pointing to a version |
|
|
| `GetAlias` | Get alias details |
|
|
| `ListAliases` | List all aliases for a function |
|
|
| `UpdateAlias` | Update an alias |
|
|
| `DeleteAlias` | Delete an alias |
|
|
|
|
## Configuration
|
|
|
|
```yaml
|
|
floci:
|
|
services:
|
|
lambda:
|
|
enabled: true
|
|
ephemeral: false # Remove container after each invocation
|
|
default-memory-mb: 128
|
|
default-timeout-seconds: 3
|
|
docker-host: unix:///var/run/docker.sock
|
|
runtime-api-base-port: 9200
|
|
runtime-api-max-port: 9299
|
|
code-path: ./data/lambda-code # ZIP storage location
|
|
poll-interval-ms: 1000
|
|
container-idle-timeout-seconds: 300 # Idle container cleanup
|
|
```
|
|
|
|
### Docker socket requirement
|
|
|
|
Lambda requires the Docker socket. Mount it in your compose file:
|
|
|
|
```yaml
|
|
services:
|
|
floci:
|
|
volumes:
|
|
- /var/run/docker.sock:/var/run/docker.sock
|
|
```
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
export AWS_ENDPOINT=http://localhost:4566
|
|
|
|
# Package a simple Node.js function
|
|
cat > index.mjs << 'EOF'
|
|
export const handler = async (event) => {
|
|
console.log("Event:", JSON.stringify(event));
|
|
return { statusCode: 200, body: JSON.stringify({ hello: "world" }) };
|
|
};
|
|
EOF
|
|
zip function.zip index.mjs
|
|
|
|
# Deploy the function
|
|
aws lambda create-function \
|
|
--function-name my-function \
|
|
--runtime nodejs22.x \
|
|
--role arn:aws:iam::000000000000:role/lambda-role \
|
|
--handler index.handler \
|
|
--zip-file fileb://function.zip \
|
|
--endpoint-url $AWS_ENDPOINT
|
|
|
|
# Invoke synchronously
|
|
aws lambda invoke \
|
|
--function-name my-function \
|
|
--payload '{"key":"value"}' \
|
|
--cli-binary-format raw-in-base64-out \
|
|
response.json \
|
|
--endpoint-url $AWS_ENDPOINT
|
|
|
|
cat response.json
|
|
|
|
# Invoke asynchronously
|
|
aws lambda invoke \
|
|
--function-name my-function \
|
|
--invocation-type Event \
|
|
--payload '{"key":"value"}' \
|
|
--cli-binary-format raw-in-base64-out \
|
|
/dev/null \
|
|
--endpoint-url $AWS_ENDPOINT
|
|
|
|
# Update code
|
|
zip function.zip index.mjs
|
|
aws lambda update-function-code \
|
|
--function-name my-function \
|
|
--zip-file fileb://function.zip \
|
|
--endpoint-url $AWS_ENDPOINT
|
|
```
|
|
|
|
## Event Source Mappings
|
|
|
|
Connect Lambda to SQS, Kinesis, or DynamoDB Streams:
|
|
|
|
```bash
|
|
# SQS trigger
|
|
QUEUE_ARN=$(aws sqs get-queue-attributes \
|
|
--queue-url $AWS_ENDPOINT/000000000000/orders \
|
|
--attribute-names QueueArn \
|
|
--query Attributes.QueueArn --output text \
|
|
--endpoint-url $AWS_ENDPOINT)
|
|
|
|
aws lambda create-event-source-mapping \
|
|
--function-name my-function \
|
|
--event-source-arn $QUEUE_ARN \
|
|
--batch-size 10 \
|
|
--endpoint-url $AWS_ENDPOINT
|
|
```
|
|
|
|
## Supported Runtimes
|
|
|
|
Any runtime that has an official AWS Lambda container image works with Floci (e.g. `nodejs22.x`, `python3.13`, `java21`, `go1.x`, `provided.al2023`). |