README
1This is an interface to Amazon EC2 REST tools that follows the
22014-05-01 API. I created it because I needed access to the Tag and
3TagSet interfaces, and neither euca2ools nor Net::Amazon::EC2 provided
4this functionality. Support for the following services are complete:
5
6 Elastic Compute Cloud (EC2)
7 Virtual Private Cloud (VPC)
8 Elastic Load Balancing (ELB) and Autoscaling
9 Relational Database Service (RDS)
10
11The module is designed to work in a standard procedural manner, as
12well as in an event-driven application using the AnyEvent framework.
13
14The following code illustrates the object-oriented features of the
15module:
16
17 # get new EC2 object
18 my $ec2 = VM::EC2->new(-access_key => 'access key id',
19 -secret_key => 'aws_secret_key',
20 -endpoint => 'http://ec2.amazonaws.com');
21
22 # fetch an image by its ID
23 my $image = $ec2->describe_images('ami-12345');
24
25 # get some information about the image
26 my $architecture = $image->architecture;
27 my $description = $image->description;
28 my @devices = $image->blockDeviceMapping;
29 for my $d (@devices) {
30 print $d->deviceName,"\n";
31 print $d->snapshotId,"\n";
32 print $d->volumeSize,"\n";
33 }
34
35 # run two instances
36 my @instances = $image->run_instances(-key_name =>'My_key',
37 -security_group=>'default',
38 -min_count =>2,
39 -instance_type => 't1.micro')
40 or die $ec2->error_str;
41
42 # wait for both instances to reach "running" or other terminal state
43 $ec2->wait_for_instances(@instances);
44
45 # print out both instance's current state and DNS name
46 for my $i (@instances) {
47 my $status = $i->current_status;
48 my $dns = $i->dnsName;
49 print "$i: [$status] $dns\n";
50 }
51
52 # tag both instances with Role "server"
53 foreach (@instances) {$_->add_tag(Role=>'server');
54
55 # stop both instances
56 foreach (@instances) {$_->stop}
57
58 $ec2->wait_for_instances(@instances); # wait till they stop
59
60 # create an image from both instance, tag them, and make them public
61 for my $i (@instances) {
62 my $img = $i->create_image("Autoimage from $i","Test image");
63 $img->add_tags(Name => "Autoimage from $i",
64 Role => 'Server',
65 Status=> 'Production');
66 $img->make_public(1);
67 }
68
69Development and bug reports
70---------------------------
71
72This module is supported using GitHub at
73https://github.com/lstein/LibVM-EC2-Perl. To report a bug please open
74the Issues tag and file a bug report using the "New Issue" button.
75
76To contribute to development of this module, please obtain a github
77account for yourself and then either:
78
79 1) Fork a copy of the repository, make your changes against this repository,
80 and send a pull request to me to incorporate your changes.
81
82 2) Contact me by email and ask for push privileges on the repository.
83
84See http://help.github.com/ for help getting started.
85
86Credits
87-------
88
89Many thanks to Lance Kinley, who contributed support for Network ACLs,
90VPC VPNs, Elastic Load Balancing, RDS, and many smaller feature
91enhancements as well as bug and documentation fixes.
92
93Author
94------
95
96Lincoln D. Stein <lincoln.stein@gmail.com>
9713 September 2012
98
99
100
101