testCloud - the best pretend cloud you’ll ever use

testCloud is a relatively simple system which is capable of booting images designed for cloud systems on a local system with minimial configuration. testCloud is desiged to be (and remain) somewhat simple, trading fancy cloud system features for ease of use and sanity in development.

Installing testCloud

The easiest way to install and use testCloud is to install the package from COPR:

dnf enable SOMECOPR
dnf install testCloud

Using testCloud

The main testCloud interface uses the terminal and the binary named testcloud. testCloud operations can be split into two major categories: image commands and instance commands.

Image Commands

testcloud image list
List all of the images currently cached by testCloud
testcloud image destroy <image name>
Remove the image named <image name> from the local image cache. Make sure to replace <image name> with the name of an image which is currently cached.

Instance Commands

testcloud instance list
List all of the instances currently running and spawned by testCloud. Adding the --all flag will list all instances spawned by testCloud whether the instance is currently running or not
testcloud instance create <instance name> -u <image url>
Create a new testCloud instance using the name <instance name> and the image stored at the url <image url>. Currently supported image url types are http(s):// and file://. Run testcloud instance create --help for information on other options for image creation.
testcloud instance stop <instance name>
Stop the instance with name <instance name>
testcloud instance start <instance name>
Start the instance with name <instance name>
testcloud instance destroy <instance name>
Destroy the instance with name <instance name>. This command will fail if the instance is not currently stopped

Getting Help

Self service methods for asking questions and filing tickets:

For other questions, the best places to ask are:

Licenses

The testCloud library is licensed as GNU General Public Licence v2.0 or later.

The documentation for testCloud is licensed under a Creative Commons Atribution-ShareAlike 4.0 International License.

Indices and tables