awesome-compose/localstack

LocalStack

This example shows how to use LocalStack to emulate AWS services locally using docker compose.

Project structure:

.
├── init.d/
│   └── init.sh
├── compose.yaml
└── README.md

compose.yaml

services:
  localstack:
    image: localstack/localstack:2.3.2
    ports:
      - "4566:4566" # LocalStack Gateway
      - "4510-4559:4510-4559" # external services port range
    ...

Deploy with docker compose

docker compose up -d

It will execute the scripts located in the init.d/ folder to bootstrap the resources.

Resources

Once the docker compose is up, it will create the following resources:

• DynamoDB Table
• Kinesis Stream
• S3 Bucket
• SQS Queue

LocalStack Desktop

You can use LocalStack Desktop to manage the resources created by the docker compose.

Testing the services

From outside the container you can execute the following commands to test the service each service:

• DynamoDB

$ awslocal dynamodb list-tables
{
    "TableNames": [
        "my_table"
    ]
}

• Kinesis

$ awslocal kinesis list-streams
{
    "StreamNames": [
        "my_stream"
    ]
}

• S3

$ awslocal s3 ls
2022-08-08 03:16:01 example-bucket

• SQS

$ awslocal sqs list-queues
{
    "QueueUrls": [
        "http://localhost:4566/000000000000/my_queue"
    ]
}