To use **testcloud** on a production system:

  1. Install the **testcloud**.

         ```

         $ sudo dnf install testcloud

         ```

  2. Add yourself to the `testcloud group`.

        ```

        $ sudo usermod -a -G testcloud $USER

        ```

  3. Restart your user session to update the group privileges, or use

     `su -` to get a login shell for that particular user where the group

     settings will be updated.

        ```

        $ su -i $USER

        ```

  To create a new instance with the cloud image, run:

  ```

  ```

  **testcloud** will download the *qcow2* image and save it in the

  To see all instances, use:

  ```

  ```

  Alternatively, the instances can also be viewed and manipulated using

  the **testcloud**, too:

  1. List all instances to see the correct name of the instance:

         ```

         $ testcloud instance list --all

         ```

  2. Start the instance:

         ```

         $ testcloud instance start <instance-name>

         ```

  3. Stop the instance:

         ```

         $ testcloud instance stop <instance-name>

         ```

  4. Remove the instance:

         ```

         $ testcloud instance remove <instance-name>

         ```

  ### Other instance operations

  1. Reboot the instance:

         ```

         $ testcloud instance reboot <instance-name>

         ```

  2. Remove non-existing libvirt VMs from testcloud:

         ```

         $ testcloud instance clean

         ```

  following to the `~/.config/testcloud/settings.py`:

  ```yaml

  ```

  ## Testcloud Development

  ### Prerequisites

  1. Install the dependencies for **testcloud**.

         ```

         $ sudo dnf install libvirt python3-libvirt libguestfs libguestfs-tools python3-requests python3-jinja2

         ```

  2. Start **libvirtd**.

         ```

         $ sudo systemctl start libvirtd

         ```

  3. Add the `testcloud` group to the system.

         ```

         $ sudo groupadd testcloud

         ```

  4. Add a user into the `testcloud` group.

         ```

         $ sudo usermod -a -G testcloud $USER

         ```

  5. Log out of the system and log in again to update the group

     information on your user or use a login shell on a different

     terminal.

         ```

         $ su - $USER

         ```

  ### Installation

  1. Clone the **testcloud** repository.

         ```

         $ git clone https://pagure.io/testcloud.git

         ```

  2. Create the application directories.

         ```

         $ sudo mkdir -p -m 775 /var/lib/testcloud

         ```

         ```

         ```

         ```

         $ sudo mkdir -p -m 775 /var/lib/testcloud/backingstores

         ```

  3. Change ownership on these directories to enable their use with

     **testcloud**.

         ```

         $ sudo chown qemu:testcloud /var/lib/testcloud

         ```

         ```

         $ sudo chown qemu:testcloud /var/lib/testcloud/backingstores

         ```

  4. Copy the `.rules` file to the **polkit** rules.

         ```

         $ sudo cp conf/99-testcloud-nonroot-libvirt-access.rules /etc/polkit-1/rules.d/

         ```

  ### Running testcloud

  1. Navigate to your **testcloud** git repository.

         ```

         $ cd testcloud

         ```

  2. Execute the `run_testcloud.py` script to run the **testcloud**. You

     can use any options as with the regular installation, for example:

         ```

             $ ./run_testcloud.py instance create ...

         ```

  3. Alternatively, you can use **pip** to install **testcloud** onto the

     system and then use it like it has been installed normally.

         ```

         $ pip3 install -e . --user

         ```

  \fBtestcloud\fR [-h, --help] [COMMAND]... [OPTION]... [SUBCOMMAND]... [OPTION]...

  .SH DESCRIPTION

  .LP

  Currently, only Fedora \fBqcow2\fR images are supported.

  .PP

  of the images from the \fBFedora Cloud\fR download pages at \fIhttps://alt.fedoraproject.org/cloud/\fR.

  .PP

  Then, \fBtestcloud\fR will download the image and save it in the \fI/var/lib/testcloud/backingstores/\fR.

  download it again and it will use the current image to create the instance.

  .PP

  When the new instance is created, \fBtestcloud\fR will show its IP address that you can use to

  \fBpassw0rd\fR. The IP address of an instance is shown when you list the instance (see COMMANDS).

  .PP

  The instance can also be manipulated and controlled with \fBvirt-manager\fR.

  .PP

  The configuration file must be placed in one of the following locations in order to be

  recognized.

  \fIconf/settings.py\fR in the git checkout

  \fI~/.config/testcloud/settings.py\fR

  .IP

  \fI/etc/testcloud/settings.py\fR

  \fBstart\fR

          Start an existing instance.

  \fBstop\fR

          Stop a running instance.

  \fBdestroy\fR

          Remove an instance or image. Deprecated, do not use.

  \fBclean\fR

          Remove non-existing or unsynced libvirt VMs from testcloud.

  import os

  import sys

  import libvirt

  from . import config

  from . import image

  from . import instance

  from .exceptions import TestcloudPermissionsError, TestcloudInstanceError

  config_data = config.get_config()

      print("")

  def _create_instance(args):

      """Handler for 'instance create' command. Expects the following elements in args:

      log.debug("create instance")

      try:

          tc_image.prepare()

      except TestcloudPermissionsError as error:

      # this might work better as a second, required positional arg

      instarg_create.add_argument("-u",

                                  "--url",

                                  type=str)

      instarg_create.add_argument("--timeout",

                                  help="Time (in seconds) to wait for boot to "