Amazon EC2 plugin for CakePHP

Version 1.0 for cake 2.x

This plugin will allow you to interface with Amazon EC2 and perform a subset of the functionality that the EC2 environment offers.

Requirements

CakePHP 2.0+ is required for this plugin.

The AmazonServer Model uses MongoCake plugin for storage.

Installation

Clone the MongoCake plugin, or add as a submodule to your git repository. Alternatively you can download the archive via Github, and place into your Plugin directory:

$ git clone git://github.com/lorenzo/MongoCake.git Plugin/MongoCake
or
$ git submodule add git://github.com/lorenzo/MongoCake.git Plugin/MongoCake

Clone this Ec2 repository into your Plugin directory, or setup as a submodule, or extract an archive from Github:

$ git clone git://github.com/CakeDC/Ec2.git Plugin/Ec2
or
$ git submodule add git://github.com/CakeDC/Ec2.git Plugin/Ec2

Configuration

You need to make CakePHP aware of your plugin, put the following like in your Config/bootstrap.php file

CakePlugin::load('Ec2');

An example configuration file is in the Ec2 directory Config/Amazon.php.default. It contains an example of how Config/database.php should look like after configuring the new datasource, you can copy the example over to the mentioned file and fill in the details.

The settings are taken from your Amazon account settings.

CLI Usage

The command line lets you view information about your amazon ec2 instances, as well as interact with them.

Available commands:

• create
• run
• describe
• start
• stop
• reboot
• terminate
• status

Describe

Show all information about current instances registered with Amazon:

$ cake Ec2.amazon_server describe

Status

View information about a specific instance id:

$ cake Ec2.amazon_server status 4e9e405eb67099021c000000

Reboot

Issue instructions to reboot the instance specified:

$ cake Ec2.amazon_server reboot 4e9e405eb67099021c000000

Stop

Stop an instance. Unlike terminate, this instance will be available for running again later:

$ cake Ec2.amazon_server stop 4e9e405eb67099021c000000

Start

Start an instance that has been stopped

$ cake Ec2.amazon_server start 4e9e405eb67099021c000000

Terminate

Terminate a specific EC2 instance:

$ cake Ec2.amazon_server terminate 4e9e405eb67099021c000000

Terminate all instances:

$ cake Ec2.amazon_server terminate all

Support

For support and feature requests, please use Github issues.

For more information about our Professional CakePHP Services please visit the Cake Development Corporation website.

Branch strategy

The master branch holds the STABLE latest version of the plugin. Develop branch is UNSTABLE and used to test new features before releasing them.

Previous maintenance versions are named after the CakePHP compatible version, for example, branch 1.3 is the maintenance version compatible with CakePHP 1.3. All versions are updated with security patches.

Contributing to this Plugin

Please feel free to contribute to the plugin with new issues, requests, unit tests and code fixes or new features. If you want to contribute some code, create a feature branch from develop, and send us your pull request. Unit tests for new features and issues detected are mandatory to keep quality high.

License

Copyright 2011, Cake Development Corporation

Licensed under The MIT License
Redistributions of files must retain the above copyright notice.

Copyright

Copyright 2011
Cake Development Corporation
1785 E. Sahara Avenue, Suite 490-423
Las Vegas, Nevada 89104
http://cakedc.com