Skip to content

Latest commit

 

History

History
63 lines (40 loc) · 3.71 KB

README.md

File metadata and controls

63 lines (40 loc) · 3.71 KB
Raw

LocalStack.NET AWS CLI

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.

Continuous integration

Build server Platform Build status
Azure Pipelines Ubuntu Build Status
Azure Pipelines macOs Build Status
Azure Pipelines Windows Build Status

Installation

You can install the awslocal command via .NET Core CLI:

dotnet tool install --global LocalStack.AwsLocal
Stable Nightly
NuGet MyGet

Usage

The awslocal command has the same usage as the aws command. For detailed usage, please refer to the man pages of aws help.

Example

Instead of the following command ...

aws --endpoint-url=http://localhost:4568 kinesis list-streams

... you can simply use this:

awslocal kinesis list-streams

Configurations

You can use the following environment variables for configuration:

  • LOCALSTACK_HOST: Set the hostname for the localstack instance. Useful when you have localstack is bound to another interface (i.e. docker-machine).
  • USE_SSL: Whether to use https endpoint URLs (required if LocalStack has been started with USE_SSL=true enabled). Defaults to false.

License

Licensed under MIT, see LICENSE for the full text.