Home

Awesome

gocloud-blob-s3

This is thing wrapper around the default go-cloud S3 blob opener to check for a credentials parameter (in blob URIs) and use it to assign AWS S3 session credentials.

Important

This package is DEPRECATED and the relevant functionality has been moved in to the aaronland/go-cloud package.

To use the s3blob:// bucket implementation import it as:

import (
       _ "github.com/aaronland/gocloud-blob/s3"
)

Example

import (
	"context"
	"gocloud.dev/blob"
	
	_ "github.com/aaronland/gocloud-blob-s3"
)

func main() {

	ctx := context.Background()	
	bucket, _ := blob.OpenBucket(ctx, "s3blob://BUCKET?region=REGION&credentials=CREDENTIALS")

	// do stuff with bucket here
}

Note the use of the s3blob:// scheme which is different than the default s3:// scheme.

Credentials

Credentials for AWS sessions are defined as string labels. They are:

LabelDescription
env:Read credentials from AWS defined environment variables.
iam:Assume AWS IAM credentials are in effect.
{AWS_PROFILE_NAME}This this profile from the default AWS credentials location.
{AWS_CREDENTIALS_PATH}:{AWS_PROFILE_NAME}This this profile from a user-defined AWS credentials location.

See also