From Fedora Project Wiki

(Created page with "{{Infobox_group | name = Cloud/Atomic Test Day | image = 300px|link=QA/Test Days | date = 2017-06-20 | time = all day | website = [[QA/Test Days]...")
 
Line 18: Line 18:
  
 
The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...
 
The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...
* Development - [[User:Developer|Developer1]] (irc_nick1), [[User:Developer2|Developer2]] (irc_nick2)
+
* Development - [[User:dustymabe|Dustymabe]] (irc_dustymabe)
* Quality Assurance - [[User:Tester1|Tester1]] (irc_nick3), [[User:Tester2|Tester2]] (irc_nick4)
+
* Quality Assurance - [[User:Roshi|Roshi]] (irc_roshi)
  
 
== Prerequisite for Test Day ==  
 
== Prerequisite for Test Day ==  
  
List any prerequisite needs for the test event.  A fresh system, virtualized guest, a blank DVD ... a desire to break software?
+
A fresh system (for Fedora Atomic Host), [https://github.com/Rorosha/testcloud testcloud] to test qcow images locally, or access to a cloud provider like OpenStack or AWS ... a desire to break software?
  
* Usb key
+
=== Fedora Atomic Host (FAH) ===
* Usb externally connected HD IDE/SATA
 
* Empty HD IDE/SATA/SCSI
 
* Free space on HD
 
  
Here's a chunk which is commonly used for most Test Days. Replace XX with whatever Fedora release is pending:
+
FAH can be run as a traditional cloud image, or installed to bare metal. If you have a spare machine you can install FAH to, please test this '''FIXME with link to FAH installer ISO'''. Download the image, write it to a USB stick and install like any other Fedora deliverable. If you need help, please ping in IRC.
  
* An updated [https://getfedora.org/workstation/prerelease Fedora XX pre-release], or a [https://www.happyassassin.net/nightlies.html Fedora XX nightly image]
+
=== Qcow2 images ===
  
== How to test? ==
+
The Fedora Cloud base image and Atomic images are also delivered as qcow2 images. You can use [https://github.com/Rorosha/testcloud testcloud] to locally boot and test either of these images. You can run testcloud from a git checkout, or use dnf to install it:
 +
 
 +
 
 +
<code>
 +
sudo dnf install testcloud
  
High level details on how a contributor can get involved.  This can include (but not limited to):
 
  
* Areas to target with exploratory testing
+
# Once it's installed, you can run testcloud like so:
* A list of pre-defined test cases to execute
+
testcloud instance create <name of instance> -u <url to qcow image>
* How to report back results
+
</code>
  
Here's another common chunk (again, replace XX as above):
 
  
=== '''Update your machine''' ===
+
== How to test? ==
  
If you're running Fedora XX, make sure you have all the current updates for it installed, using the update manager. If you want to try Rawhide, see the instructions on the [[Releases/Rawhide|Rawhide]] page on the various ways in which you can install or update to Rawhide. Or:
+
This testday is more general, so attempt to do anything and everything with these images :) Specifically though, we'd like to take a look at the following scenarios:
  
=== '''Live image''' ===
+
* Deploy applications on top of Atomic
 +
* Upgrades and downgrades of existing Atomic Hosts (preferably with applications running)
 +
* Test different cloud-init configs
 +
* Package layering with on top of the base Atomic OSTree
  
Instead of testing with an installed system, you may download a non-destructive nightly live image for your architecture. Tips on using a live image are available at [[FedoraLiveCD]]. Live image links can be found [https://www.happyassassin.net/nightlies.html here]: please be sure to download one for the correct release.
 
  
 
=== Run the tests ===
 
=== Run the tests ===

Revision as of 13:35, 9 June 2017

Cloud/Atomic Test Day
Test-days-banner.svg

Date 2017-06-20
Time all day

Website QA/Test Days
IRC #fedora-test-day (webirc)
Mailing list test


Note.png
Can't make the date?
If you come to this page before or after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find at Bugzilla, and add your results to the results section. If this page is more than a month old when you arrive here, please check the current schedule and see if a similar but more recent Test Day is planned or has already happened.

What to test?

Today's instalment of Fedora Test Day will focus on Fedora Atomic and Cloud images

Who's available

The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...

  • Development - Dustymabe (irc_dustymabe)
  • Quality Assurance - Roshi (irc_roshi)

Prerequisite for Test Day

A fresh system (for Fedora Atomic Host), testcloud to test qcow images locally, or access to a cloud provider like OpenStack or AWS ... a desire to break software?

Fedora Atomic Host (FAH)

FAH can be run as a traditional cloud image, or installed to bare metal. If you have a spare machine you can install FAH to, please test this FIXME with link to FAH installer ISO. Download the image, write it to a USB stick and install like any other Fedora deliverable. If you need help, please ping in IRC.

Qcow2 images

The Fedora Cloud base image and Atomic images are also delivered as qcow2 images. You can use testcloud to locally boot and test either of these images. You can run testcloud from a git checkout, or use dnf to install it:


sudo dnf install testcloud


  1. Once it's installed, you can run testcloud like so:

testcloud instance create <name of instance> -u <url to qcow image>


How to test?

This testday is more general, so attempt to do anything and everything with these images :) Specifically though, we'd like to take a look at the following scenarios:

  • Deploy applications on top of Atomic
  • Upgrades and downgrades of existing Atomic Hosts (preferably with applications running)
  • Test different cloud-init configs
  • Package layering with on top of the base Atomic OSTree


Run the tests

If not using the Test Day app, provide a list of test areas or test cases that you'd like contributors to execute. For examples, see Category:Test_Cases. If using the Test Day app, link to it here, with some explanation, e.g.:

Visit the result page and click on the column title links to see the tests that need to be run: most column titles are links to a specific test case. Follow the instructions there, then enter your results by clicking the Enter result button for the test.

Reporting bugs

Include some instructions on how to report bugs, and any special instructions. Here's an example, from a Palimpsest test day:

If you have problems with any of the tests, report a bug to Bugzilla usually for the component udisks, or gnome-disk-utility for bugs in the Palimpsest graphical front end itself. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you.

Test Results

If you use the Test Days app, just explain that users should enter results there and they will be transferred to the page later. For e.g.:

Please enter your results on the result page. The results will be transferred here after the Test Day is finished.

Otherwise, construct a table or list to allow testers to post results. Each column should be a test case or configuration, and each row should consist of test results. Include some text to explain reporting. Here is a common setup:

Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one. For each test case, use the result template to enter your result, as shown in the example result line.

User Sample test 1 Sample test 2 Sample test 3 Sample test 4 References
Sample User
none
Pass pass
Warning warn
[1]
Fail fail
[2]
  1. Test pass, but also encountered RHBZ #54321
  2. RHBZ #12345