Cloudlets are universal server images for the cloud. They're lightweight, version-controlled, and you can export them to any bootable format known to man: Xen, KVM, Amazon EC2, or just a plain bootable CD.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
sample.cloudlet
.hgignore
.hgtags
LICENSE.txt
README.txt
__init__.py
cloudlets.py
setup.py
tests.py

README.txt

cloudlets v.0.0.2

Author: Solomon Hykes <solomon.hykes@dotcloud.com>
License : see LICENSE file.
Url: http://bitbucket.org/dotcloud/cloudlets

Description:
------------

Cloudlets are universal server images for the cloud.

They're lightweight, version-controlled, and you can export them to any bootable format known to man: Xen, KVM, Amazon EC2, or just a plain bootable CD.


Installing:
-----------

1. One of our dependencies (python-spidermonkey) requires the following system packages to be installed:

    On Ubuntu/debian:
    # apt-get install pkg-config build-essential python-dev libspr4-dev

2. Run the install script

    # python setup.py install


Examples:
---------

# cloudlets find sample.cloudlet

    List the contents of an image

# cloudlets find sample.cloudlet --only templates volatile

    List only template and volatile files in an image

# cloudlets manifest sample.cloudlet

    Display an image's manifest

# cloudlets tar sample.cloudlet --config '{"args": {"hostname": "host1"}, "dns": {"nameservers": ["0.0.0.0"]}, "ip": {"interfaces": []}}' | tar tv

    Generate a tar archive from an image, configuring it on the fly with the given JSON configuration.
    The tarball can be piped into vm2vm [1] to generate an EC2 image, for example.

[1] http://bitbucket.org/dotcloud/vm2vm

# touch sample.cloudlet/etc/foo
# cloudlets hg sample.cloudlet add
# cloudlets hg sample.cloudlet commit -u "Solomon Hykes <solomon.hykes@dotcloud.com>" -m "Added configuration file foo"

    Make a change to an image, then commit it using Mercurial.


Coming soon:
------------

 * Distributed versioning (fork and improve other people's images!)
 * Multi-image stacks
 * Automated tests (Cucumber tests for your stack!)
 * VM generator

And much more.