allthings/awscurl

Signed AWS API requests with a curl like API.

awscurl

Signed AWS API requests with a curl like API.

Setup

Docker alias

Define an alias for the docker based awscurl command:

alias awscurl='docker run --rm '\
'-e AWS_ACCESS_KEY_ID '\
'-e AWS_SECRET_ACCESS_KEY '\
'-e AWS_SECURITY_TOKEN '\
allthings/awscurl

OS dependent binary

Download one of the OS dependent release files, save it as /usr/local/bin/awscurl and make it executable with chmod +x /usr/local/bin/awscurl.

Usage

Environment variables

Set the following AWS CLI environment variables:

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY
• AWS_SECURITY_TOKEN (optional)

AWS_SECURITY_TOKEN (= AWS_SESSION_TOKEN) is only required when using the AWS Security Token Service.

The recommended way to store and provide AWS CLI credentials is by using aws-vault.

Options

awscurl [-X request_method] [-H header:value] [-d post_data] URL

Example

awscurl -X POST -H x-api-key:example -d '{"data":"example"}' \
  https://example.execute-api.eu-west-1.amazonaws.com/

Build

First, clone the project via go get and then switch into its source directory:

go get github.com/allthings/awscurl
cd "$GOPATH/src/github.com/allthings/awscurl"

To cross-compile binaries for Linux, MacOS and Window, execute the following:

make

The locally built binary can be installed at $GOPATH/bin/awscurl with the following command:

make install

The uninstall command removes the binary from $GOPATH/bin/awscurl:

make uninstall

To clean up all build artifacts, run the following:

make clean

Docker build

To build the Docker image, run the following:

make docker

Release

Create a GitHub personal access token with repo scope and set it as GITHUB_TOKEN environment variable.

Commit your changes, create a git tag and then execute the following to release the binaries on GitHub:

make release

License

Released under the MIT license.