From Fedora Project Wiki

No edit summary
No edit summary
 
(9 intermediate revisions by 5 users not shown)
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://fedoraproject.org/w/index.php?title=Changes/Local_Test_Cloud 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==
 
Follow these steps if you're going to use testcloud for the first time:
'''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>sudo dnf install testcloud</pre></li>
 
<li>Add user to 'testcloud' group: <pre>sudo usermod -a -G testcloud your_user_name</pre></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):
<li>Log out of your session and log back in again, so that the group change is in effect, or alternatively, you can do: <pre>su -i $USER</pre></li>
<pre>testcloud instance create <instance> -u <image></pre>
</ol>
<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>
<li>After finishing the testing, you can remove the instance with <pre>testcloud instance remove <instance_name></pre></li>
</ol>
</ol>

Latest revision as of 08:03, 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:
    sudo 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, or alternatively, you can do:
    su -i $USER

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
  3. After finishing the testing, you can remove the instance with
    testcloud instance remove <instance_name>