.NET Core global tool, thin wrapper around the "aws" command line interface for use with LocalStack
This .NET Core global tool provides the awslocal
command, which is a thin wrapper around the aws
command line interface for use with LocalStack. This tool is a .NET Core port of the
LocalStack AWS CLI for the people who have experienced issues with LocalStack AWS CLI.
Build server | Platform | Build status |
---|---|---|
Github Actions | Ubuntu | |
Github Actions | Windows | |
Github Actions | macOS |
You can install the awslocal
command via .NET Core CLI
:
dotnet tool install --global LocalStack.AwsLocal
Stable | Nightly |
---|---|
The awslocal
command has the same usage as the aws
command. For detailed usage,
please refer to the man pages of aws help
.
Instead of the following command …
aws --endpoint-url=http://localhost:4566 kinesis list-streams
… you can simply use this:
awslocal kinesis list-streams
You can use the following environment variables for configuration:
LOCALSTACK_HOST
: Set the hostname for the localstack instance. Useful when you havelocalhost
.USE_SSL
: Whether to use https
endpoint URLs (required if LocalStack has been startedUSE_SSL=true
enabled). Defaults to false
.USE_LEGACY_PORTS
: Whether to use old endpoint ports. Starting with LocalStack releases after v0.11.5
, all services are now exposed via the edge service (port 4566) only! If you are using a version of LocalStack lower than v0.11.5, you should set USE_LEGACY_PORTS
to true
. Defaults to false
.EDGE_PORT
: Set the edge port. Edge port can be set to any available port (see LocalStack configuration section). If you have made such a change in LocalStack’s configuration, be sure to set the same port value to EDGE_PORT
. Defaults to 4566
.DEFAULT_REGION
: Set the default region. Overrides AWS_DEFAULT_REGION
environment variable.Licensed under MIT, see LICENSE for the full text.