Pointing AWS tools at Overcast
overcast env prints AWS_* exports for your shell to eval; overcast aws runs one AWS CLI call against the daemon with the ambient AWS environment scrubbed first.
overcast env redirects a whole shell; overcast aws redirects a single call.
Both clear the ambient AWS_* environment first, so a leftover AWS_PROFILE
or AWS_ENDPOINT_URL cannot quietly send the request to real AWS.
eval "$(overcast env)" # this shell, from here on
overcast aws s3 mb s3://my-bucketPart of the CLI reference. SDK, Terraform and per-language setup is in Using AWS SDKs and CLI.
overcast env
Prints AWS_* assignments for your shell to evaluate, preceded by an unset
line for every AWS_* variable already exported that these do not overwrite.
| Flag | Default | Description |
|---|---|---|
--region | (auto) | Region to export: $OVERCAST_REGION, else us-east-1. |
--shell | auto | auto (detected from the OS), sh, powershell or fish. |
eval "$(overcast env)" # sh / bash / zsh
overcast env --shell powershell | iex # PowerShell
overcast env --shell fish | sourceovercast aws [args...]
Runs the host aws CLI against the daemon with every AWS_* variable unset
and dummy credentials, region and endpoint substituted. Everything after aws
passes through verbatim, aws-native flags such as --debug included.
--endpoint is read as Overcast’s own only in the leading position — either
side of the aws token works. Anywhere else, and for --endpoint-url, it goes
to the AWS CLI untouched; with no flag at all, OVERCAST_ENDPOINT and
OVERCAST_PORT apply.
overcast aws s3 mb s3://my-bucket
overcast aws --endpoint http://localhost:4570 sqs list-queues
alias awslocal='overcast aws' # LocalStack muscle memoryRelated
- Using AWS SDKs and CLI — the full walkthrough, with SDK examples
- Migrating from LocalStack —
awslocaland the rest of the swap - Environment variable reference —
OVERCAST_PORTand every other environment variable