LocalStack

A fully functional local AWS cloud stack for development and testing.

awscloudtesting

Usage

dockup.config.ts

import { defineConfig } from 'dockup/config';
import { localstack } from 'dockup/services';

export default defineConfig({
  services: [
    localstack()
  ],
});

Metadata

This service automatically exposes metadata.

dockup metadata

AWS Endpoint: http://localhost:4566

LocalStack gateway endpoint for all AWS services

AWS Credentials: Access Key: test, Secret Key: test

Access credentials for AWS SDK/CLI

AWS CLI Config: aws --endpoint-url=http://localhost:4566 --region=us-east-1

Configure AWS CLI to use LocalStack

S3 Example: aws --endpoint-url=http://localhost:4566 s3 ls

Example S3 command

The above are the metadata generated when using this service with the default options.

Options

Prop	Type	Default
`port?`	`number`	`4566`
`services?`	`string[]`	`undefined (all services)`
`region?`	`string`	`"us-east-1"`
`debug?`	`boolean`	`false`
`persistence?`	`boolean`	`false`
`accessKeyId?`	`string`	`"test"`
`secretAccessKey?`	`string`	`"test"`
`name?`	`string`	-
`image?`	`string`	-
`extend?`	`((service: ContainerService) => ContainerService)`	-