docker

Documentation

Index

• func ContainerImageNameFromImage(fullImage string) (string, error)
• func ContainerImageNameTagFromImage(fullImage string) (string, error)
• func ContainerRegistryFromImage(fullImage string) (string, error)
• func ContainerRegistryFromURL(registryURL string) (string, error)
• func CreateDockerConfigJSON(registryURL, username, password, targetPath, configPath string, ...) (string, error)
• func ImageListWithFilePath(imageName string, excludes []string, trimDir string, ...) (map[string]string, error)
• func IsBinfmtMiscSupportedByHost(utils piperutils.FileUtils) (bool, error)
• func MergeDockerConfigJSON(sourcePath, targetPath string, utils piperutils.FileUtils) error
• type AuthEntry
• type Client
  • func (c *Client) DownloadImage(imageSource, targetFile string) (v1.Image, error)
  • func (c *Client) DownloadImageContent(imageSource, targetDir string) (v1.Image, error)
  • func (c *Client) GetRemoteImageInfo(imageSource string) (v1.Image, error)
  • func (c *Client) SetOptions(options ClientOptions)
• type ClientOptions
• type CraneUtilsBundle
  • func (c *CraneUtilsBundle) CopyImage(ctx context.Context, src, dest, platform string) error
  • func (c *CraneUtilsBundle) LoadImage(ctx context.Context, src string) (v1.Image, error)
  • func (c *CraneUtilsBundle) PushImage(ctx context.Context, im v1.Image, dest, platform string) error
• type Download

Functions

func ContainerImageNameFromImage

func ContainerImageNameFromImage(fullImage string) (string, error)

ContainerImageNameFromImage returns the image name of a given docker reference

func ContainerImageNameTagFromImage

func ContainerImageNameTagFromImage(fullImage string) (string, error)

ContainerImageNameTagFromImage provides the name & tag part of a full image name

func ContainerRegistryFromImage

func ContainerRegistryFromImage(fullImage string) (string, error)

ContainerRegistryFromImage provides the registry part of a full image name

func ContainerRegistryFromURL

func ContainerRegistryFromURL(registryURL string) (string, error)

ContainerRegistryFromURL provides the registry part of a complete registry url including the port

func CreateDockerConfigJSON

func CreateDockerConfigJSON(registryURL, username, password, targetPath, configPath string, utils piperutils.FileUtils) (string, error)

CreateDockerConfigJSON creates / updates a Docker config.json with registry credentials

func ImageListWithFilePath

func ImageListWithFilePath(imageName string, excludes []string, trimDir string, utils piperutils.FileUtils) (map[string]string, error)

ImageListWithFilePath compiles container image names based on all Dockerfiles found, considering excludes according to following search pattern: **/Dockerfile* Return value contains a map with image names and file path Examples for image names with imageName testImage * Dockerfile: `imageName` * sub1/Dockerfile: `imageName-sub1` * sub2/Dockerfile_proxy: `imageName-sub2-proxy`

func IsBinfmtMiscSupportedByHost

func IsBinfmtMiscSupportedByHost(utils piperutils.FileUtils) (bool, error)

IsBinfmtMiscSupportedByHost checks if the hosts kernel does support binfmt_misc

func MergeDockerConfigJSON

func MergeDockerConfigJSON(sourcePath, targetPath string, utils piperutils.FileUtils) error

MergeDockerConfigJSON merges two docker config.json files.

Types

type AuthEntry

type AuthEntry struct {
	Auth string `json:"auth,omitempty"`
}

AuthEntry defines base64 encoded username:password required inside a Docker config.json

type Client

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

Client defines an docker client object

func (*Client) DownloadImage

func (c *Client) DownloadImage(imageSource, targetFile string) (v1.Image, error)

DownloadImage downloads the image and saves it as tar at the given path

func (*Client) DownloadImageContent

func (c *Client) DownloadImageContent(imageSource, targetDir string) (v1.Image, error)

DownloadImageContent downloads the image content into the given targetDir. Returns with an error if the targetDir doesnt exist

func (*Client) GetRemoteImageInfo

func (c *Client) GetRemoteImageInfo(imageSource string) (v1.Image, error)

GetRemoteImageInfo retrieves information about the image (e.g. digest) without actually downoading it

func (*Client) SetOptions

func (c *Client) SetOptions(options ClientOptions)

SetOptions sets options used for the docker client

type ClientOptions

type ClientOptions struct {
	ImageName   string
	RegistryURL string
	LocalPath   string
	ImageFormat string
}

ClientOptions defines the options to be set on the client

type CraneUtilsBundle

type CraneUtilsBundle struct{}

func (*CraneUtilsBundle) CopyImage

func (c *CraneUtilsBundle) CopyImage(ctx context.Context, src, dest, platform string) error

func (*CraneUtilsBundle) LoadImage

func (c *CraneUtilsBundle) LoadImage(ctx context.Context, src string) (v1.Image, error)

func (*CraneUtilsBundle) PushImage

func (c *CraneUtilsBundle) PushImage(ctx context.Context, im v1.Image, dest, platform string) error

type Download

type Download interface {
	DownloadImage(imageSource, targetFile string) (v1.Image, error)
	DownloadImageContent(imageSource, targetDir string) (v1.Image, error)
	GetRemoteImageInfo(string) (v1.Image, error)
}

Download interface for download an image to a local path