store

Documentation

Index

• Constants
• func ComputeDigest(bundle io.WriterTo) (digest.Digest, error)
• func StringToNamedRef(s string) (reference.Named, error)
• type ApplicationStore
  • func NewApplicationStore(configDir string) (*ApplicationStore, error)
  • func (a ApplicationStore) BundleStore() (BundleStore, error)
  • func (a ApplicationStore) CredentialStore(context string) (CredentialStore, error)
  • func (a ApplicationStore) InstallationStore(context string) (InstallationStore, error)
• type BundleStore
  • func NewBundleStore(path string) (BundleStore, error)
• type CredentialStore
• type ID
  • func FromBundle(bndl *relocated.Bundle) (ID, error)
  • func FromString(s string) (ID, error)
  • func (id ID) Digest() digest.Digest
  • func (id ID) String() string
• type Installation
  • func NewInstallation(name string, reference string, bndl *relocated.Bundle) (*Installation, error)
  • func (i Installation) SetParameter(name string, value string)
• type InstallationStore
• type UnknownReferenceError
  • func (e *UnknownReferenceError) Error() string
  • func (e *UnknownReferenceError) NotFound()

Constants

const (
	// AppConfigDirectory is the Docker App directory name inside Docker config directory
	AppConfigDirectory = "app"
	// BundleStoreDirectory is the bundle store directory name
	BundleStoreDirectory = "bundles"
	// CredentialStoreDirectory is the credential store directory name
	CredentialStoreDirectory = "credentials"
	// InstallationStoreDirectory is the installations store directory name
	InstallationStoreDirectory = "installations"
)

Functions

func ComputeDigest

func ComputeDigest(bundle io.WriterTo) (digest.Digest, error)

ComputeDigest takes a bundle and produce a unigue reference.Digested

func StringToNamedRef

func StringToNamedRef(s string) (reference.Named, error)

StringToNamedRef converts a string to a named reference

Types

type ApplicationStore

type ApplicationStore struct {
	// contains filtered or unexported fields
}

ApplicationStore is the main point to access different stores: - Bundle store persists all bundles built or fetched locally - Credential store persists all the credentials, per context basis - Installation store persists all the installations, per context basis

func NewApplicationStore

func NewApplicationStore(configDir string) (*ApplicationStore, error)

NewApplicationStore creates a new application store, nested inside a docker configuration directory. It will create all the directory hierarchy if anything is missing.

func (ApplicationStore) BundleStore

func (a ApplicationStore) BundleStore() (BundleStore, error)

BundleStore initializes and returns a bundle store

func (ApplicationStore) CredentialStore

func (a ApplicationStore) CredentialStore(context string) (CredentialStore, error)

CredentialStore initializes and returns a context based credential store

func (ApplicationStore) InstallationStore

func (a ApplicationStore) InstallationStore(context string) (InstallationStore, error)

InstallationStore initializes and returns a context based installation store

type BundleStore

type BundleStore interface {
	// Store do store the bundle with optional reference, and return it's unique ID
	Store(ref reference.Reference, bndl *relocated.Bundle) (reference.Digested, error)
	Read(ref reference.Reference) (*relocated.Bundle, error)
	List() ([]reference.Reference, error)
	Remove(ref reference.Reference) error
	LookUp(refOrID string) (reference.Reference, error)
}

func NewBundleStore

func NewBundleStore(path string) (BundleStore, error)

NewBundleStore creates a new bundle store with the given path and initializes it

type CredentialStore

type CredentialStore interface {
	Store(creds *credentials.CredentialSet) error
	Read(credentialSetName string) (*credentials.CredentialSet, error)
}

CredentialStore persists credential sets to a specific path.

type ID

type ID struct {
	// contains filtered or unexported fields
}

ID is an unique identifier for docker app image bundle, implementing reference.Reference

func FromBundle

func FromBundle(bndl *relocated.Bundle) (ID, error)

func FromString

func FromString(s string) (ID, error)

func (ID) Digest

func (id ID) Digest() digest.Digest

func (ID) String

func (id ID) String() string

type Installation

type Installation struct {
	claim.Claim
	RelocationMap relocation.ImageRelocationMap
	Reference     string `json:"reference,omitempty"`
}

Installation is a CNAB claim with an information of where the bundle comes from. It persists the result of an installation and its parameters and context.

func NewInstallation

func NewInstallation(name string, reference string, bndl *relocated.Bundle) (*Installation, error)

func (Installation) SetParameter

func (i Installation) SetParameter(name string, value string)

SetParameter sets the parameter value if the installation bundle has a defined parameter with that name.

type InstallationStore

type InstallationStore interface {
	List() ([]string, error)
	Store(installation *Installation) error
	Read(installationName string) (*Installation, error)
	Delete(installationName string) error
}

InstallationStore is an interface to persist, delete, list and read installations.

type UnknownReferenceError

type UnknownReferenceError struct {
	// contains filtered or unexported fields
}

UnknownReferenceError represents a reference not found in the bundle store

func (*UnknownReferenceError) Error

func (e *UnknownReferenceError) Error() string

func (*UnknownReferenceError) NotFound

func (e *UnknownReferenceError) NotFound()

NotFound satisfies interface github.com/docker/docker/errdefs.ErrNotFound