Package org.jclouds.googlecomputeengine.compute

Class GoogleComputeEngineServiceAdapter

java.lang.Object

org.jclouds.googlecomputeengine.compute.GoogleComputeEngineServiceAdapter

All Implemented Interfaces:

ComputeServiceAdapter<Instance,MachineType,Image,Location>

public final class GoogleComputeEngineServiceAdapter
extends Object
implements ComputeServiceAdapter<Instance,MachineType,Image,Location>

This implementation maps the following:

• ComputeMetadata.getId() to Instance.selfLink()
• NodeMetadata.getGroup() to Instance.metadata() as jclouds-group
• NodeMetadata.getImageId() to Instance.metadata() as jclouds-image
• ComputeMetadata.getId() to MachineType.selfLink()
• ComputeMetadata.getId() to Image.selfLink()
• Location.getId() to Zone.name()
• Location.getDescription() to Zone.selfLink()

Nested Class Summary

Nested classes/interfaces inherited from interface org.jclouds.compute.ComputeServiceAdapter

ComputeServiceAdapter.NodeAndInitialCredentials<N>

Method Summary

Modifier and Type	Method	Description
ComputeServiceAdapter.NodeAndInitialCredentials<Instance>	createNodeWithGroupEncodedIntoName(String group, String name, Template template)	ComputeService.createNodesInGroup(String, int, Template) generates the parameters passed into this method such that each node in the set has a unique name.
void	destroyNode(String selfLink)
Image	getImage(String selfLink)	get a specific image by id
Instance	getNode(String selfLink)
Instance.Scheduling	getScheduling(GoogleComputeEngineTemplateOptions options)
Iterable<MachineType>	listHardwareProfiles()	Hardware profiles describe available cpu, memory, and disk configurations that can be used to run a node.
Iterable<Image>	listImages()	Images are the available configured operating systems that someone can run a node with.
Iterable<Location>	listLocations()	Unlike EC2, you cannot default GCE instances to a region.
Iterable<Instance>	listNodes()
Iterable<Instance>	listNodesByIds(Iterable<String> selfLinks)
void	rebootNode(String selfLink)
void	resumeNode(String selfLink)
void	suspendNode(String selfLink)

Methods inherited from class java.lang.Object

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

Method Detail

createNodeWithGroupEncodedIntoName

public ComputeServiceAdapter.NodeAndInitialCredentials<Instance> createNodeWithGroupEncodedIntoName(String group,
                                                                                                    String name,
                                                                                                    Template template)

Description copied from interface: ComputeServiceAdapter

ComputeService.createNodesInGroup(String, int, Template) generates the parameters passed into this method such that each node in the set has a unique name.

note

It is intentional to return the library native node object, as generic type N. If you are not using library-native objects (such as libvirt Domain) use JCloudsNativeComputeServiceAdapter instead.

note

Your responsibility is to create a node with the underlying library and return after storing its credentials in the supplied map corresponding to credentialStore

Specified by:

createNodeWithGroupEncodedIntoName in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

Parameters:

group - used to aggregate nodes with identical configuration

name - unique supplied name for the node, which has the group encoded into it.

template - includes imageId, locationId, and hardwareId used to resume the instance.

Returns:

library-native representation of a node. TODO: return typed exception on createNodeFailure

See Also:

ComputeService.createNodesInGroup(String, int, Template)

listHardwareProfiles

public Iterable<MachineType> listHardwareProfiles()

Description copied from interface: ComputeServiceAdapter

Hardware profiles describe available cpu, memory, and disk configurations that can be used to run a node.

To implement this method, return the library native hardware profiles available to the user. These will be used to launch nodes as a part of the template.

Specified by:

listHardwareProfiles in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

Returns:

a non-null iterable of available hardware profiles.

See Also:

ComputeService.listHardwareProfiles()

listImages

public Iterable<Image> listImages()

Description copied from interface: ComputeServiceAdapter

Images are the available configured operating systems that someone can run a node with.

To implement this method, return the library native images available to the user. These will be used to launch nodes as a part of the template.

Specified by:

listImages in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

Returns:

a non-null iterable of available images.

See Also:

ComputeService.listImages()

getImage

public Image getImage(String selfLink)

Description copied from interface: ComputeServiceAdapter

get a specific image by id

Specified by:

getImage in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

Parameters:

selfLink - Image#getId, which is not necessarily Image#getProviderId

Returns:

image or null if not exists.

listLocations

public Iterable<Location> listLocations()

Unlike EC2, you cannot default GCE instances to a region. Hence, we constrain to zones.

Specified by:

listLocations in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

getNode

public Instance getNode(String selfLink)

Specified by:

getNode in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

listNodes

public Iterable<Instance> listNodes()

Specified by:

listNodes in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

listNodesByIds

public Iterable<Instance> listNodesByIds(Iterable<String> selfLinks)

Specified by:

listNodesByIds in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

destroyNode

public void destroyNode(String selfLink)

Specified by:

destroyNode in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

rebootNode

public void rebootNode(String selfLink)

Specified by:

rebootNode in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

resumeNode

public void resumeNode(String selfLink)

Specified by:

resumeNode in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

suspendNode

public void suspendNode(String selfLink)

Specified by:

suspendNode in interface ComputeServiceAdapter<Instance,MachineType,Image,Location>

getScheduling

public Instance.Scheduling getScheduling(GoogleComputeEngineTemplateOptions options)