aci

Documentation

Overview

Package aci implements helper functions for working with ACIs

Index

• func NewACI(dir string, manifest string, entries []*ACIEntry) (*os.File, error)
• func NewBasicACI(dir string, name string) (*os.File, error)
• func NewDetachedSignature(armoredPrivateKey string, aci io.Reader) (io.Reader, error)
• func NewImageWriter(am schema.ImageManifest, w *tar.Writer) aci.ArchiveWriter
• func RenderACI(name types.ACName, labels types.Labels, dir string, ap acirenderer.ACIRegistry) error
• func RenderACIFromList(imgs acirenderer.Images, dir string, ap acirenderer.ACIProvider) error
• func RenderACIWithImageID(imageID types.Hash, dir string, ap acirenderer.ACIRegistry) error
• type ACIEntry

Functions

func NewACI

func NewACI(dir string, manifest string, entries []*ACIEntry) (*os.File, error)

NewACI creates a new ACI in the given directory with the given image manifest and entries. Used for testing.

func NewBasicACI

func NewBasicACI(dir string, name string) (*os.File, error)

NewBasicACI creates a new ACI in the given directory with the given name. Used for testing.

func NewDetachedSignature

func NewDetachedSignature(armoredPrivateKey string, aci io.Reader) (io.Reader, error)

NewDetachedSignature creates a new openpgp armored detached signature for the given ACI signed with armoredPrivateKey.

func NewImageWriter

func NewImageWriter(am schema.ImageManifest, w *tar.Writer) aci.ArchiveWriter

NewImageWriter creates a new ArchiveWriter which will generate an App Container Image based on the given manifest and write it to the given tar.Writer TODO(sgotti) this is a copy of appc/spec/aci.imageArchiveWriter with addFileNow changed to create the file with the current user. needed for testing as non root user.

func RenderACI

func RenderACI(name types.ACName, labels types.Labels, dir string, ap acirenderer.ACIRegistry) error

Given an image app name and optional labels, get the best matching image available in the store, build its dependency list and render it inside dir

func RenderACIFromList

func RenderACIFromList(imgs acirenderer.Images, dir string, ap acirenderer.ACIProvider) error

Given an already populated dependency list, it will extract, under the provided directory, the rendered ACI

func RenderACIWithImageID

func RenderACIWithImageID(imageID types.Hash, dir string, ap acirenderer.ACIRegistry) error

Given an imageID, start with the matching image available in the store, build its dependency list and render it inside dir

Types

type ACIEntry

type ACIEntry struct {
	Header   *tar.Header
	Contents string
}