org.jenkinsci.plugins.docker.commons.fingerprint

Class DockerFingerprints

java.lang.Object

org.jenkinsci.plugins.docker.commons.fingerprint.DockerFingerprints

public class DockerFingerprints
extends Object

Entry point into fingerprint related functionalities in Docker. This class provide basic methods for both images and containers

Method Summary

Modifier and Type	Method and Description
static void	addFromFacet(String ancestorImageId, String descendantImageId, hudson.model.Run<?,?> run) Creates a new DockerAncestorFingerprintFacet and DockerDescendantFingerprintFacet and adds a run.
static void	addRunFacet(ContainerRecord record, hudson.model.Run<?,?> run) Adds a new ContainerRecord for the specified image, creating necessary intermediate objects as it goes.
static hudson.model.Fingerprint	forContainer(hudson.model.Run<?,?> run, String id) Deprecated. Use forContainer(hudson.model.Run, java.lang.String, java.lang.String)
static hudson.model.Fingerprint	forContainer(hudson.model.Run<?,?> run, String id, String name) Get or create a Fingerprint for the container.
static hudson.model.Fingerprint	forImage(hudson.model.Run<?,?> run, String id) Deprecated. Use forImage(hudson.model.Run, java.lang.String, java.lang.String)
static hudson.model.Fingerprint	forImage(hudson.model.Run<?,?> run, String id, String name) Get or create a Fingerprint for the image.
static <TFacet extends jenkins.model.FingerprintFacet> TFacet	getFacet(hudson.model.Fingerprint fingerprint, Class<TFacet> facetClass) Retrieves a facet from the Fingerprint.
static <TFacet extends jenkins.model.FingerprintFacet> TFacet	getFacet(String id, Class<TFacet> facetClass) Retrieves a facet from the Fingerprint.
static <TFacet extends jenkins.model.FingerprintFacet> Collection<TFacet>	getFacets(hudson.model.Fingerprint fingerprint, Class<TFacet> facetClass) Retrieves facets from the Fingerprint.
static <TFacet extends jenkins.model.FingerprintFacet> Collection<TFacet>	getFacets(String id, Class<TFacet> facetClass) Retrieves a facet from the Fingerprint.
static String	getFingerprintHash(String id) Gets a fingerprint hash for Docker ID (image or container).
static hudson.model.Fingerprint	of(String id) Gets Fingerprint for a given docker ID.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getFingerprintHash

@Nonnull
public static String getFingerprintHash(@Nonnull
                                                  String id)

Gets a fingerprint hash for Docker ID (image or container). This method calculates image hash without retrieving a fingerprint by of(java.lang.String), which may be a high-cost call.

Parameters:

id - Docker ID (image or container). Only 64-char full IDs are supported.

Returns:

32-char fingerprint hash

Throws:

IllegalArgumentException - Invalid ID

of

@CheckForNull
public static hudson.model.Fingerprint of(@Nonnull
                                                         String id)
                                                  throws IOException

Gets Fingerprint for a given docker ID.

Parameters:

id - Docker ID (image or container). Only 64-char full IDs are supported.

Returns:

Created fingerprint or null if it is not found

Throws:

IOException - Fingerprint loading error

forImage

@Nonnull
public static hudson.model.Fingerprint forImage(@CheckForNull
                                                          hudson.model.Run<?,?> run,
                                                          @Nonnull
                                                          String id)
                                                   throws IOException

Deprecated. Use forImage(hudson.model.Run, java.lang.String, java.lang.String)

Throws:

IOException

forImage

@Nonnull
public static hudson.model.Fingerprint forImage(@CheckForNull
                                                          hudson.model.Run<?,?> run,
                                                          @Nonnull
                                                          String id,
                                                          @CheckForNull
                                                          String name)
                                                   throws IOException

Get or create a Fingerprint for the image.

Parameters:

run - Origin of the fingerprint (if available)

id - Image ID. Only 64-char full IDs are supported.

name - Optional name of the image. If null, the image name will be constructed using the specified ID.

Returns:

Fingerprint for the specified ID

Throws:

IOException - Fingerprint load/save error

Since:

TODO

forContainer

@Deprecated
 @Nonnull
public static hudson.model.Fingerprint forContainer(@CheckForNull
                                                                            hudson.model.Run<?,?> run,
                                                                            @Nonnull
                                                                            String id)
                                                                     throws IOException

Deprecated. Use forContainer(hudson.model.Run, java.lang.String, java.lang.String)

Throws:

IOException

forContainer

@Nonnull
public static hudson.model.Fingerprint forContainer(@CheckForNull
                                                              hudson.model.Run<?,?> run,
                                                              @Nonnull
                                                              String id,
                                                              @CheckForNull
                                                              String name)
                                                       throws IOException

Get or create a Fingerprint for the container.

Parameters:

run - Origin of the fingerprint (if available)

id - Container ID. Only 64-char full IDs are supported.

name - Optional name of the container. If null, the container name will be constructed using the specified ID.

Returns:

Fingerprint for the specified ID

Throws:

IOException - Fingerprint load/save error

Since:

TODO

getFacet

@CheckForNull
public static <TFacet extends jenkins.model.FingerprintFacet> TFacet getFacet(@Nonnull
                                                                                             String id,
                                                                                             @Nonnull
                                                                                             Class<TFacet> facetClass)

Retrieves a facet from the Fingerprint. The method suppresses IOException if a fingerprint loading fails.

Type Parameters:

TFacet - Facet type to be retrieved

Parameters:

id - Docker item ID. Only 64-char full IDs are supported

facetClass - Class to be retrieved

Returns:

First matching facet. Null may be returned if there is no facet or if the loading fails

getFacets

@Nonnull
public static <TFacet extends jenkins.model.FingerprintFacet> Collection<TFacet> getFacets(@Nonnull
                                                                                                     String id,
                                                                                                     @Nonnull
                                                                                                     Class<TFacet> facetClass)

Retrieves a facet from the Fingerprint. The method suppresses IOException if a fingerprint loading fails.

Type Parameters:

TFacet - Facet type to be retrieved

Parameters:

id - Docker item ID. Only 64-char full IDs are supported

facetClass - Class to be retrieved

Returns:

First matching facet. Null may be returned if the loading fails

getFacet

@CheckForNull
public static <TFacet extends jenkins.model.FingerprintFacet> TFacet getFacet(@Nonnull
                                                                                             hudson.model.Fingerprint fingerprint,
                                                                                             @Nonnull
                                                                                             Class<TFacet> facetClass)

Retrieves a facet from the Fingerprint.

Type Parameters:

TFacet - Facet type to be retrieved

Parameters:

fingerprint - Fingerprint, which stores facets

facetClass - Class to be retrieved

Returns:

First matching facet.

getFacets

@Nonnull
public static <TFacet extends jenkins.model.FingerprintFacet> Collection<TFacet> getFacets(@Nonnull
                                                                                                     hudson.model.Fingerprint fingerprint,
                                                                                                     @Nonnull
                                                                                                     Class<TFacet> facetClass)

Retrieves facets from the Fingerprint.

Type Parameters:

TFacet - Facet type to be retrieved

Parameters:

fingerprint - Fingerprint, which stores facets

facetClass - Facet class to be retrieved

Returns:

All found facets

addRunFacet

public static void addRunFacet(@Nonnull
                               ContainerRecord record,
                               @Nonnull
                               hudson.model.Run<?,?> run)
                        throws IOException

Adds a new ContainerRecord for the specified image, creating necessary intermediate objects as it goes.

Throws:

IOException

addFromFacet

public static void addFromFacet(@CheckForNull
                                String ancestorImageId,
                                @Nonnull
                                String descendantImageId,
                                @Nonnull
                                hudson.model.Run<?,?> run)
                         throws IOException

Creates a new DockerAncestorFingerprintFacet and DockerDescendantFingerprintFacet and adds a run. Or adds to existing facets.

Parameters:

ancestorImageId - the ID of the image specified in a FROM instruction, or null in case of scratch (i.e., the descendant is a base image)

descendantImageId - the ID of the image which was built

run - the build in which the image building occurred

Throws:

IOException