image

Documentation

Index

• Constants
• func ExtractRepoDigest(inspectRepoDigests []string, repository string) string
• func Init() error
• func MustParseTimestampString(timestampString string) time.Time
• func NormalizeRepository(repository string) (res string)
• func ParseCreationTs(creationTs string) (int64, error)
• func ParseRepositoryAndTag(ref string) (string, string)
• type Container
  • func (container Container) LogName() string
• type ContainerFilter
• type ContainerList
• type CustomTagFunc
• type ExportTagFunc
• type ImagesList
  • func (list ImagesList) ConvertToStages() ([]StageID, error)
• type Info
  • func (info *Info) GetCopy() *Info
  • func (info *Info) GetCreatedAt() time.Time
  • func (info *Info) GetDigest() string
  • func (info *Info) LogName() string
  • func (info *Info) SetCreatedAtUnix(seconds int64)
  • func (info *Info) SetCreatedAtUnixNano(seconds int64)
• type InfoGetter
  • func NewInfoGetter(imageName, ref string, opts InfoGetterOptions) *InfoGetter
  • func (d *InfoGetter) GetName() string
  • func (d *InfoGetter) GetTag() string
  • func (d *InfoGetter) GetWerfImageName() string
  • func (d *InfoGetter) IsNameless() bool
• type InfoGetterOptions
• type ManifestCache
  • func NewManifestCache(cacheDir string) *ManifestCache
  • func (cache *ManifestCache) GetImageInfo(ctx context.Context, storageName, imageName string) (*Info, error)
  • func (cache *ManifestCache) StoreImageInfo(ctx context.Context, storageName string, imgInfo *Info) error
• type ManifestCacheRecord
• type StageDescription
  • func (desc *StageDescription) GetCopy() *StageDescription
• type StageID
  • func NewStageID(digest string, creationTs int64) *StageID
  • func (id StageID) CreationTsToTime() time.Time
  • func (id StageID) IsEqual(another StageID) bool
  • func (id StageID) String() string
• type Summary

Constants

const (
	WerfLabelPrefix               = "werf"
	WerfLabel                     = "werf"
	WerfVersionLabel              = "werf-version"
	WerfCacheVersionLabel         = "werf-cache-version"
	WerfImageLabel                = "werf-image"
	WerfDevLabel                  = "werf-dev"
	WerfDockerImageName           = "werf-docker-image-name"
	WerfStageDigestLabel          = "werf-stage-digest"
	WerfStageContentDigestLabel   = "werf-stage-content-digest"
	WerfProjectRepoCommitLabel    = "werf-project-repo-commit"
	WerfImportChecksumLabelPrefix = "werf-import-checksum-"
	WerfBaseImageIDLabel          = "werf.io/base-image-id"

	WerfImportMetadataChecksumLabel       = "checksum"
	WerfImportMetadataSourceImageIDLabel  = "source-image-id"
	WerfImportMetadataImportSourceIDLabel = "import-source-id"

	WerfCustomTagMetadataStageIDLabel = "stage-id"
	WerfCustomTagMetadataTag          = "tag"

	WerfMountTmpDirLabel          = "werf-mount-type-tmp-dir"
	WerfMountBuildDirLabel        = "werf-mount-type-build-dir"
	WerfMountCustomDirLabelPrefix = "werf-mount-type-custom-dir-"

	BuildCacheVersion = "1.2"

	StageContainerNamePrefix = "werf.build."
)

const (
	DockerHubRepositoryPrefix      = "docker.io/library/"
	IndexDockerHubRepositoryPrefix = "index.docker.io/library/"
)

const (
	ManifestCacheVersion = "5"
)

Functions

func ExtractRepoDigest

func ExtractRepoDigest(inspectRepoDigests []string, repository string) string

ExtractRepoDigest return repo@digest from the list.

func Init

func Init() error

func MustParseTimestampString

func MustParseTimestampString(timestampString string) time.Time

func NormalizeRepository

func NormalizeRepository(repository string) (res string)

func ParseCreationTs

func ParseCreationTs(creationTs string) (int64, error)

func ParseRepositoryAndTag

func ParseRepositoryAndTag(ref string) (string, string)

Types

type Container

type Container struct {
	ID      string
	ImageID string
	Names   []string
}

func (Container) LogName

func (container Container) LogName() string

type ContainerFilter

type ContainerFilter struct {
	ID       string
	Name     string
	Ancestor string
}

type ContainerList

type ContainerList []Container

type CustomTagFunc

type CustomTagFunc func(string, string) string

type ExportTagFunc

type ExportTagFunc func(string, string) string

type ImagesList

type ImagesList []Summary

func (ImagesList) ConvertToStages

func (list ImagesList) ConvertToStages() ([]StageID, error)

FIXME(multiarch): take into account multiarch stages, which does not use creationTs

type Info

type Info struct {
	Name       string `json:"name"`
	Repository string `json:"repository"`
	Tag        string `json:"tag"`

	// FIXME remove RepoDigest from Info and use Digest everywhere instead cause it's more clear and repo part is not needed.
	// repo@sha256:digest
	RepoDigest string `json:"repoDigest"`

	OnBuild           []string          `json:"onBuild"`
	Env               []string          `json:"env"`
	ID                string            `json:"ID"`
	ParentID          string            `json:"parentID"`
	Labels            map[string]string `json:"labels"`
	Size              int64             `json:"size"`
	CreatedAtUnixNano int64             `json:"createdAtUnixNano"`

	IsIndex bool
	Index   []*Info
}

func (*Info) GetCopy

func (info *Info) GetCopy() *Info

func (*Info) GetCreatedAt

func (info *Info) GetCreatedAt() time.Time

func (*Info) GetDigest

func (info *Info) GetDigest() string

func (*Info) LogName

func (info *Info) LogName() string

func (*Info) SetCreatedAtUnix

func (info *Info) SetCreatedAtUnix(seconds int64)

func (*Info) SetCreatedAtUnixNano

func (info *Info) SetCreatedAtUnixNano(seconds int64)

type InfoGetter

type InfoGetter struct {
	WerfImageName string
	Repo          string
	Tag           string

	InfoGetterOptions
}

func NewInfoGetter

func NewInfoGetter(imageName, ref string, opts InfoGetterOptions) *InfoGetter

func (*InfoGetter) GetName

func (d *InfoGetter) GetName() string

func (*InfoGetter) GetTag

func (d *InfoGetter) GetTag() string

func (*InfoGetter) GetWerfImageName

func (d *InfoGetter) GetWerfImageName() string

func (*InfoGetter) IsNameless

func (d *InfoGetter) IsNameless() bool

type InfoGetterOptions

type InfoGetterOptions struct {
	CustomTagFunc CustomTagFunc
}

type ManifestCache

type ManifestCache struct {
	CacheDir string
}

var CommonManifestCache *ManifestCache

func NewManifestCache

func NewManifestCache(cacheDir string) *ManifestCache

func (*ManifestCache) GetImageInfo

func (cache *ManifestCache) GetImageInfo(ctx context.Context, storageName, imageName string) (*Info, error)

func (*ManifestCache) StoreImageInfo

func (cache *ManifestCache) StoreImageInfo(ctx context.Context, storageName string, imgInfo *Info) error

type ManifestCacheRecord

type ManifestCacheRecord struct {
	AccessTimestamp int64
	Info            *Info
}

type StageDescription

type StageDescription struct {
	StageID *StageID `json:"stageID"`
	Info    *Info    `json:"info"`
}

func (*StageDescription) GetCopy

func (desc *StageDescription) GetCopy() *StageDescription

type StageID

type StageID struct {
	Digest string `json:"digest"`

	// FIXME: rename to CreationTs / update cacheVersion
	CreationTs      int64 `json:"uniqueID"`
	IsMultiplatform bool  `json:"isMultiplatform"`
}

func NewStageID

func NewStageID(digest string, creationTs int64) *StageID

func (StageID) CreationTsToTime

func (id StageID) CreationTsToTime() time.Time

func (StageID) IsEqual

func (id StageID) IsEqual(another StageID) bool

func (StageID) String

func (id StageID) String() string

type Summary

type Summary struct {
	RepoTags    []string
	RepoDigests []string
}