https://github.com/fargito/rust-cdk-serverless

Sample Rust Serverless App deployed with CDK
https://github.com/fargito/rust-cdk-serverless

aws-cdk rust serverless

Last synced: 5 days ago
JSON representation

Sample Rust Serverless App deployed with CDK

• Host: GitHub
• URL: https://github.com/fargito/rust-cdk-serverless
• Owner: fargito
• Created: 2023-10-25T14:11:03.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-12-16T07:20:47.000Z (6 days ago)
• Last Synced: 2024-12-16T07:25:59.314Z (6 days ago)
• Topics: aws-cdk, rust, serverless
• Language: Rust
• Homepage:
• Size: 1.91 MB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Serverless CDK Rust

A sample serverless app with Rust. I'm just experimenting stuff here so don't take anything at face value 🙃.

## Features

Current features:

- ✅ Synchronous lambdas

- ✅ Asynchronous lambdas

- ✅ IAC unit tests

- 🕑 Lambda unit tests

- ✅ Integration tests

- ✅ Preview environments

- ❌ Frontend

## Overview

A **very** simple todo API to create, retrieve and delete todos. No front for now.

This is the architecture schema:

![Todo API schema](./docs/img/rust-cdk-serverless.png)

## Setup

### Requirements

**NodeJS**: See [official NodeJS install docs](https://nodejs.org/en/learn/getting-started/how-to-install-nodejs). The current NodeJS version is stored in `.nvmrc`. If you use `nvm`, you can run:

```bash

nvm use

```

**Pnpm**: dependency manager. Install with:

```bash

npm install -g pnpm

```

**Rust toolchain**: the Rust version is pinned in `rust-toolchain.toml`. Follow [the official install instructions](https://www.rust-lang.org/tools/install).

**Cargo Lambda**: in order to cross-compile Rust code to Lambda runtime. Follow [install instructions](https://www.cargo-lambda.info/guide/installation.html).

### Installation

Install NodeJS dependencies:

```bash

pnpm install

```

### AWS Setup

In order to deploy, you will need an AWS account. If you don't have one, refer to the AWS documentation.

Then install the AWS CLI: [install docs](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).

Setup a local profile:

```bash

aws configure --profile 

```

## Build & Deploy

### Build Rust Lambda code

```bash

pnpm build

```

### Run tests

```bash

pnpm test

```

### Deploy

⚠ Warning: you may have to log in to your AWS profile again, depending on the setup method.

```bash

pnpm run deploy --profile 

```

### Run integration tests

```bash

pnpm test-integration

```