https://github.com/jacobv90/localstack_terraform_python_lambda_ex
Example configuration for using Localstack and docker-compose.
https://github.com/jacobv90/localstack_terraform_python_lambda_ex
aws-lambda docker lambda-functions localstack python
Last synced: 8 months ago
JSON representation
Example configuration for using Localstack and docker-compose.
- Host: GitHub
- URL: https://github.com/jacobv90/localstack_terraform_python_lambda_ex
- Owner: JacobV90
- Created: 2020-05-09T03:02:34.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-24T16:46:52.000Z (about 1 year ago)
- Last Synced: 2025-03-28T20:12:16.232Z (9 months ago)
- Topics: aws-lambda, docker, lambda-functions, localstack, python
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AWS Lambda and Terraform local development using Localstack and Docker
## Why?.. To save time and money
By mocking some AWS services, we can develop locally without having to deploy to AWS. This capability will help increase the development cycle by reducing the feedback time.
This example project leverages a docker compose file to spin up a local Localstack instance and an infrastructure service that uses terraform to deploy an AWS Lambda Function to the running Localstack instance on your computer.
The docker-compose configuration will mount the projects directory to the docker containers started by localstack. This is done to enable rapid development. Any changes made will take effect when the file is saved so theres no need to redeploy the lambda function to localstack.
## Requirements
* python3.x
* docker and docker compose
## Installation
### Mac/Linux
``` bash
cd localstack_terraform_python_lambda_ex
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
### Windows
``` powershell
cd localstack_terraform_python_lambda_ex
python3 -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
```
Create a **.env** file in the top level directory with these variables:
```
TF_VAR_PROJECT_ABS_PATH={your_absolute_path_to_this_project}
TF_VAR_PYTHON_LIB_PATH={relative_path_to_python_packages}
```
## Running the example project
```
docker-compose up
```
After the docker images are pulled down and built, you should see Localstack outputting logs when its container is started. *The infrastructure service will wait for Localstack to be ready inorder to deploy the lambda function.*
Once the lambda function is deployed, run in a python virtual environment activated terminal:
```
awslocal lambda invoke --function-name lambda-function response.json
```
>[awslocal](https://github.com/localstack/awscli-local) is python package that mimics the **awscli** tool but is tailored towards Localstack. It makes it very easy to interact with Localstack like you normally would with AWS.
The lambda function should have been successfully invoked and should return its connection status to the MySql database.
**And thats it!**
You can now make changes to the lambda functions code without having to deploy to AWS or redeploy to Localstack.
If you found this example valuable and want to show some love, I wouldn't say no to a coffee 😄
Paypal -
https://paypal.me/therealveal?locale.x=en_US
Cashapp - https://cash.app/$theRealVeal
Bitcoin - 3HgZALWTyDFum4YcFwvjNvhYZHDUhJ45EQ
Ethereum - 0xED4e780A5E35d9d9cA0275302f16A394aeF7D862