container

Documentation

Index

• Constants
• Variables
• func ContainerManagerLogin(imageTag string, config *ContainerManagerLoginConfig, ...) error
• func GetImageTagWithDigest(filePath string) (tag string, sha256 string, err error)
• func IsCompatibleApiVersion(dockerOutput string) bool
• func NewLocalAgentBuildInfoBuilder(image *Image, repository, buildName, buildNumber, project string, ...) (*localAgentbuildInfoBuilder, error)
• func NewRemoteAgentBuildInfoBuilder(image *Image, repository, buildName, buildNumber, project string, ...) (*remoteAgentbuildInfoBuilder, error)
• func ResolveRegistryFromTag(imageTag string) (string, error)
• func ValidateClientApiVersion() error
• type Builder
• type CommandType
• type ContainerManager
  • func NewManager(containerManagerType ContainerManagerType) ContainerManager
• type ContainerManagerLoginConfig
• type ContainerManagerType
  • func (cmt ContainerManagerType) String() string
• type FatManifest
• type Image
  • func NewImage(tag string) *Image
  • func (image *Image) GetImageBaseName() (string, error)
  • func (image *Image) GetImageBaseNameWithTag() (string, error)
  • func (image *Image) GetPath() (string, error)
  • func (image *Image) Name() string
• type LoginCmd
  • func (loginCmd *LoginCmd) GetCmd() *exec.Cmd
  • func (loginCmd *LoginCmd) RunCmd() error
• type ManifestDetails
• type Platform
• type RepositoryDetails
• type VersionCmd
  • func (versionCmd *VersionCmd) GetCmd() *exec.Cmd
  • func (versionCmd *VersionCmd) RunCmd() (string, error)

Constants

const LoginFailureMessage string = "%s login failed for: %s.\n %s image must be in the form: registry-domain/path-in-repository/image-name:version."

Docker login error message

const MinSupportedApiVersion string = "1.31"

Docker API version 1.31 is compatible with Docker version 17.07.0, according to https://docs.docker.com/engine/api/#api-version-matrix

Variables

var ApiVersionRegex = regexp.MustCompile(`^(\d+)\.(\d+)$`)

Search for docker API version format pattern e.g. 1.40

Functions

func ContainerManagerLogin

func ContainerManagerLogin(imageTag string, config *ContainerManagerLoginConfig, containerManager ContainerManagerType) error

First we'll try to login assuming a proxy-less tag (e.g. "registry-address/docker-repo/image:ver"). If fails, we will try assuming a reverse proxy tag (e.g. "registry-address-docker-repo/image:ver").

func GetImageTagWithDigest

func GetImageTagWithDigest(filePath string) (tag string, sha256 string, err error)

Read the file which contains the following format: 'IMAGE-TAG-IN-ARTIFACTORY'@sha256'SHA256-OF-THE-IMAGE-MANIFEST'.

func IsCompatibleApiVersion

func IsCompatibleApiVersion(dockerOutput string) bool

func NewLocalAgentBuildInfoBuilder

func NewLocalAgentBuildInfoBuilder(image *Image, repository, buildName, buildNumber, project string, serviceManager artifactory.ArtifactoryServicesManager, commandType CommandType, containerManager ContainerManager) (*localAgentbuildInfoBuilder, error)

Create new build info builder container CLI tool

func NewRemoteAgentBuildInfoBuilder

func NewRemoteAgentBuildInfoBuilder(image *Image, repository, buildName, buildNumber, project string, serviceManager artifactory.ArtifactoryServicesManager, manifestSha256 string) (*remoteAgentbuildInfoBuilder, error)

func ResolveRegistryFromTag

func ResolveRegistryFromTag(imageTag string) (string, error)

Get registry from tag

func ValidateClientApiVersion

func ValidateClientApiVersion() error

Types

type Builder

type Builder interface {
	Build(module string) (*buildinfo.BuildInfo, error)
	UpdateArtifactsAndDependencies() error
	GetLayers() *[]utils.ResultItem
}

Docker image build info builder.

type CommandType

type CommandType string

const (
	Pull CommandType = "pull"
	Push CommandType = "push"
)

type ContainerManager

type ContainerManager interface {
	Push(image *Image) error
	// Image ID is basically the image's SHA256
	Id(image *Image) (string, error)
	OsCompatibility(image *Image) (string, string, error)
	Pull(image *Image) error
	GetContainerManagerType() ContainerManagerType
}

Container image

func NewManager

func NewManager(containerManagerType ContainerManagerType) ContainerManager

type ContainerManagerLoginConfig

type ContainerManagerLoginConfig struct {
	ServerDetails *config.ServerDetails
}

type ContainerManagerType

type ContainerManagerType int

const (
	DockerClient ContainerManagerType = iota
	Podman
)

func (ContainerManagerType) String

func (cmt ContainerManagerType) String() string

type FatManifest

type FatManifest struct {
	Manifests []ManifestDetails `json:"manifests"`
}

type Image

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

func NewImage

func NewImage(tag string) *Image

func (*Image) GetImageBaseName

func (image *Image) GetImageBaseName() (string, error)

Get image base name by removing the prefixed registry hostname and the tag. e.g.: https://my-registry/docker-local/hello-world:latest. -> hello-world

func (*Image) GetImageBaseNameWithTag

func (image *Image) GetImageBaseNameWithTag() (string, error)

Get image name from tag by removing the prefixed registry hostname.

func (*Image) GetPath

func (image *Image) GetPath() (string, error)

Get image relative path in Artifactory.

func (*Image) Name

func (image *Image) Name() string

Get image name

type LoginCmd

type LoginCmd struct {
	DockerRegistry string
	Username       string
	Password       string
	// contains filtered or unexported fields
}

Login command

func (*LoginCmd) GetCmd

func (loginCmd *LoginCmd) GetCmd() *exec.Cmd

func (*LoginCmd) RunCmd

func (loginCmd *LoginCmd) RunCmd() error

type ManifestDetails

type ManifestDetails struct {
	Digest   string   `json:"digest"`
	Platform Platform `json:"platform"`
}

type Platform

type Platform struct {
	Architecture string `json:"architecture"`
	Os           string `json:"os"`
}

type RepositoryDetails

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

type VersionCmd

type VersionCmd struct{}

Version command Docker-client provides an API for interacting with the Docker daemon. This cmd should be used for docker client only.

func (*VersionCmd) GetCmd

func (versionCmd *VersionCmd) GetCmd() *exec.Cmd

func (*VersionCmd) RunCmd

func (versionCmd *VersionCmd) RunCmd() (string, error)