runtimevar

runtimevar

Simple wrapper around the Go Cloud runtimevar package

Documentation

Example

package main

import (
	"context"
	"flag"
	"fmt"
	
	"github.com/sfomuseum/runtimevar"
)

func main() {

	flag.Parse()

	ctx := context.Background()

	for _, uri := range flag.Args() {
		str_var, _ := runtimevar.StringVar(ctx, uri)
		fmt.Printf(str_var)
	}
}

Tools

$> make cli
go build -mod vendor -ldflags="-s -w" -o bin/runtimevar cmd/runtimevar/main.go

runtimevar

$> ./bin/runtimevar -h
Usage of ./bin/runtimevar:
  -timeout int
    	The maximum number of second in which a variable can be resolved. If 0 no timeout is applied.

Example

$> go run cmd/runtimevar/main.go 'constant://?val=hello+world'
hello world

Supported services

The following Go Cloud runtimevar services are supported by the runtimevar tool by default:

• AWS Parameter Store
• Blobvar
• Local

AWS Parameter Store

It is possible to load runtime variables from AWS Parameter Store using aaronland/go-aws-auth credential strings. For example:

$> go run cmd/runtimevar/main.go 'awsparamstore://hello-world?region=us-west-2&credentials=session'
hello world

Valid aaronland/go-aws-auth credential strings are:

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

Blob

The following GoCloud Blob providers are supported by default:

• S3
• Local

s3blob

In addition to the default s3:// Blob source it is possible to load runtime variables from S3 buckets using aaronland/go-aws-auth credential strings. For example:

$> go run cmd/runtimevar/main.go 'blobvar://hello-world?bucket-uri={BUCKET_URI}'
hello world

Where {BUCKET_URI} is a URL-escaped value like this:

s3blob://your-bucket?region=us-east-1&credentials=session

Valid aaronland/go-aws-auth credential strings are:

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

See also

• https://gocloud.dev/howto/runtimevar
• https://github.com/aaronland/go-aws-auth