Skip to content

docs: point pre-built Lambda install at GitHub releases #123

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rampage644 merged 1 commit into from
Apr 10, 2026
Merged

docs: point pre-built Lambda install at GitHub releases #123

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,10 @@ See the full [Quick Start guide](https://docs.embucket.com/getting-started/quick

## Deploy

Deploy Embucket to AWS Lambda with the pre-built zip:
Deploy Embucket to AWS Lambda with the pre-built zip from the latest [GitHub release](https://github.com/Embucket/embucket/releases/latest):

```bash
aws s3 cp s3://embucket-releases/lambda/embucket-lambda-latest.zip .
gh release download --repo Embucket/embucket --pattern 'embucket-lambda-*-arm64.zip'
```

See the [AWS Lambda deployment guide](https://docs.embucket.com/deploy/aws-lambda/) for configuration and production setup.
Expand Down
16 changes: 10 additions & 6 deletions docs/src/content/docs/deploy/aws-lambda.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -109,39 +109,43 @@ Save the bucket name, region, and ARN. You need these values in the next step.

</TabItem>
<TabItem label="Pre-built binary">
Download the pre-built Lambda zip from S3:
Download the pre-built Lambda zip from the latest [GitHub release](https://github.com/Embucket/embucket/releases/latest). Each release publishes both `arm64` and `x86_64` assets named `embucket-lambda-<version>-<arch>.zip`.

Use the [GitHub CLI](https://cli.github.com/) to pull the latest asset for your target architecture:

```bash
aws s3 cp s3://embucket-releases/lambda/embucket-lambda-latest.zip .
gh release download --repo Embucket/embucket --pattern 'embucket-lambda-*-arm64.zip'
```

For `x86_64`, swap the pattern to `'embucket-lambda-*-x86_64.zip'`. To grab a specific version, pass `--tag v1.2.3`.

<Aside type="note">
The pre-built binary includes the `state-store-query` feature for DynamoDB-backed query state persistence.
</Aside>

Create the Lambda function:
Create the Lambda function, pointing `--zip-file` at the downloaded asset:

```bash
aws lambda create-function \
--function-name embucket-lambda \
--runtime provided.al2023 \
--architectures arm64 \
--handler bootstrap \
--zip-file fileb://embucket-lambda-latest.zip \
--zip-file fileb://embucket-lambda-<version>-arm64.zip \
--role arn:aws:iam::123456789012:role/embucket-lambda-role \
--memory-size 3008 \
--timeout 30 \
--environment "Variables={METASTORE_CONFIG=config/metastore.yaml,LOG_FORMAT=json,TRACING_LEVEL=debug,RUST_LOG=info}"
```

Replace the role ARN with your own execution role.
Replace the role ARN with your own execution role and `<version>` with the tag you downloaded.

To update an existing function:

```bash
aws lambda update-function-code \
--function-name embucket-lambda \
--zip-file fileb://embucket-lambda-latest.zip
--zip-file fileb://embucket-lambda-<version>-arm64.zip
```

</TabItem>
Expand Down
Loading