From Fedora Project Wiki

(newgrp is dangerous)
(the tool is called "testcloud", rename from "local test cloud" which is confusing)
Line 1: Line 1:
{{Infobox_group
| name = Local Test Cloud Installation Guide
| image = [[File:Test_cloud_logo_thumb.jpg]]
| caption = [[How-To Guide]]
}}
==About==
==About==


Local Test Cloud is used to make Fedora Cloud images easier to test by automating installation on the local machine. See the [https://pagure.io/testcloud home page] for more information.
''Testcloud'' is used to make Fedora Cloud images easier to test by automating installation on the local machine. See the [https://pagure.io/testcloud home page] for more information.


==Installation==
==Installation==
'''NOTE: This guide applies to Fedora 23 and later.'''
<ol>  
<ol>  
<li>Install 'testcloud' using dnf: <pre>dnf install testcloud</pre></li>
<li>Install 'testcloud' using dnf: <pre>dnf install testcloud</pre></li>
Line 19: Line 11:
<pre>testcloud instance create <instance> -u <url_to_qcow2_image></pre>
<pre>testcloud instance create <instance> -u <url_to_qcow2_image></pre>
<ul>Note: If the image is a local file, use a file URL, for example: <pre>testcloud instance create test -u file:///home/test/image.qcow2 </pre></ul>
<ul>Note: If the image is a local file, use a file URL, for example: <pre>testcloud instance create test -u file:///home/test/image.qcow2 </pre></ul>
<li>After the download is complete, the script will provide an IP where the virtual cloud image resides. To access the cloud install, enter the following and use "passw0rd" for the password:
<li>After the download is complete, the script will provide an IP where the virtual cloud image resides. To access the cloud install, enter the following and use "passw0rd" for the password:
<pre>ssh fedora@aaa.bbb.xxx.yyy</pre></li>
<pre>ssh fedora@aaa.bbb.xxx.yyy</pre></li>
</ol>
</ol>

Revision as of 11:58, 26 November 2020

About

Testcloud is used to make Fedora Cloud images easier to test by automating installation on the local machine. See the home page for more information.

Installation

  1. Install 'testcloud' using dnf:
    dnf install testcloud
  2. Add user to 'testcloud' group:
    sudo usermod -a -G testcloud your_user_name
  3. Log out of your session and log back in again, so that the group change is in effect
  4. Run 'testcloud' using the following syntax where <instance> is what you want to name the virtual cloud and <image> is a link to the image (qcow2 format only):
    testcloud instance create <instance> -u <url_to_qcow2_image>
      Note: If the image is a local file, use a file URL, for example:
      testcloud instance create test -u file:///home/test/image.qcow2 
  5. After the download is complete, the script will provide an IP where the virtual cloud image resides. To access the cloud install, enter the following and use "passw0rd" for the password:
    ssh fedora@aaa.bbb.xxx.yyy