Repository files navigation

A collection of LocalStack related and managed Devcontainer Feature(s).

Features are self-contained units of installation code and development container configuration.Features are designed to install atop a wide-range of base container images (this repo focuses on debian based images).

• LocalStack: install the LocalStack CLI tool and any of the relatedLocal™ tools for:
  • AWS CLI
  • AWS CDK
  • AWS SAM CLI
  • Terraform
  • Pulumi

To reference a feature from this repository, add the desired features to adevcontainer.json.Each feature has aREADME.md that shows how to reference the feature and which options are available for that feature.

The example below installs the LocalStack CLI declared in the./src directory of this repository.

See the relevant feature's README for supported options.

{"image":"mcr.microsoft.com/devcontainers/base:ubuntu","features": {"ghcr.io/localstack/devcontainer-feature/localstack-cli": {}    }}

Similar to thedevcontainers/features repo, this repository has asrc folder.Each feature has its own sub-folder, containing at least adevcontainer-feature.json and an entrypoint scriptinstall.sh.

├── src│   ├── hello│   │   ├── devcontainer-feature.json│   │   └── install.sh│   ├── color│   │   ├── devcontainer-feature.json│   │   └── install.sh|   ├── ...│   │   ├── devcontainer-feature.json│   │   └── install.sh...

Animplementing tool will compositethe documented dev container properties from the feature'sdevcontainer-feature.json file, and execute in theinstall.sh entrypoint script in the container during build time.Implementing tools are also free to process attributes under thecustomizations property as desired.