LocalStack (AWS Emulation)

Access

AWS CLI usage

Point any AWS CLI command at LocalStack by adding --endpoint-url:

# Configure dummy credentials (only needed once)
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1

ENDPOINT="https://localstack.<env-name>.ops.aithroyz.com"

# Create an S3 bucket
aws s3 mb s3://my-sandbox-bucket --endpoint-url "$ENDPOINT"

# Upload a file
aws s3 cp ./data.json s3://my-sandbox-bucket/ --endpoint-url "$ENDPOINT"

# List bucket contents
aws s3 ls s3://my-sandbox-bucket --endpoint-url "$ENDPOINT"

# Create a DynamoDB table
aws dynamodb create-table   --table-name Events   --attribute-definitions AttributeName=id,AttributeType=S   --key-schema AttributeName=id,KeyType=HASH   --billing-mode PAY_PER_REQUEST   --endpoint-url "$ENDPOINT"

Lambda deployment

Deploy and invoke Lambda functions against LocalStack the same way you would against AWS:

ENDPOINT="https://localstack.<env-name>.ops.aithroyz.com"

# Package your handler
zip function.zip handler.py

# Deploy the function
aws lambda create-function   --function-name my-handler   --runtime python3.12   --role arn:aws:iam::000000000000:role/lambda-role   --handler handler.lambda_handler   --zip-file fileb://function.zip   --endpoint-url "$ENDPOINT"

# Invoke it synchronously
aws lambda invoke   --function-name my-handler   --payload '{"key":"value"}'   --endpoint-url "$ENDPOINT"   response.json && cat response.json

Python (boto3)

Configure boto3 clients to point at LocalStack by setting endpoint_url:

import boto3

ENDPOINT = "https://localstack.<env-name>.ops.aithroyz.com"

# S3 client
s3 = boto3.client(
    "s3",
    endpoint_url=ENDPOINT,
    aws_access_key_id="test",
    aws_secret_access_key="test",
    region_name="us-east-1",
)

s3.create_bucket(Bucket="my-sandbox-bucket")
s3.put_object(Bucket="my-sandbox-bucket", Key="hello.txt", Body=b"Hello, LocalStack!")

# DynamoDB resource
dynamodb = boto3.resource(
    "dynamodb",
    endpoint_url=ENDPOINT,
    aws_access_key_id="test",
    aws_secret_access_key="test",
    region_name="us-east-1",
)

table = dynamodb.Table("Events")
table.put_item(Item={"id": "evt-001", "severity": "high", "source": "wazuh"})

Tips