RSPImage#

class nublado.controller.models.domain.rspimage.RSPImage(*, tag, image_type, display_name, base=None, version=None, cycle=None, cycle_build=None, rsp_build=None, architecture=None, extra=None, date=None, registry, repository, digest, size=None, aliases=<factory>, alias_target=None, nodes=<factory>)#

Bases: RSPImageTag

A tagged Rubin Science Platform image.

An RSPImage differs from a RSPImageTag by having a reference and digest, potentially additional alias tags, and possibly information discovered from a Kubernetes cluster, such as the image size and the list of nodes on which it is present.

Parameters:

tag (str)
image_type (RSPImageType)
display_name (str)
base (Optional[str], default: None)
version (Optional[Version], default: None)
cycle (Optional[int], default: None)
cycle_build (Optional[int], default: None)
rsp_build (Optional[int], default: None)
architecture (Optional[str], default: None)
extra (Optional[str], default: None)
date (Optional[datetime], default: None)
registry (str)
repository (str)
digest (str)
size (Optional[int], default: None)
aliases (set[str], default: <factory>)
alias_target (Optional[str], default: None)
nodes (set[str], default: <factory>)

Attributes Summary

`alias_target`	The tag of the image for which this is an alias, if known.
`aliases`	Known aliases for this image.
`architecture`	Architecture of image, if specified.
`base`	Base tag name for unknown and alias tags.
`cycle`	XML schema version implemented by this image (only for T&S builds).
`cycle_build`	XML schema build number (only for T&S builds).
`date`	When the image was created, or as close as we can get to that.
`digest`	Image digest for the image, including prefixes like `sha256:`.
`display_name`	Human-readable display name.
`extra`	Additional information about the image.
`image_type`	Type (release series) of image identified by this tag.
`is_possible_alias`	Whether this tag could be an alias.
`nodes`	Names of nodes on which this image is present.
`reference`	Docker reference for this image.
`reference_with_digest`	Docker reference for this image, with the digest.
`registry`	Docker registry from which this image comes.
`repository`	Docker repository from which this image comes.
`rsp_build`	Version number of the RSP build machinery.
`size`	Size of the image in bytes if known.
`tag`	The tag itself, unmodified.
`version`	Version information as a semantic version.

Methods Summary

`from_tag`(tag, *, registry, repository, digest)	Construct an image from an existing tag.
`resolve_alias`(target)	Resolve an alias tag with information about its target.

Attributes Documentation

alias_target: Optional[str] = None#: The tag of the image for which this is an alias, if known.

aliases: set[str] = <dataclasses._MISSING_TYPE object>#

Known aliases for this image.

This may include other alias tags that all resolve to the same underlying image, other non-alias tags with the same digest, and aliases that are not present in the same collection. It is intended primarily for the use of RSPImageCollection, which contains more sophisticated alias tracking logic that is aware of the contents of the collection.

architecture: str | None = None#: Architecture of image, if specified.

base: str | None = None#: Base tag name for unknown and alias tags.

cycle: int | None = None#: XML schema version implemented by this image (only for T&S builds).

cycle_build: int | None = None#: XML schema build number (only for T&S builds).

date: datetime | None = None#

When the image was created, or as close as we can get to that.

For daily or weekly tags, this can be calculated within a day or week, which is good enough for filtering purposes. Other images are not handled for now, since the upload time is not necessarily when the image was created.

digest: str = <dataclasses._MISSING_TYPE object>#: Image digest for the image, including prefixes like sha256:.

display_name: str = <dataclasses._MISSING_TYPE object>#: Human-readable display name.

extra: str | None = None#: Additional information about the image.

image_type: RSPImageType = <dataclasses._MISSING_TYPE object>#: Type (release series) of image identified by this tag.

is_possible_alias#: Whether this tag could be an alias.

nodes: set[str] = <dataclasses._MISSING_TYPE object>#: Names of nodes on which this image is present.

reference#: Docker reference for this image.

reference_with_digest#: Docker reference for this image, with the digest.

registry: str = <dataclasses._MISSING_TYPE object>#: Docker registry from which this image comes.

repository: str = <dataclasses._MISSING_TYPE object>#: Docker repository from which this image comes.

rsp_build: int | None = None#: Version number of the RSP build machinery.

size: Optional[int] = None#: Size of the image in bytes if known.

tag: str = <dataclasses._MISSING_TYPE object>#: The tag itself, unmodified.

version: Version | None = None#: Version information as a semantic version.

Methods Documentation

classmethod from_tag(tag, *, registry, repository, digest, size=None)#

Construct an image from an existing tag.

Parameters:

tag (RSPImageTag) – Tag for this image.
registry (str) – Docker registry for this image.
repository (str) – Docker repository for this image.
digest (str) – Digest for this image.
size (Optional[int], default: None) – Size of the image, if known.

Returns:

Resulting image object.

Return type:

RSPImage

resolve_alias(target)#

Resolve an alias tag with information about its target.

If we discover the target tag of an alias tag, we can improve the alias tag’s display name and cycle information using the information of the underlying tag. This normally happens when ingesting a set of images, including alias images, into an RSPImageCollection.

If the tag was previously an unknown tag but we found another tag with the same digest, assume it is an alias tag and upgrade it.

Parameters:: target (RSPImage) – Another tag with the same digest.
Raises:: ValueError – If this image has a type other than unknown or alias. (Ideally this should be represented in the type system, but that code is tedious and doesn’t add much value.)
Return type:: None