This repository contains sample projects that can be deployed on your local machine using LocalStack.
Each example in the repository is self-contained and can be deployed individually using Pulumi & LocalStack on your local machine or in a CI/CD pipeline. The directory names are self-explanatory and each directory contains a README.md
file with instructions on how to deploy the example.
- LocalStack
- Docker
awslocal
CLI- Pulumi
make
&jq
If a sample project requires additional tools, it will be mentioned in the README.md
file of the project.
Some of the samples require LocalStack Pro features. Each directory will have a Markdown badge indicating whether the sample requires LocalStack Pro or not. If you are leveraging a LocalStack Pro sample, make sure to properly configure the LOCALSTACK_AUTH_TOKEN
environment variable. You can find your Auth Token in the LocalStack Web Application and you can refer to our Auth token documentation for more details.
Sample Name | Description |
---|---|
AppSync DynamoDB Endpoint | Sample demonstrating a GraphQL endpoint in AppSync with DynamoDB integration |
AWS API Gateway Auth0 | Integration of AWS API Gateway with Auth0 for secure authentication and authorization |
AWS Lambda StepFunctions | Sample demonstrating the implementation of Step Functions for orchestrating AWS Lambda functions |
Elastic Kubernetes Service | Sample for provisioning and configuring an Elastic Kubernetes Service (EKS) cluster |
Lambda Kinesis Firehose ES | Sample showcasing the integration of Lambda, Kinesis, Firehose, and Elasticsearch |
Lambda Layers | Sample demonstrating the usage of Lambda Layers to manage shared code and dependencies |
S3 SQS Queues | Sample for storing messages from Amazon Simple Queue Service (SQS) to Amazon S3 |
S3 Static Website | Creating a static website hosted on Amazon S3 using Pulumi |
Serverless REST API | Sample for setting up a serverless REST API on AWS |
SNS, SQS, and Lambda integration | Sample for setting up a SNS topic, SQS queue, and Lambda function to trigger on SNS messages |
To check out a single sample, you can use the following commands:
mkdir localstack-pulumi-samples && cd localstack-pulumi-samples
git init
git remote add origin -f git@github.com:localstack/localstack-pulumi-samples.git
git config core.sparseCheckout true
echo <LOCALSTACK_SAMPLE_DIRECTORY_NAME> >> .git/info/sparse-checkout
git pull origin master
The above commands use sparse-checkout
to only pull the sample you are interested in.
This code is available under the Apache 2.0 license.