com.google.cloud.tools.jib.registry

Class RegistryClient

java.lang.Object

com.google.cloud.tools.jib.registry.RegistryClient

public class RegistryClient
extends Object

Interfaces with a registry.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RegistryClient.Factory Factory for creating RegistryClients.

Method Summary

Modifier and Type	Method and Description
BlobDescriptor	checkBlob(DescriptorDigest blobDigest)
static RegistryClient.Factory	factory(String serverUrl, String imageName)
RegistryAuthenticator	getRegistryAuthenticator()
Void	pullBlob(DescriptorDigest blobDigest, OutputStream destinationOutputStream) Downloads the BLOB to a file.
ManifestTemplate	pullManifest(String imageTag)
<T extends ManifestTemplate> T	pullManifest(String imageTag, Class<T> manifestTemplateClass) Pulls the image manifest for a specific tag.
boolean	pushBlob(DescriptorDigest blobDigest, Blob blob) Pushes the BLOB, or skips if the BLOB already exists on the registry.
void	pushManifest(BuildableManifestTemplate manifestTemplate, String imageTag) Pushes the image manifest for a specific tag.
RegistryClient	setTimer(Timer parentTimer)
static void	setUserAgentSuffix(String userAgentSuffix) Sets a suffix to append to User-Agent headers.

Methods inherited from class java.lang.Object

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

Method Detail

setTimer

public RegistryClient setTimer(Timer parentTimer)

factory

public static RegistryClient.Factory factory(String serverUrl,
                                             String imageName)

Parameters:

serverUrl - the server URL for the registry (for example, gcr.io)

imageName - the image/repository name (also known as, namespace)

Returns:

the new RegistryClient.Factory

setUserAgentSuffix

public static void setUserAgentSuffix(@Nullable
                                      String userAgentSuffix)

Sets a suffix to append to User-Agent headers.

Parameters:

userAgentSuffix - the suffix to append

getRegistryAuthenticator

@Nullable
public RegistryAuthenticator getRegistryAuthenticator()
                                                         throws IOException,
                                                                RegistryException

Returns:

the RegistryAuthenticator to authenticate pulls/pushes with the registry, or null if no token authentication is necessary

Throws:

IOException - if communicating with the endpoint fails

RegistryException - if communicating with the endpoint fails

pullManifest

public <T extends ManifestTemplate> T pullManifest(String imageTag,
                                                   Class<T> manifestTemplateClass)
                                            throws IOException,
                                                   RegistryException

Pulls the image manifest for a specific tag.

Type Parameters:

T - child type of ManifestTemplate

Parameters:

imageTag - the tag to pull on

manifestTemplateClass - the specific version of manifest template to pull, or ManifestTemplate to pull either V22ManifestTemplate or V21ManifestTemplate

Returns:

the manifest template

Throws:

IOException - if communicating with the endpoint fails

RegistryException - if communicating with the endpoint fails

pullManifest

public ManifestTemplate pullManifest(String imageTag)
                              throws IOException,
                                     RegistryException

Throws:

IOException

RegistryException

pushManifest

public void pushManifest(BuildableManifestTemplate manifestTemplate,
                         String imageTag)
                  throws IOException,
                         RegistryException

Pushes the image manifest for a specific tag.

Parameters:

manifestTemplate - the image manifest

imageTag - the tag to push on

Throws:

IOException - if communicating with the endpoint fails

RegistryException - if communicating with the endpoint fails

checkBlob

@Nullable
public BlobDescriptor checkBlob(DescriptorDigest blobDigest)
                                   throws IOException,
                                          RegistryException

Parameters:

blobDigest - the blob digest to check for

Returns:

the BLOB's BlobDescriptor if the BLOB exists on the registry, or null if it doesn't

Throws:

IOException - if communicating with the endpoint fails

RegistryException - if communicating with the endpoint fails

pullBlob

public Void pullBlob(DescriptorDigest blobDigest,
                     OutputStream destinationOutputStream)
              throws RegistryException,
                     IOException

Downloads the BLOB to a file.

Parameters:

blobDigest - the digest of the BLOB to download

destinationOutputStream - the OutputStream to write the BLOB to

Returns:

a Blob backed by the file at destPath. The file at destPath must exist for Blob to be valid.

Throws:

IOException - if communicating with the endpoint fails

RegistryException - if communicating with the endpoint fails

pushBlob

public boolean pushBlob(DescriptorDigest blobDigest,
                        Blob blob)
                 throws IOException,
                        RegistryException

Pushes the BLOB, or skips if the BLOB already exists on the registry.

Parameters:

blobDigest - the digest of the BLOB, used for existence-check

blob - the BLOB to push

Returns:

true if the BLOB already exists on the registry and pushing was skipped; false if the BLOB was pushed

Throws:

IOException - if communicating with the endpoint fails

RegistryException - if communicating with the endpoint fails