Documentation
¶
Index ¶
- func AssertDeletedStorageFiles(deleted, expected *RegistryStorageFiles) error
- func BuildAndPushChildImage(oc *exutil.CLI, dClient *dockerclient.Client, parent string, name, tag string, ...) (string, string, error)
- func BuildAndPushImageOfSizeWithBuilder(oc *exutil.CLI, dClient *dockerclient.Client, namespace, name, tag string, ...) error
- func BuildAndPushImageOfSizeWithDocker(oc *exutil.CLI, dClient *dockerclient.Client, name, tag string, size uint64, ...) (string, string, error)
- func GetImageLabels(c imagetypedclientset.ImageStreamImageInterface, ...) (map[string]string, error)
- func IsBlobStoredInRegistry(oc *exutil.CLI, dgst digest.Digest, repository string) (bool, bool, error)
- func IsEmptyDigest(dgst digest.Digest) bool
- func MirrorBlobInRegistry(oc *exutil.CLI, dgst digest.Digest, repository string, timeout time.Duration) error
- type CleanUpContainer
- type RegistryStorageFiles
- type RepoLinks
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AssertDeletedStorageFiles ¶ added in v1.5.2
func AssertDeletedStorageFiles(deleted, expected *RegistryStorageFiles) error
AssertDeletedStorageFiles compares lists of deleted files against expected. An error will be generated for each entry present in just one of these sets.
func BuildAndPushChildImage ¶ added in v1.5.2
func BuildAndPushChildImage( oc *exutil.CLI, dClient *dockerclient.Client, parent string, name, tag string, numberOfNewLayers int, outSink io.Writer, removeBuiltImage bool, ) (string, string, error)
BuildAndPushChildImage tries to build and push an image of given name and number of layers. It instructs Docker daemon directly. Built image is stored as an image stream tag <name>:<tag>. Returned is an image digest, its ID (docker daemon's internal representation) and an error if any.
func BuildAndPushImageOfSizeWithBuilder ¶ added in v1.3.0
func BuildAndPushImageOfSizeWithBuilder( oc *exutil.CLI, dClient *dockerclient.Client, namespace, name, tag string, size uint64, numberOfLayers int, shouldSucceed bool, ) error
BuildAndPushImageOfSizeWithBuilder tries to build an image of wanted size and number of layers. Built image is stored as an image stream tag <name>:<tag>. If shouldSucceed is false, a build is expected to fail with a denied error. Note the size is only approximate. Resulting image size will be different depending on used compression algorithm and metadata overhead.
func BuildAndPushImageOfSizeWithDocker ¶ added in v1.3.0
func BuildAndPushImageOfSizeWithDocker( oc *exutil.CLI, dClient *dockerclient.Client, name, tag string, size uint64, numberOfLayers int, outSink io.Writer, shouldSucceed bool, removeBuiltImage bool, ) (string, string, error)
BuildAndPushImageOfSizeWithDocker tries to build an image of wanted size and number of layers. It instructs Docker daemon directly. Built image is stored as an image stream tag <name>:<tag>. If shouldSucceed is false, a push is expected to fail with a denied error. Note the size is only approximate. Resulting image size will be different depending on used compression algorithm and metadata overhead. Returned is an image digest, its ID (docker daemon's internal representation) and an error if any.
func GetImageLabels ¶
func GetImageLabels(c imagetypedclientset.ImageStreamImageInterface, imageRepoName, imageRef string) (map[string]string, error)
GetImageLabels retrieves Docker labels from image from image repository name and image reference
func IsBlobStoredInRegistry ¶ added in v1.5.2
func IsBlobStoredInRegistry( oc *exutil.CLI, dgst digest.Digest, repository string, ) (bool, bool, error)
IsBlobStoredInRegistry verifies a presence of the given blob on registry's storage. The registry must be deployed with a filesystem storage driver. If repository is given, the presence will be verified also for layer link inside the ${repository}/_layers directory. First returned bool says whether the blob is present globally in the registry's storage. The second says whether the blob is linked in the given repository.
func IsEmptyDigest ¶ added in v1.5.2
IsEmptyDigest returns true if the given digest matches one of empty blobs.
func MirrorBlobInRegistry ¶ added in v1.5.2
func MirrorBlobInRegistry(oc *exutil.CLI, dgst digest.Digest, repository string, timeout time.Duration) error
MirrorBlobInRegistry forces a blob of external image to be mirrored in the registry. The function expects the blob not to exist before a GET request is issued. The function blocks until the blob is mirrored or the given timeout passes.
Types ¶
type CleanUpContainer ¶ added in v1.5.2
CleanUpContainer holds names of image names, docker image IDs, imagestreamtags and imagestreams that shall be deleted at the end of the test.
func NewCleanUpContainer ¶ added in v1.5.2
func NewCleanUpContainer(oc *exutil.CLI) *CleanUpContainer
NewCleanUpContainer creates a new instance of CleanUpContainer.
func (*CleanUpContainer) AddImage ¶ added in v1.5.2
func (c *CleanUpContainer) AddImage(name, id, isTag string)
AddImage marks given image name, docker image id and imagestreamtag as candidates for deletion.
func (*CleanUpContainer) AddImageStream ¶ added in v1.5.2
func (c *CleanUpContainer) AddImageStream(isName string)
AddImageStream marks the given image stream name for removal.
func (*CleanUpContainer) Run ¶ added in v1.5.2
func (c *CleanUpContainer) Run()
Run deletes all the marked objects.
type RegistryStorageFiles ¶ added in v1.5.2
type RegistryStorageFiles struct {
Repos []string
ManifestLinks RepoLinks
LayerLinks RepoLinks
Blobs []string
}
func RunHardPrune ¶ added in v1.5.2
func RunHardPrune(oc *exutil.CLI, dryRun bool) (*RegistryStorageFiles, error)
RunHardPrune executes into a docker-registry pod and runs a garbage collector. The docker-registry is assumed to be in a read-only mode and using filesystem as a storage driver. It returns lists of deleted files.
func (*RegistryStorageFiles) Len ¶ added in v1.5.2
func (sfs *RegistryStorageFiles) Len() int
Len returns a number of files contained in the sfs container.
func (*RegistryStorageFiles) ToPaths ¶ added in v1.5.2
func (sfs *RegistryStorageFiles) ToPaths(root string) []string
ToPaths returns a list of paths of files contained in _sfs_ corresponding to their location in registry pod's storage under _root_ directory.
Source Files