org.jenkinsci.plugins.docker.commons

Class DockerRegistryEndpoint

java.lang.Object

hudson.model.AbstractDescribableImpl<DockerRegistryEndpoint>

org.jenkinsci.plugins.docker.commons.DockerRegistryEndpoint

All Implemented Interfaces:

hudson.model.Describable<DockerRegistryEndpoint>

public class DockerRegistryEndpoint
extends hudson.model.AbstractDescribableImpl<DockerRegistryEndpoint>

Encapsulates the endpoint of DockerHub and how to interact with it.

As Describable it comes with pre-baked configuration form that you can use in your builders/publishers/etc that interact with Docker daemon.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DockerRegistryEndpoint.DescriptorImpl

Constructor Summary

Constructors

Constructor and Description
DockerRegistryEndpoint(String url, String credentialsId)

Method Summary

Modifier and Type	Method and Description
String	getCredentialsId() ID of the credentials used to talk to this endpoint.
URL	getEffectiveUrl() Gets the endpoint URL, such as "http://index.docker.io/v1/"
DockerRegistryToken	getToken(hudson.model.Item context) Plugins that want to refer to a DockerRegistryCredentials should do so via ID string, and use this method to resolve it to DockerRegistryCredentials.
String	getUrl() For stapler.
String	imageName(String userAndRepo) Decorates the repository ID like "jenkinsci/workflow-demo" with repository prefix.
KeyMaterial	materialize(hudson.model.AbstractBuild build) Makes the credentials available locally for the on-going build and returns KeyMaterial that gives you the parameters needed to access it.
KeyMaterial	materialize(hudson.model.Item context, hudson.remoting.VirtualChannel target) Makes the credentials available locally and returns KeyMaterial that gives you the parameters needed to access it.
String	toString()

Methods inherited from class hudson.model.AbstractDescribableImpl

getDescriptor

Methods inherited from class java.lang.Object

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

Constructor Detail

DockerRegistryEndpoint

@DataBoundConstructor
public DockerRegistryEndpoint(String url,
                                                    String credentialsId)

Method Detail

getEffectiveUrl

@Nonnull
public URL getEffectiveUrl()
                             throws IOException

Gets the endpoint URL, such as "http://index.docker.io/v1/"

Throws:

IOException

getUrl

@Nullable
public String getUrl()

For stapler.

getCredentialsId

@Nullable
public String getCredentialsId()

ID of the credentials used to talk to this endpoint.

getToken

@CheckForNull
public DockerRegistryToken getToken(hudson.model.Item context)

Plugins that want to refer to a DockerRegistryCredentials should do so via ID string, and use this method to resolve it to DockerRegistryCredentials.

Parameters:

context - If you are a build step trying to access DockerHub in the context of a build/job, specify that job. Otherwise null. If you are scoped to something else, you might have to interact with CredentialsProvider directly.

materialize

public KeyMaterial materialize(hudson.model.AbstractBuild build)
                        throws IOException,
                               InterruptedException

Makes the credentials available locally for the on-going build and returns KeyMaterial that gives you the parameters needed to access it.

Throws:

IOException

InterruptedException

materialize

public KeyMaterial materialize(hudson.model.Item context,
                               hudson.remoting.VirtualChannel target)
                        throws IOException,
                               InterruptedException

Makes the credentials available locally and returns KeyMaterial that gives you the parameters needed to access it.

Throws:

IOException

InterruptedException

imageName

public String imageName(String userAndRepo)
                 throws IOException

Decorates the repository ID like "jenkinsci/workflow-demo" with repository prefix.

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object