Package org.jclouds.compute.options

Class TemplateOptions.ImmutableTemplateOptions

java.lang.Object

org.jclouds.compute.options.RunScriptOptions

org.jclouds.compute.options.TemplateOptions

org.jclouds.compute.options.TemplateOptions.ImmutableTemplateOptions

All Implemented Interfaces:

Cloneable

Enclosing class:

TemplateOptions

public static class TemplateOptions.ImmutableTemplateOptions
extends TemplateOptions

Nested Class Summary

Nested classes/interfaces inherited from class org.jclouds.compute.options.TemplateOptions

TemplateOptions.Builder, TemplateOptions.ImmutableTemplateOptions

Nested classes/interfaces inherited from class org.jclouds.compute.options.RunScriptOptions

RunScriptOptions.ImmutableRunScriptOptions

Field Summary

Fields inherited from class org.jclouds.compute.options.TemplateOptions

blockUntilRunning, inboundPorts, networks, nodeNames, NONE, privateKey, publicKey, script, securityGroups, tags, userMetadata

Fields inherited from class org.jclouds.compute.options.RunScriptOptions

authenticateSudo, blockOnComplete, loginPassword, loginPrivateKey, loginUser, port, runAsRoot, seconds, taskName, wrapInInitScript

Constructor Summary

Constructors

Constructor	Description
ImmutableTemplateOptions(TemplateOptions delegate)

Method Summary

Modifier and Type	Method	Description
<T extends TemplateOptions> T	as(Class<T> clazz)
TemplateOptions	authorizePublicKey(String publicKey)	authorize an rsa ssh key.
TemplateOptions	blockOnComplete(boolean blockOnComplete)	As of version 1.1.0, we cannot kick off a script unless a node is in RUNNING state.
TemplateOptions	blockOnPort(int port, int seconds)	When the node is started, wait until the following port is active
TemplateOptions	blockUntilRunning(boolean blockUntilRunning)	unsupported as objects of this class are immutable
TemplateOptions	clone()
void	copyTo(TemplateOptions to)
TemplateOptions	dontAuthorizePublicKey()
Set<String>	getGroups()
int[]	getInboundPorts()
String	getLoginPassword()
String	getLoginPrivateKey()
String	getLoginUser()
Set<String>	getNodeNames()
int	getPort()
String	getPrivateKey()
String	getPublicKey()
Statement	getRunScript()
int	getSeconds()
Set<String>	getTags()
String	getTaskName()
Map<String,String>	getUserMetadata()
TemplateOptions	inboundPorts(int... ports)	Opens the set of ports to public access.
TemplateOptions	installPrivateKey(String privateKey)	replaces the rsa ssh key used at login.
TemplateOptions	nameTask(String name)
TemplateOptions	networks(Iterable<String> networks)	Assigns the created nodes to these networks
TemplateOptions	networks(String... networks)
TemplateOptions	nodeNames(Iterable<String> nodeNames)	specifies names to be used for the created nodes.
TemplateOptions	overrideAuthenticateSudo(boolean authenticateSudo)
TemplateOptions	overrideLoginCredentials(LoginCredentials overridingCredentials)
TemplateOptions	overrideLoginPassword(String password)
TemplateOptions	overrideLoginPrivateKey(String privateKey)
TemplateOptions	overrideLoginUser(String loginUser)
TemplateOptions	runAsRoot(boolean runAsRoot)
TemplateOptions	runScript(Statement script)	unsupported as objects of this class are immutable
TemplateOptions	securityGroups(Iterable<String> securityGroups)	assigns the created nodes to these security groups
TemplateOptions	securityGroups(String... securityGroups)
Boolean	shouldAuthenticateSudo()
boolean	shouldBlockOnComplete()
boolean	shouldBlockUntilRunning()
boolean	shouldRunAsRoot()	Whether to run the script as root (or run with current privileges).
boolean	shouldWrapInInitScript()	Whether to wait until the script has completed.
TemplateOptions	tags(Iterable<String> tags)	assigns tags to the created nodes
String	toString()
TemplateOptions	userMetadata(String key, String value)
TemplateOptions	userMetadata(Map<String,String> userMetadata)
TemplateOptions	wrapInInitScript(boolean wrapInInitScript)	default true

Methods inherited from class org.jclouds.compute.options.TemplateOptions

equals, getNetworks, hashCode, runScript, string

Methods inherited from class org.jclouds.compute.options.RunScriptOptions

copyTo, hasLoginPassword, hasLoginPasswordOption, hasLoginPrivateKey, hasLoginPrivateKeyOption, overrideLoginPassword, overrideLoginPrivateKey

Methods inherited from class java.lang.Object

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

Constructor Details

ImmutableTemplateOptions

public ImmutableTemplateOptions(TemplateOptions delegate)

Method Details

clone

public TemplateOptions clone()

Overrides:

clone in class TemplateOptions

getTaskName

public String getTaskName()

Overrides:

getTaskName in class RunScriptOptions

getPort

public int getPort()

Overrides:

getPort in class RunScriptOptions

getSeconds

public int getSeconds()

Overrides:

getSeconds in class RunScriptOptions

shouldRunAsRoot

public boolean shouldRunAsRoot()

Description copied from class: RunScriptOptions

Whether to run the script as root (or run with current privileges). By default, true.

Overrides:

shouldRunAsRoot in class RunScriptOptions

Returns:

value

shouldBlockOnComplete

public boolean shouldBlockOnComplete()

Overrides:

shouldBlockOnComplete in class RunScriptOptions

See Also:

• RunScriptOptions.blockOnComplete(boolean)

shouldWrapInInitScript

public boolean shouldWrapInInitScript()

Description copied from class: RunScriptOptions

Whether to wait until the script has completed. By default, true.

Overrides:

shouldWrapInInitScript in class RunScriptOptions

Returns:

value

copyTo

public void copyTo(TemplateOptions to)

Overrides:

copyTo in class TemplateOptions

toString

public String toString()

Overrides:

toString in class RunScriptOptions

runScript

public TemplateOptions runScript(Statement script)

unsupported as objects of this class are immutable

Overrides:

runScript in class TemplateOptions

dontAuthorizePublicKey

public TemplateOptions dontAuthorizePublicKey()

Overrides:

dontAuthorizePublicKey in class TemplateOptions

blockOnPort

public TemplateOptions blockOnPort(int port,
 int seconds)

Description copied from class: RunScriptOptions

When the node is started, wait until the following port is active

Overrides:

blockOnPort in class TemplateOptions

nameTask

public TemplateOptions nameTask(String name)

Overrides:

nameTask in class TemplateOptions

Returns:

What to call the task relating to this script; default jclouds-script-timestamp where timestamp is millis since epoch

runAsRoot

public TemplateOptions runAsRoot(boolean runAsRoot)

Overrides:

runAsRoot in class TemplateOptions

wrapInInitScript

public TemplateOptions wrapInInitScript(boolean wrapInInitScript)

Description copied from class: RunScriptOptions

default true

Overrides:

wrapInInitScript in class TemplateOptions

Parameters:

wrapInInitScript - if the command is long-running, use this option to ensure it is wrapInInitScripted properly. (ex. have jclouds wrap it an init script, nohup, etc)

Returns:

blockOnComplete

public TemplateOptions blockOnComplete(boolean blockOnComplete)

Description copied from class: RunScriptOptions

As of version 1.1.0, we cannot kick off a script unless a node is in RUNNING state.

Overrides:

blockOnComplete in class TemplateOptions

Parameters:

blockOnComplete - (default true) false means kick off the script in the background, but don't wait for it to finish. (as of version 1.1.0, implemented as nohup)

overrideLoginCredentials

public TemplateOptions overrideLoginCredentials(LoginCredentials overridingCredentials)

Overrides:

overrideLoginCredentials in class TemplateOptions

overrideLoginPassword

public TemplateOptions overrideLoginPassword(String password)

Overrides:

overrideLoginPassword in class TemplateOptions

overrideLoginPrivateKey

public TemplateOptions overrideLoginPrivateKey(String privateKey)

Overrides:

overrideLoginPrivateKey in class TemplateOptions

overrideAuthenticateSudo

public TemplateOptions overrideAuthenticateSudo(boolean authenticateSudo)

Overrides:

overrideAuthenticateSudo in class TemplateOptions

getLoginUser

public String getLoginUser()

Overrides:

getLoginUser in class RunScriptOptions

Returns:

the login user for ComputeService.runScriptOnNode(java.lang.String, org.jclouds.scriptbuilder.domain.Statement, org.jclouds.compute.options.RunScriptOptions). By default, null.

shouldAuthenticateSudo

public Boolean shouldAuthenticateSudo()

Overrides:

shouldAuthenticateSudo in class RunScriptOptions

Returns:

Whether the login user should authenticate sudo during ComputeService.runScriptOnNode(java.lang.String, org.jclouds.scriptbuilder.domain.Statement, org.jclouds.compute.options.RunScriptOptions). By default, null.

getLoginPassword

public String getLoginPassword()

Overrides:

getLoginPassword in class RunScriptOptions

Returns:

the login password for ComputeService.runScriptOnNode(java.lang.String, org.jclouds.scriptbuilder.domain.Statement, org.jclouds.compute.options.RunScriptOptions). By default, null.

getLoginPrivateKey

public String getLoginPrivateKey()

Overrides:

getLoginPrivateKey in class RunScriptOptions

Returns:

the login ssh key for ComputeService.runScriptOnNode(java.lang.String, org.jclouds.scriptbuilder.domain.Statement, org.jclouds.compute.options.RunScriptOptions). By default, null.

overrideLoginUser

public TemplateOptions overrideLoginUser(String loginUser)

Overrides:

overrideLoginUser in class TemplateOptions

as

public <T extends TemplateOptions> T as(Class<T> clazz)

Overrides:

as in class TemplateOptions

authorizePublicKey

public TemplateOptions authorizePublicKey(String publicKey)

Description copied from class: TemplateOptions

authorize an rsa ssh key.

Overrides:

authorizePublicKey in class TemplateOptions

blockUntilRunning

public TemplateOptions blockUntilRunning(boolean blockUntilRunning)

unsupported as objects of this class are immutable

Overrides:

blockUntilRunning in class TemplateOptions

Parameters:

blockUntilRunning - (default true) whether to block until the nodes in this template are in

invalid reference

Status#RUNNING

state

getInboundPorts

public int[] getInboundPorts()

Overrides:

getInboundPorts in class TemplateOptions

getPrivateKey

public String getPrivateKey()

Overrides:

getPrivateKey in class TemplateOptions

getPublicKey

public String getPublicKey()

Overrides:

getPublicKey in class TemplateOptions

getRunScript

public Statement getRunScript()

Overrides:

getRunScript in class TemplateOptions

shouldBlockUntilRunning

public boolean shouldBlockUntilRunning()

Overrides:

shouldBlockUntilRunning in class TemplateOptions

See Also:

• TemplateOptions.blockUntilRunning(boolean)

inboundPorts

public TemplateOptions inboundPorts(int... ports)

Description copied from class: TemplateOptions

Opens the set of ports to public access.

Overrides:

inboundPorts in class TemplateOptions

installPrivateKey

public TemplateOptions installPrivateKey(String privateKey)

Description copied from class: TemplateOptions

replaces the rsa ssh key used at login.

Overrides:

installPrivateKey in class TemplateOptions

getTags

public Set<String> getTags()

Overrides:

getTags in class TemplateOptions

tags

public TemplateOptions tags(Iterable<String> tags)

Description copied from class: TemplateOptions

assigns tags to the created nodes

Overrides:

tags in class TemplateOptions

getNodeNames

public Set<String> getNodeNames()

Overrides:

getNodeNames in class TemplateOptions

nodeNames

public TemplateOptions nodeNames(Iterable<String> nodeNames)

Description copied from class: TemplateOptions

specifies names to be used for the created nodes. Note that this does not guarantee uniqueness - if there are already existing nodes with a name specified here, there will still be a new node created with the same name. Also, if more nodes are to be created than there are names, subsequent names will use the default naming strategy for that cloud.

Overrides:

nodeNames in class TemplateOptions

getGroups

public Set<String> getGroups()

Overrides:

getGroups in class TemplateOptions

securityGroups

public TemplateOptions securityGroups(Iterable<String> securityGroups)

Description copied from class: TemplateOptions

assigns the created nodes to these security groups

Overrides:

securityGroups in class TemplateOptions

securityGroups

public TemplateOptions securityGroups(String... securityGroups)

Overrides:

securityGroups in class TemplateOptions

See Also:

• TemplateOptions.securityGroups(Iterable<String>)

networks

public TemplateOptions networks(Iterable<String> networks)

Description copied from class: TemplateOptions

Assigns the created nodes to these networks

Overrides:

networks in class TemplateOptions

networks

public TemplateOptions networks(String... networks)

Overrides:

networks in class TemplateOptions

See Also:

• TemplateOptions.networks(Iterable)

userMetadata

public TemplateOptions userMetadata(Map<String,String> userMetadata)

Overrides:

userMetadata in class TemplateOptions

Parameters:

userMetadata - user-defined metadata to assign to this server

userMetadata

public TemplateOptions userMetadata(String key,
 String value)

Overrides:

userMetadata in class TemplateOptions

Parameters:

key - key to place into the metadata map

value - value to associate with that key

getUserMetadata

public Map<String,String> getUserMetadata()

Overrides:

getUserMetadata in class TemplateOptions

See Also:

• TemplateOptions.userMetadata(Map)