pkg

func ExtraIdentityKey ¶

func ExtraIdentityKey(name string) string

ExtraIdentityKey creates a new identity key for a name and append the image vector prefix.

func ImageEntryIsComponentReference ¶

func ImageEntryIsComponentReference(image ImageEntry, opts *ParseImageOptions) bool

ImageEntryIsComponentReference checks if the image entry should be parsed as component reference

func ImageEntryIsGenericDependency ¶

func ImageEntryIsGenericDependency(image ImageEntry, opts *ParseImageOptions) bool

ImageEntryIsGenericDependency checks if the image entry should be parsed as generic dependency

func Label ¶

func Label(name string) string

Label creates a new label for a name and append the image vector prefix.

func ParseImageRef ¶

func ParseImageRef(ref string) (repository, version string, err error)

ParseImageRef parses a valid image ref into its repository and version

func ParseImageVector ¶

func ParseImageVector(ctx context.Context,
	compResolver ctf.ComponentResolver,
	cd *cdv2.ComponentDescriptor,
	reader io.Reader,
	opts *ParseImageOptions) error

ParseImageVector parses a image vector and generates the corresponding component descriptor resources. It is expected that the image vector yaml is passed as io.Reader.

There are 4 different scenarios how images are added to the component descriptor. 1. The image is defined with a tag and will be directly translated as oci image resource.

<pre> images:

• name: pause-container sourceRepository: github.com/kubernetes/kubernetes/blob/master/build/pause/Dockerfile repository: gcr.io/google_containers/pause-amd64 tag: "3.1"

</pre>

<pre> meta:

schemaVersion: 'v2'

... resources:

• name: pause-container version: "3.1" type: ociImage extraIdentity: "imagevector-gardener-cloud+tag": "3.1" labels:
• name: imagevector.gardener.cloud/name value: pause-container
• name: imagevector.gardener.cloud/repository value: gcr.io/google_containers/pause-amd64
• name: imagevector.gardener.cloud/source-repository value: github.com/kubernetes/kubernetes/blob/master/build/pause/Dockerfile access: type: ociRegistry imageReference: gcr.io/google_containers/pause-amd64:3.1

</pre>

2. The image is defined by another component so the image is added as label ("imagevector.gardener.cloud/images") to the "componentReference".

Images that are defined by other components can be specified 1. when the image's repository matches the given "--component-prefixes" 2. the image is labeled with "imagevector.gardener.cloud/component-reference"

If the component reference is not yet defined it will be automatically added. If multiple images are defined for the same component reference they are added to the images list in the label.

<pre> images:

• name: cluster-autoscaler sourceRepository: github.com/gardener/autoscaler repository: eu.gcr.io/gardener-project/gardener/autoscaler/cluster-autoscaler targetVersion: "< 1.16" tag: "v0.10.0" labels: # recommended bbut only needed when "--component-prefixes" is not defined
• name: imagevector.gardener.cloud/component-reference value: name: cla # defaults to image.name componentName: github.com/gardener/autoscaler # defaults to image.sourceRepository version: v0.10.0 # defaults to image.version

</pre>

<pre> meta:

schemaVersion: 'v2'

... componentReferences:

• name: cla componentName: github.com/gardener/autoscaler version: v0.10.0 extraIdentity: imagevector-gardener-cloud+tag: v0.10.0 labels:
• name: imagevector.gardener.cloud/images value: images:
• name: cluster-autoscaler repository: eu.gcr.io/gardener-project/gardener/autoscaler/cluster-autoscaler sourceRepository: github.com/gardener/autoscaler tag: v0.10.0 targetVersion: '< 1.16' </pre>

3. The image is a generic dependency where the actual images are defined by the overwrite. A generic dependency image is not part of a component descriptor's resource but will be added as label ("imagevector.gardener.cloud/images") to the component descriptor.

Generic dependencies can be defined by 1. defined as "--generic-dependency=<image name>" 2. the label "imagevector.gardener.cloud/generic"

<pre> images:

• name: hyperkube sourceRepository: github.com/kubernetes/kubernetes repository: k8s.gcr.io/hyperkube targetVersion: "< 1.19" labels: # only needed if "--generic-dependency" is not set
• name: imagevector.gardener.cloud/generic

</pre>

<pre> meta:

schemaVersion: 'v2'

component:

  labels:
  - name: imagevector.gardener.cloud/images
    value:
    images:
	 - name: hyperkube
	   repository: k8s.gcr.io/hyperkube
	   sourceRepository: github.com/kubernetes/kubernetes
	   targetVersion: '< 1.19'
 </pre>

4. The image has not tag and it's repository matches a already defined resource in the component descriptor. This usually means that the image is build as part of the build pipeline and the version depends on the current component. In this case only labels are added to the existing resource

<pre> images:

• name: gardenlet sourceRepository: github.com/gardener/gardener repository: eu.gcr.io/gardener-project/gardener/gardenlet

</pre>

<pre> meta:

schemaVersion: 'v2'

... resources:

• name: gardenlet version: "v0.0.0" type: ociImage relation: local labels:
• name: imagevector.gardener.cloud/name value: gardenlet
• name: imagevector.gardener.cloud/repository value: eu.gcr.io/gardener-project/gardener/gardenlet
• name: imagevector.gardener.cloud/source-repository value: github.com/gardener/gardener access: type: ociRegistry imageReference: eu.gcr.io/gardener-project/gardener/gardenlet:v0.0.0

</pre>

func TagIsDigest ¶

func TagIsDigest(tag string) bool

TagIsDigest validates of a tag is a valid digest.