From Fedora Project Wiki

m (Kparal moved page Local Test Cloud Installation Guide to Testcloud quickstart guide: more appropriate title, less confusing)
No edit summary
Line 4: Line 4:


==Installation==
==Installation==
Follow these steps if you're going to use testcloud for the first time:
<ol>  
<ol>  
<li>Install 'testcloud' using dnf: <pre>dnf install testcloud</pre></li>
<li>Install 'testcloud' using dnf: <pre>dnf install testcloud</pre></li>
<li>Add user to 'testcloud' group: <pre>sudo usermod -a -G testcloud your_user_name</pre></li>
<li>Add user to 'testcloud' group: <pre>sudo usermod -a -G testcloud your_user_name</pre></li>
<li>Log out of your session and log back in again, so that the group change is in effect</li>
<li>Log out of your session and log back in again, so that the group change is in effect</li>
<li>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):
</ol>
<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>
==Using Testcloud==
<ol>
<li>Run 'testcloud' using the following syntax:
<pre>testcloud instance create fedora:qa-matrix</pre>
<ul>Note: You can use fedora:XX where XX could be a desired Fedora version, branched or rawhide</ul>
<ul>Note: If you want to test a specific compose, not the latest nominated compose, use the following command (and replace <url> with url to the .qcow2 you want to use, use file:///home/test/image.qcow2 for local files): <pre>testcloud instance create <url></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 07:59, 6 October 2021

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

Follow these steps if you're going to use testcloud for the first time:

  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

Using Testcloud

  1. Run 'testcloud' using the following syntax:
    testcloud instance create fedora:qa-matrix
      Note: You can use fedora:XX where XX could be a desired Fedora version, branched or rawhide
      Note: If you want to test a specific compose, not the latest nominated compose, use the following command (and replace <url> with url to the .qcow2 you want to use, use file:///home/test/image.qcow2 for local files):
      testcloud instance create <url>
  2. 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