https://github.com/localstack-samples/sample-rust-lambda
Sample Rust Lambda
https://github.com/localstack-samples/sample-rust-lambda
Last synced: 9 months ago
JSON representation
Sample Rust Lambda
- Host: GitHub
- URL: https://github.com/localstack-samples/sample-rust-lambda
- Owner: localstack-samples
- Archived: true
- Created: 2024-02-29T16:00:19.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-29T22:03:17.000Z (almost 2 years ago)
- Last Synced: 2025-02-17T14:44:42.494Z (11 months ago)
- Language: Rust
- Size: 189 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Rust Rest AWS Lambda
See the AWS docs [here](https://docs.aws.amazon.com/lambda/latest/dg/lambda-rust.html) for more information on creating Rust Lambdas.
## Prerequisites
1. Docker Desktop is running
2. LocalStack Pro auth token is set in the environment variable LOCALSTACK_AUTH_TOKEN
## Setup
Create a file name .env-gdc-local and add the following to it:
```bash
export LOCALSTACK_AUTH_TOKEN=
```
## Either run a GDC or LocalStack
### Run LocalStack without GDC
```bash
make start-localstack
```
OR
### Run a GDC in the root of the repo.
Run a GDC (generic dev container) in the root of the repo.
1. Clone this [GDC](https://github.com/devxpod/GDC)
2. Run the GDC
```bash
/run-dev-container.sh
```
3. Connect to the GDC
```bash
docker exec -it rls-dev-1 bash -l
```
Building for lambda requires more libs be installed into the GDC to cross-compile the Rust binary.
Use the makefile target init-rust to install the necessary libs.
If you're running on a Mac and not in a GDC, you will have to put `sudo` in front of this make command.
```bash
make init-rust
```
## Build
```bash
make all
```
## Deploy to AWS or LocalStack
### Prerequisites
Set the AWS_ACCT variable in the makefile to the account number of the AWS account you want to deploy to.
AWS Account Number is defaulted to the LocalStack default account number.
Setup a profile in your ~/.aws/credentials file with the necessary permissions to create a lambda function.
To use a LocalStack profile, create it and set AWS_PROFILE like this [LocalStack AWS Profile](https://docs.localstack.cloud/user-guide/integrations/aws-cli/#configuring-a-custom-profile)
### Set AWS_PROFILE
If you are using LocalStack, set the AWS_PROFILE environment variable to the LocalStack profile.
Otherwise, set it to the profile in your ~/.aws/credentials file for your live AWS account.
```bash
export AWS_PROFILE=localstack
```
### Create Lambda Role
```bash
make create-lambda-role
```
### Deploy
Assume a role with the necessary permissions to create a lambda function.
```bash
make create-lambda-function
```
### Run integration tests
In the Ubuntu dev container, you probably have to run this twice. There is some issue with Rust compilation
on the Ubuntu dev container here. It doesn't happen on Mac and Windows.
```bash
make test
```
## Clean up
```bash
make delete-lambda
```