Package com.yahoo.config.provision

Class ClusterSpec

java.lang.Object

com.yahoo.config.provision.ClusterSpec

public final class ClusterSpec
extends java.lang.Object

A specification of a cluster - or group in a grouped cluster - to be run on a set of hosts. This is a value object.

Author:

bratseth

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClusterSpec.Builder
static class	ClusterSpec.Group	Identifier of a group within a cluster
static class	ClusterSpec.Id
static class	ClusterSpec.Type	A cluster type

Method Summary

Modifier and Type	Method	Description
java.util.Optional<ClusterSpec.Id>	combinedId()	Returns the ID of the container cluster that is combined with this.
java.util.Optional<java.lang.String>	dockerImage()	Returns the docker image (repository + vespa version) we want this cluster to run
java.util.Optional<DockerImage>	dockerImageRepo()	Returns the docker image repository part of a docker image we want this cluster to run
boolean	equals(java.lang.Object o)
ClusterSpec	exclusive(boolean exclusive)
java.util.Optional<ClusterSpec.Group>	group()	Returns the group within the cluster this specifies, or empty to specify the whole cluster
int	hashCode()
ClusterSpec.Id	id()	Returns the cluster id
boolean	isExclusive()	Returns whether the physical hosts running the nodes of this application can also run nodes of other applications.
static ClusterSpec.Builder	request(ClusterSpec.Type type, ClusterSpec.Id id)	Creates a ClusterSpec when requesting a cluster
boolean	satisfies(ClusterSpec other)	Returns whether this satisfies other for allocation purposes.
static ClusterSpec.Builder	specification(ClusterSpec.Type type, ClusterSpec.Id id)	Creates a ClusterSpec for an existing cluster, group id and Vespa version needs to be set
java.lang.String	toString()
ClusterSpec.Type	type()	Returns the cluster type
com.yahoo.component.Version	vespaVersion()	Returns the version of Vespa that we want this cluster to run
ClusterSpec	with(java.util.Optional<ClusterSpec.Group> newGroup)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

type

public ClusterSpec.Type type()

Returns the cluster type

id

public ClusterSpec.Id id()

Returns the cluster id

dockerImageRepo

public java.util.Optional<DockerImage> dockerImageRepo()

Returns the docker image repository part of a docker image we want this cluster to run

dockerImage

public java.util.Optional<java.lang.String> dockerImage()

Returns the docker image (repository + vespa version) we want this cluster to run

vespaVersion

public com.yahoo.component.Version vespaVersion()

Returns the version of Vespa that we want this cluster to run

group

public java.util.Optional<ClusterSpec.Group> group()

Returns the group within the cluster this specifies, or empty to specify the whole cluster

combinedId

public java.util.Optional<ClusterSpec.Id> combinedId()

Returns the ID of the container cluster that is combined with this. This is only present for combined clusters

isExclusive

public boolean isExclusive()

Returns whether the physical hosts running the nodes of this application can also run nodes of other applications. Using exclusive nodes for containers increases security and cost.

with

public ClusterSpec with(java.util.Optional<ClusterSpec.Group> newGroup)

exclusive

public ClusterSpec exclusive(boolean exclusive)

request

public static ClusterSpec.Builder request(ClusterSpec.Type type,
                                          ClusterSpec.Id id)

Creates a ClusterSpec when requesting a cluster

specification

public static ClusterSpec.Builder specification(ClusterSpec.Type type,
                                                ClusterSpec.Id id)

Creates a ClusterSpec for an existing cluster, group id and Vespa version needs to be set

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

satisfies

public boolean satisfies(ClusterSpec other)

Returns whether this satisfies other for allocation purposes. Only considers cluster ID and type, other fields are ignored.