org.jclouds.compute.options
Class TemplateOptions

java.lang.Object
  org.jclouds.compute.options.RunScriptOptions
      org.jclouds.compute.options.TemplateOptions

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

TemplateOptions.ImmutableTemplateOptions

public class TemplateOptions
extends RunScriptOptions
implements Cloneable

Contains options supported in the ComputeService#runNodesWithTag operation.

Usage

The recommended way to instantiate a TemplateOptions object is to statically import TemplateOptions.* and invoke a static creation method followed by an instance mutator (if needed):

import static org.jclouds.compute.options.TemplateOptions.Builder.*;

ComputeService client = // get connection templateBuilder.options(inboundPorts(22, 80, 8080, 443)); Set set = client.runNodesWithTag(tag, 2, templateBuilder.build());

Author:

Adrian Cole

Nested Class Summary

static class	TemplateOptions.Builder
static class	TemplateOptions.ImmutableTemplateOptions

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

RunScriptOptions.ImmutableRunScriptOptions

Field Summary

protected boolean	blockUntilRunning
protected int[]	inboundPorts
protected boolean	includeMetadata
static TemplateOptions	NONE
protected String	privateKey
protected String	publicKey
protected org.jclouds.scriptbuilder.domain.Statement	script
protected Set<String>	tags

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

blockOnComplete, overridingCredentials, port, runAsRoot, seconds, taskName, wrapInInitScript

Constructor Summary

TemplateOptions()

Method Summary

<T extends TemplateOptions> T	as(Class<T> clazz)
TemplateOptions	authorizePublicKey(org.jclouds.io.Payload publicKey) Deprecated.
TemplateOptions	authorizePublicKey(String publicKey) authorize an rsa ssh key.
TemplateOptions	blockOnComplete(boolean blockOnComplete)
TemplateOptions	blockOnPort(int port, int seconds) When the node is started, wait until the following port is active
TemplateOptions	blockUntilRunning(boolean blockUntilRunning)
TemplateOptions	clone()
void	copyTo(TemplateOptions to)
TemplateOptions	dontAuthorizePublicKey()
boolean	equals(Object obj)
int[]	getInboundPorts()
String	getPrivateKey()
String	getPublicKey()
org.jclouds.scriptbuilder.domain.Statement	getRunScript()
Set<String>	getTags()
int	hashCode()
TemplateOptions	inboundPorts(int... ports) Opens the set of ports to public access.
TemplateOptions	installPrivateKey(org.jclouds.io.Payload privateKey) Deprecated.
TemplateOptions	installPrivateKey(String privateKey) replaces the rsa ssh key used at login.
boolean	isIncludeMetadata()
TemplateOptions	nameTask(String name)
TemplateOptions	overrideCredentialsWith(org.jclouds.domain.Credentials overridingCredentials)
TemplateOptions	overrideLoginCredentialWith(String loginCredential)
TemplateOptions	overrideLoginUserWith(String loginUser)
TemplateOptions	runAsRoot(boolean runAsRoot)
TemplateOptions	runScript(byte[] script) Deprecated.
TemplateOptions	runScript(org.jclouds.io.Payload script) This script will be executed as the root user upon system startup.
TemplateOptions	runScript(org.jclouds.scriptbuilder.domain.Statement script)
boolean	shouldBlockUntilRunning()
TemplateOptions	tags(Iterable<String> tags) assigns tags to the created nodes
String	toString()
TemplateOptions	withMetadata()
TemplateOptions	wrapInInitScript(boolean wrapInInitScript) default true

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

getOverridingCredentials, getPort, getSeconds, getTaskName, shouldBlockOnComplete, shouldRunAsRoot, shouldWrapInInitScript

Methods inherited from class java.lang.Object

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

Field Detail

NONE

public static final TemplateOptions NONE

inboundPorts

protected int[] inboundPorts

script

protected org.jclouds.scriptbuilder.domain.Statement script

tags

protected Set<String> tags

privateKey

protected String privateKey

publicKey

protected String publicKey

includeMetadata

protected boolean includeMetadata

blockUntilRunning

protected boolean blockUntilRunning

Constructor Detail

TemplateOptions

public TemplateOptions()

Method Detail

clone

public TemplateOptions clone()

Overrides:

clone in class Object

copyTo

public void copyTo(TemplateOptions to)

getInboundPorts

public int[] getInboundPorts()

getRunScript

public org.jclouds.scriptbuilder.domain.Statement getRunScript()

getTags

public Set<String> getTags()

getPrivateKey

public String getPrivateKey()

getPublicKey

public String getPublicKey()

isIncludeMetadata

public boolean isIncludeMetadata()

shouldBlockUntilRunning

public boolean shouldBlockUntilRunning()

as

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

runScript

@Deprecated
public TemplateOptions runScript(byte[] script)

Deprecated.

This script will be executed as the root user upon system startup. This script gets a prologue, so no #!/bin/bash required, path set up, etc

please use alternative that uses the Statement object

See Also:

Payloads

runScript

public TemplateOptions runScript(org.jclouds.io.Payload script)

This script will be executed as the root user upon system startup. This script gets a prologue, so no #!/bin/bash required, path set up, etc

See Also:

Payloads

runScript

public TemplateOptions runScript(org.jclouds.scriptbuilder.domain.Statement script)

installPrivateKey

public TemplateOptions installPrivateKey(String privateKey)

replaces the rsa ssh key used at login.

installPrivateKey

@Deprecated
public TemplateOptions installPrivateKey(org.jclouds.io.Payload privateKey)

Deprecated.

replaces the rsa ssh key used at login.

please use alternative that uses String

See Also:

Payloads

dontAuthorizePublicKey

public TemplateOptions dontAuthorizePublicKey()

authorizePublicKey

public TemplateOptions authorizePublicKey(String publicKey)

authorize an rsa ssh key.

authorizePublicKey

@Deprecated
public TemplateOptions authorizePublicKey(org.jclouds.io.Payload publicKey)

Deprecated.

authorize an rsa ssh key.

please use alternative that uses String

See Also:

Payloads

tags

public TemplateOptions tags(Iterable<String> tags)

assigns tags to the created nodes

inboundPorts

public TemplateOptions inboundPorts(int... ports)

Opens the set of ports to public access.

withMetadata

public TemplateOptions withMetadata()

toString

public String toString()

Overrides:

toString in class RunScriptOptions

blockUntilRunning

public TemplateOptions blockUntilRunning(boolean blockUntilRunning)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

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 RunScriptOptions

nameTask

public TemplateOptions nameTask(String name)

Overrides:

nameTask in class RunScriptOptions

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 RunScriptOptions

overrideCredentialsWith

public TemplateOptions overrideCredentialsWith(org.jclouds.domain.Credentials overridingCredentials)

Overrides:

overrideCredentialsWith in class RunScriptOptions

overrideLoginUserWith

public TemplateOptions overrideLoginUserWith(String loginUser)

Overrides:

overrideLoginUserWith in class RunScriptOptions

overrideLoginCredentialWith

public TemplateOptions overrideLoginCredentialWith(String loginCredential)

Overrides:

overrideLoginCredentialWith in class RunScriptOptions

wrapInInitScript

public TemplateOptions wrapInInitScript(boolean wrapInInitScript)

Description copied from class: RunScriptOptions

default true

Overrides:

wrapInInitScript in class RunScriptOptions

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)

Overrides:

blockOnComplete in class RunScriptOptions