• Getting Started
• Documentation
• Community
• Development
• Contact

Introduction

Amazon EC2 (aws-ec2) and compatible apis such as Eucalyptus (eucalyptus) include support for remountable block devices, called EBS. In jclouds, control features for this are exposed in 3 ways: hooks within ComputeService (EC2TemplateOptions and viewing via NodeMetadata), directly through the provider api (ElasticBlockStoreClient), and our clojure functions (ebs2.clj).

ComputeService Integration

jclouds reports current status of volume mappings inside a Node's Hardware field.
You can setup volume mappings with extended template options.

Viewing the current volumes attached to a node

EBS volumes will report in the collection returned by node.getHardware().getVolumes() as type Volume.Type.SAN

Setting up Volume Mappings

jclouds also has a means to setup volume mappings when you start your nodes. Here's an example:

      template.getOptions().as(EC2TemplateOptions.class)//
               // .unmapDeviceNamed("/dev/foo)
               .mapEphemeralDeviceToDeviceName("/dev/sdm", "ephemeral0")//
               .mapNewVolumeToDeviceName("/dev/sdn", volumeSize, true)//
               .mapEBSSnapshotToDeviceName("/dev/sdo", snapshot.getId(), volumeSize, true);

Elastic Block Store Client

getting access to the client

      ElasticBlockStoreClient ebsClient = EC2Client.class.cast(context.getProviderSpecificContext().getApi())
               .getElasticBlockStoreServices();

generating a snapshot

      Snapshot snapshot = ebsClient.createSnapshotInRegion(volume.getRegion(), volume.getId());

ebs2.clj

(use 'org.jclouds.ec2.ebs2)

(def ec2 (compute-service "aws-ec2" "ACCESSKEY" "SECRETKEY" :sshj))

(volumes ec2)