package discovery

import "github.com/appc/spec/discovery"

Package discovery contains an experimental implementation of the Image Discovery section of the appc specification.

Index ¶

• func DiscoverEndpoints(app App, insecure bool) (out *Endpoints, attempts []FailedAttempt, err error)
• func DiscoverPublicKeys(app App, insecure bool) (out *Endpoints, attempts []FailedAttempt, err error)
• func DiscoverWalk(app App, insecure bool, discoverFn DiscoverWalkFunc) (err error)
• type ACIEndpoint
• type App
• func NewApp(name string, labels map[string]string) (*App, error)
• func NewAppFromString(app string) (*App, error)
• type DiscoverWalkFunc
• type Endpoints
• func (e *Endpoints) Append(ep Endpoints)
• type FailedAttempt

Functions ¶

func DiscoverEndpoints ¶

func DiscoverEndpoints(app App, insecure bool) (out *Endpoints, attempts []FailedAttempt, err error)

DiscoverEndpoints will make HTTPS requests to find the ac-discovery meta tags and optionally will use HTTP if insecure is set. It will not give up until it has exhausted the path or found an image discovery.

func DiscoverPublicKeys ¶

func DiscoverPublicKeys(app App, insecure bool) (out *Endpoints, attempts []FailedAttempt, err error)

DiscoverPublicKey will make HTTPS requests to find the ac-public-keys meta tags and optionally will use HTTP if insecure is set. It will not give up until it has exhausted the path or found an public key.

func DiscoverWalk ¶

func DiscoverWalk(app App, insecure bool, discoverFn DiscoverWalkFunc) (err error)

DiscoverWalk will make HTTPS requests to find discovery meta tags and optionally will use HTTP if insecure is set. Based on the response of the discoverFn it will continue to recurse up the tree.

Types ¶

type ACIEndpoint ¶

type ACIEndpoint struct {
	ACI string
	ASC string
}

type App ¶

type App struct {
	Name   types.ACName
	Labels map[string]string
}

func NewApp ¶

func NewApp(name string, labels map[string]string) (*App, error)

func NewAppFromString ¶

func NewAppFromString(app string) (*App, error)

NewAppFromString takes a command line app parameter and returns a map of labels.

Example app parameters:

example.com/reduce-worker:1.0.0
example.com/reduce-worker,channel=alpha,label=value

type DiscoverWalkFunc ¶

type DiscoverWalkFunc func(prefix string, eps *Endpoints, err error) error

DiscoverWalkFunc can stop a DiscoverWalk by returning non-nil error.

type Endpoints ¶

type Endpoints struct {
	ACIEndpoints []ACIEndpoint
	Keys         []string
}

func (*Endpoints) Append ¶

func (e *Endpoints) Append(ep Endpoints)

type FailedAttempt ¶

type FailedAttempt struct {
	Prefix string
	Error  error
}

FailedAttempt represents a failed discovery attempt. This is for debugging and user feedback.

Source Files ¶

discovery.go doc.go http.go parse.go